Deploy por Git
Você conecta o GitHub uma vez por time, escolhe o repositório e a branch, e a Nebular constrói e publica. Com Deploy automático ligado, cada push na branch gera um novo deploy.
Antes de começar
Seção intitulada “Antes de começar”- Um papel de Administrador ou acima para conectar o GitHub (menu Integrações). Para publicar, basta Membro ou acima.
- Um repositório no GitHub (público ou privado) que a Nebular consiga construir. Veja os guias por stack.
1. Conectar o GitHub ao time
Seção intitulada “1. Conectar o GitHub ao time”- No menu, abra Integrações.
- No cartão Conexões do time, clique em Conectar GitHub.
- No GitHub, escolha a conta pessoal ou a organização e os repositórios que a Nebular pode ler.
- De volta ao painel, a conta aparece na lista (com conta pessoal ou organização). Aparece o aviso GitHub conectado ao time.
Se o painel disser que a instalação pertence a outra conta, vincule seu GitHub antes em Conta → Segurança (Contas conectadas) e instale de novo. Para repositórios de uma organização, você precisa ser membro dela.
2. Criar um projeto já ligado ao repositório
Seção intitulada “2. Criar um projeto já ligado ao repositório”- Em Projetos, clique em Novo projeto e escolha Importar do GitHub em Como criar o projeto.
- Em Conta do GitHub, escolha a instalação. Use Buscar repositório e clique no repositório desejado.
- Confira Nome do projeto, Endereço e a branch.
- Deixe ligado Deploy automático (publica sozinho a cada push nesta branch).
- Clique em Criar e publicar. O painel mostra Projeto criado! O primeiro deploy já começou.
Se o projeto for criado mas o primeiro deploy falhar ao iniciar, abra a aba Git e tente de novo.
3. Ligar um repositório a um projeto que já existe
Seção intitulada “3. Ligar um repositório a um projeto que já existe”- Abra o projeto e vá na aba Git.
- Escolha o repositório e a branch no seletor.
- Marque ou desmarque Deploy automático e clique em Salvar conexão.
- Para publicar na hora, clique em Deploy agora.
Depois de ligado, a aba mostra Publicando de repositório e branch, com o estado do deploy automático. Alterar troca repositório ou branch; Desconectar remove a ligação e o site atual continua no ar.
Num monorepo, adicione cada serviço com Pasta do serviço (opcional) em Adicionar serviço, veja Monorepo.
4. Acompanhar o deploy
Seção intitulada “4. Acompanhar o deploy”Na aba Deploys, a tabela Versões mostra cada deploy com origem (Git e a mensagem do commit), duração e status.
| Status | Significa |
|---|---|
| Na fila | Aguardando a vez de construir |
| Publicando | Em construção e subida |
| No ar | Concluído e servindo |
| Falhou | Algo deu errado; abra Ver log |
| Substituído | Uma versão mais nova assumiu |
Ver log abre o log de construção ao vivo. Detalhes em Logs e Deploys e status.
5. Deploy automático a cada push
Seção intitulada “5. Deploy automático a cada push”Com Deploy automático ligado, um git push na branch escolhida inicia um deploy sozinho:
git add .git commit -m "Ajusta a página inicial"git push origin mainQuando há mais de um serviço no mesmo repositório, só os serviços afetados pelos arquivos do push são publicados (veja watch_paths em Monorepo).
6. Voltar para uma versão anterior
Seção intitulada “6. Voltar para uma versão anterior”- Na aba Deploys do projeto, ache a versão boa na tabela Versões.
- Clique em Ativar esta versão e confirme. A Nebular serve essa versão sem refazer o build, e a atual fica guardada.
- Para reconstruir a partir de uma versão, use Redeploy.
Na tela de um site, a aba Deploys também traz Rollback nos deploys marcados como Substituído. A Nebular guarda as 10 últimas versões; mais antigas não podem ser reativadas. Veja Rollback.
Se algo der errado
Seção intitulada “Se algo der errado”| Sintoma | O que fazer |
|---|---|
| “Este time ainda não conectou o GitHub” | Peça a um administrador para conectar em Integrações. |
| O repositório não aparece na busca | Na conexão do GitHub, inclua o repositório e use Buscar repositório de novo. |
| O push não gera deploy | Veja se Deploy automático está ligado e se a branch é a que foi escolhida. |
| Deploy Falhou | Abra Ver log; confira o fluxo de diagnóstico. |
| “Há um deploy em andamento” | Espere terminar ou cancele, e tente de novo. |