Coolify

Coolify é a plataforma de orquestração e deploy da AEX. É onde as aplicações rodam antes de qualquer migração para cloud complexa.

Documentação oficial: coolify.io/docs. Aqui está apenas como usamos na AEX. O processo de deploy é normativo em DEPLOY_STANDARD.

---

Papel na AEX

• Hospedar e publicar as aplicações a partir de containers Docker.
• Receber o deploy automático disparado pelo pipeline no merge em main.
• Gerenciar variáveis de ambiente por aplicação, fora do repositório.

---

Como usamos

• Cada projeto tem sua aplicação no Coolify, buildada a partir do Dockerfile (em docker/).
• O deploy é acionado pelo pipeline (GitHub → CI/CD → Docker → Coolify), sem passos manuais.
• As variáveis de ambiente são configuradas no Coolify, seguindo o docs/ENVIRONMENT.md do projeto.
• Logs e status da aplicação são acompanhados pelo painel do Coolify.

---

Boas práticas

• MVP primeiro: use a stack Coolify + Docker; só migre para cloud quando a demanda justificar.
• Documente a configuração do projeto no docs/DEPLOY.md.
• Mantenha o rollback documentado e testado.

---

Evite

• Configurar segredos fora do Coolify ou commitá-los no repositório.
• Deploy manual que burle o pipeline — humanos aprovam, máquinas publicam.