Pular para o conteúdo

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.

  • 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. No menu, abra Integrações.
  2. No cartão Conexões do time, clique em Conectar GitHub.
  3. No GitHub, escolha a conta pessoal ou a organização e os repositórios que a Nebular pode ler.
  4. 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.

  1. Em Projetos, clique em Novo projeto e escolha Importar do GitHub em Como criar o projeto.
  2. Em Conta do GitHub, escolha a instalação. Use Buscar repositório e clique no repositório desejado.
  3. Confira Nome do projeto, Endereço e a branch.
  4. Deixe ligado Deploy automático (publica sozinho a cada push nesta branch).
  5. 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”
  1. Abra o projeto e vá na aba Git.
  2. Escolha o repositório e a branch no seletor.
  3. Marque ou desmarque Deploy automático e clique em Salvar conexão.
  4. 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.

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.

Com Deploy automático ligado, um git push na branch escolhida inicia um deploy sozinho:

Janela do terminal
git add .
git commit -m "Ajusta a página inicial"
git push origin main

Quando 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).

  1. Na aba Deploys do projeto, ache a versão boa na tabela Versões.
  2. Clique em Ativar esta versão e confirme. A Nebular serve essa versão sem refazer o build, e a atual fica guardada.
  3. 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.

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.