Contexto
Documentação KOLOS

Contexto

O deploy via Nixpacks no Dokploy estava usando PHP 8.3 e Node 18, incompatíveis com este projeto (requer php ^8.5.1 e Vite exige Node >= 20.19). Isso tende a gerar erros 500 em runtime e builds instáveis.

Decisão

Padronizar o deploy recomendado no Dokploy usando Dockerfile na raiz do repositório, garantindo:

  • PHP 8.5 (via PPA ondrej no Ubuntu 24.04)
  • Node 24 para build do Vite
  • Nginx + PHP-FPM (ao invés de php artisan serve)

Passos

No Dokploy:

  • Build Type: Dockerfile
  • Dockerfile Path: Dockerfile
  • Exposed Port: 80
  • Configurar credenciais Flux no build: secret composer_auth, build-arg COMPOSER_AUTH_JSON, ou USERNAME+KEY (ver Dockerfile e runbook Dokploy atual).
  • Definir APP_KEY e demais variáveis de produção.

Validação

  • Acessar https://docta.cloud e confirmar HTTP 200.
  • Verificar logs do container (nginx/php-fpm) sem erros fatais.

Impacto

  • Adicionado Dockerfile de produção e configs em docker/prod/.
  • Adicionado .dockerignore para build mais rápido e limpo.
  • Atualizados runbooks para orientar o deploy.