- ファイル権限の問題
- history-v1 と filestore 間のボリューム共有
- サブディレクトリの問題
Sandbox Compiles を有効にする
Sandbox Compiles はデフォルトで有効です。develop/docker-compose.yml が clsi に SANDBOXED_COMPILES=true を設定し、残りは develop/dev.env にあります。
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1(および :2025.1)でイメージを一度 pull してください。
LaTeX は兄弟コンテナ内で TEXLIVE_IMAGE_USER として実行されます。開発環境ではこれは tex で、clsi のデフォルトでもあります(services/clsi/config/settings.defaults.cjs:154)。本番イメージでは、SANDBOXED_COMPILES_SIBLING_CONTAINERS=true のときに代わりに www-data を使います(server-ce/config/env.sh:15-21)。本番ではファイルが Overleaf コンテナの www-data ユーザーによって作成されるためです。
ファイル権限を修正する
clsi コンテナは root として起動し、compiles、output、cache フォルダーを node ユーザー(uid 1000)に渡してから、clsi を node として実行します(services/clsi/entrypoint.sh)。そのため、ホスト上の develop/compiles は uid 1000 の所有となり、開発環境の tex と同じ uid です(develop/pandoc/Dockerfile のコメントを参照)。上記の設定なら、開発環境は権限を変更しなくてもコンパイルできます。
代わりに TEXLIVE_IMAGE_USER=root を設定した場合、root(uid 0)には compiles のサブフォルダーへの書き込み権限がありません。その場合は、compiles の所有グループを root にして書き込み権限を与え、新しいサブフォルダーがこの所有権を継承するように setgid を設定します。
bash
services/clsi/README.md を参照してください。
history-v1 と filestore 間のボリューム共有
このセクションと次のセクションの設定は、すでに
develop/docker-compose.yml と develop/dev.env に含まれています。これらが関係するのは develop/dev.rc で S3_ENABLED=false の場合だけです。デフォルトの S3_ENABLED=true では、filestore と history-v1 はこれらのファイルを代わりに RustFS のバケットに保存します(develop/s3/docker-compose.yml)。server-ce/config/settings.js
data/history は履歴サービスでも使われます。こうして異なるマイクロサービス間で同じデータを共有できます。そのため、develop の filestore サービスは history-v1 の history-v1-buckets ボリュームをマウントしています。これがないと、clsi は filestore サービスから blob ファイルを取得できません。
develop/docker-compose.yml
dev.env の次の設定でバケットを見つけます。
develop/dev.env
サブディレクトリを使用する
filestore は履歴の blob を常にサブディレクトリ付きで読み込みます(services/filestore/app/js/KeyBuilder.js:58、:70)。本番イメージは history-v1 の useSubdirectories を有効にしますが(server-ce/config/production.json)、history-v1 のデフォルト設定では有効にならないため、開発環境では history-v1 がすべてのデータをフラットにしてしまいます。そのため dev.env は history-v1 に NODE_CONFIG を設定しています。
develop/dev.env
project_blobs のファイルを次のように保存します。
useSubdirectories を true にすると、これらの名前の _ が / になり、各 blob がサブフォルダーに保存されます。
