Producao
O ambiente de producao usa Podman, Caddy, Cloudflare e containers independentes para servicos auxiliares.
Ordem de publicacao
- Execute a suite automatizada e valide o Compose.
- Gere backup de templates e backup logico do MariaDB.
- Confirme issuer, client ID, callback e roles no Mix Identity.
- Aplique as migrations, incluindo
008_oidc_issuer_subject_identity.sqle009_oidc_session_revalidation.sql. - Recrie os servicos com a imagem aprovada.
- Valide
/health,/readye o redirecionamento de/auth/login. - Confirme PKCE S256, callback exato, cookie seguro e revogacao em ate cinco minutos.
- Em falha, interrompa a promocao e use o rollback; nunca remova os volumes.
Dominios
Servicos
O Gera Base roda via podman compose e possui servico systemd de usuario:
Endpoints uteis para monitoramento:
A API Litestar paralela pode ser testada com o profile migration na porta 8050.
Staging
Use um ambiente de homologacao separado para testar releases antes da producao. Recomenda-se:
- projeto/compose separado, por exemplo
gera-base-staging; - volumes MariaDB e backups proprios;
.envproprio, sem reaproveitar senhas de producao;- subdominios dedicados, como
staging-gera-base.seudominio; - Cloudflare/Caddy apontando para portas ou containers de staging;
- tokens de API separados para n8n e agentes.
Nao use o banco MariaDB de producao em staging.
Subida local de staging:
Deploy e Rollback
Use os scripts de producao na VPS:
O deploy cria backup de templates e backup logico MariaDB antes de atualizar containers. O rollback tambem cria backup antes de voltar o codigo.
Antes do primeiro deploy, crie o arquivo .env a partir de .env.example e preencha as senhas reais no servidor. O .env nao deve ser versionado.
O Portainer e o Hibrido Home Office ficam independentes:
O usuario admin precisa manter linger ativo:
Resultado esperado: