Preparacao do repositorio GitHub

Antes de conectar o Coolify, o repositório precisa estar pronto para receber deploys sem ajustes improvisados. Esta pagina consolida o que precisa existir no GitHub para que o fluxo seja reproduzivel.

Objetivo

Garantir que o repositório tenha branch, arquivos e convenções aptos para o primeiro deploy.

O que precisa estar definido

• Branch de produção definida e protegida, se aplicável.
• Estrutura de pastas coerente com o Dockerfile.
• Variáveis de ambiente registradas fora do código-fonte.
• README ou documentação de apoio indicando como executar a aplicação.
• Permissões e acessos adequados no repositório.

Itens obrigatórios

• branch principal definida e documentada.
• Dockerfile versionado.
• .gitignore atualizado.
• variáveis sensíveis fora do código.
• caminho do build conhecido.
• permissão de leitura para o Coolify no repo.

Passos recomendados

1. Confirme a branch que sera usada em producao.
2. Valide o Dockerfile localmente.
3. Revise .gitignore e .dockerignore.
4. Mova segredos para variaveis de ambiente.
5. Garanta que o repositório tenha nome e descrição coerentes.
6. Confirme permissão de acesso ao GitHub para o Coolify.

Validação esperada

• git status limpo antes do deploy.
• branch apontando para o conteúdo correto.
• build local reproduzivel.
• nenhum segredo visivel no historico recente.

Problemas comuns

• branch errada conectada ao ambiente de producao.
• segredos commitados por engano.
• .dockerignore excluindo dependencias necessarias.
• branch publica sem revisão minima.