- Problema de permissões de arquivos
- Compartilhamento de volume entre history-v1 e filestore
- Problema de subdiretórios
Habilitar o Sandbox Compiles
As compilações em sandbox vêm ativadas por padrão.develop/docker-compose.yml define SANDBOXED_COMPILES=true para o clsi, e develop/dev.env contém o restante:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (e :2025.1).
O LaTeX roda nos contêineres irmãos como TEXLIVE_IMAGE_USER. No ambiente de desenvolvimento, esse usuário é tex, que também é o padrão do clsi (services/clsi/config/settings.defaults.cjs:154). A imagem de produção usa www-data quando SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), porque lá os arquivos são criados pelo usuário www-data do contêiner do Overleaf.
Corrigir permissões de arquivos
O contêiner do clsi inicia como root, entrega as pastascompiles, output e cache ao usuário node (uid 1000) e então executa o clsi como node (services/clsi/entrypoint.sh). Assim, develop/compiles no host pertence ao uid 1000, o mesmo uid de tex no ambiente de desenvolvimento (veja o comentário em develop/pandoc/Dockerfile). Com as configurações acima, o ambiente de desenvolvimento compila sem nenhuma alteração de permissão.
Se, em vez disso, você definir TEXLIVE_IMAGE_USER=root, o root (uid 0) não tem permissão para escrever nas subpastas de compiles. Nesse caso, dê ao grupo root a propriedade e permissão de escrita em compiles, com setgid definido para que as novas subpastas herdem essa propriedade:
bash
services/clsi/README.md.
Compartilhamento de volume entre history-v1 e filestore
As configurações desta seção e da próxima já estão em
develop/docker-compose.yml e develop/dev.env. Elas só importam com S3_ENABLED=false em develop/dev.rc. Com o padrão S3_ENABLED=true, o filestore e o history-v1 guardam esses arquivos em buckets do RustFS (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history também é usado pelo serviço de histórico. Dessa forma, microsserviços diferentes podem compartilhar os mesmos dados. Por isso o serviço filestore em develop monta o volume history-v1-buckets do history-v1. Sem ele, o clsi não conseguirá obter arquivos blob do serviço filestore.
develop/docker-compose.yml
dev.env:
develop/dev.env
Usar subdiretórios
O filestore sempre lê os blobs do histórico com subdiretórios (services/filestore/app/js/KeyBuilder.js:58, :70). A imagem de produção ativa useSubdirectories para o history-v1 (server-ce/config/production.json), mas a configuração padrão do history-v1 não, então em desenvolvimento o history-v1 achataria todos os dados. Por isso o dev.env define NODE_CONFIG para o history-v1:
develop/dev.env
project_blobs assim:
useSubdirectories definido como true, o _ nesses nomes vira /, então cada blob é armazenado em subpastas.
