Implantação via GitHub
Use Repositório GitHub como origem do projeto quando quiser publicar a aplicação a partir do código-fonte e do fluxo de build configurado na criação.
Pré-requisito
Antes de selecionar um repositório, faça estas duas etapas obrigatórias:
- conecte sua conta GitHub à Zenifra
- instale o GitHub App
Zenifra
Guia detalhado:
Nota: O GitHub App pode ser instalado em conta pessoal ou organização. Em organizações, a instalação pode depender de aprovação administrativa.
Passos
- No console, clique em Criar Projeto.
- Em Origem de Projeto, escolha Repositório GitHub.
- Selecione o repositório, a branch, o runtime e os comandos necessários.
- Escolha se deseja habilitar
auto-deploy. - Clique em Criar Projeto.
Comandos do projeto
Em projetos GitHub, a Zenifra executa a instalação padrão do runtime e depois roda apenas os comandos configurados no projeto.
pre-buildé opcionalbuildé opcionalstarté obrigatório
Isso significa que alguns projetos precisam apenas de start, enquanto outros também usam pre-build e build.
Auto-deploy
Quando auto-deploy estiver habilitado na criação do projeto, cada push na branch selecionada dispara uma nova atualização automaticamente.
Quando auto-deploy estiver desabilitado, o projeto não será atualizado automaticamente por push.
O que fica fixo depois da criação
Em projetos com origem GitHub, estes campos ficam definidos na criação e não ficam disponíveis para edição depois:
- origem do projeto
- branch
- runtime
- versão do runtime
auto-deploy
Depois da criação, os ajustes confirmados para projetos GitHub se concentram nos comandos pre-build, build e start.
Logs de Build
Depois que o projeto é criado, acompanhe cada publicação pela aba Logs de Build dentro da página do projeto no console.
Esse histórico mostra:
- lista de builds recentes
- status de cada build
- saída detalhada de instalação de dependências
- saída de
pre-build, quando existir - saída de
build, quando existir
Os logs públicos de build são filtrados para priorizar a saída útil do projeto. Detalhes internos de Docker e BuildKit não aparecem nessa visualização.
O modal de logs atualiza em tempo real enquanto a build está em execução.
Retenção do histórico
O histórico de builds GitHub é retido por até:
- 30 builds por projeto
- 30 dias de idade
O que vencer primeiro define a remoção dos registros mais antigos.
URL
Todos os planos recebem uma URL da Zenifra em *.clients.zenifra.com. Em planos mais altos, o nome desse subdomínio pode ser personalizável.