Pular para conteúdo

ADR 0003 — Docker Compose em CT Debian 12

Status: Aceita · Data: 09/11/2026

Contexto

O ambiente precisa ser reproduzível: recriar o servidor do zero, ou montar um ambiente de teste, não pode depender de passos manuais nem de pacotes copiados à mão.

Decisão

  • CT LXC não privilegiado no Proxmox, com Debian 12 (versão estável e madura), nesting=1,keyctl=1.
  • Toda a stack descrita em docker-compose.yml, versionado no Git.
  • Imagem da aplicação baseada em python:3.13-slim-trixie. O sistema dentro do container é Debian 13, para ter GDAL 3.10, exigido pelo GeoDjango por segurança. Isso não depende do sistema do CT.
  • O TLS termina num proxy reverso externo (ex.: Nginx Proxy Manager); o CT expõe só a porta 80.

Alternativas consideradas

  • Instalação nativa com systemd: menos camadas, mas o ambiente não fica descrito em arquivo e é difícil de reproduzir.
  • VM em vez de CT: mais isolamento, mas mais pesada e sem necessidade aqui.

Consequências

  • Instalar ou recriar o sistema = git clone + .env + docker compose up -d --build.
  • As portas publicadas pelo Docker passam por fora do ufw do CT. Só a porta 80 é publicada.