# 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

- 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](/guia/nodejs-next/).

## 1. Conectar o GitHub ao time

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](/conta/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

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

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](/guia/monorepo/).

## 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](/operacao/logs/) e [Deploys e status](/operacao/deploys-e-status/).

## 5. Deploy automático a cada push

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

```bash
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](/guia/monorepo/)).

## 6. Voltar para uma versão anterior

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](/operacao/rollback/).

## 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](/erros/fluxo-de-diagnostico/). |
| "Há um deploy em andamento" | Espere terminar ou cancele, e tente de novo. |

## Próximos passos

- [Ligar um domínio próprio](/comecar/ligar-dominio-proprio/)
- [Variáveis no painel](/conectados/variaveis-no-painel/)
- [Primeiro deploy pela API](/comecar/primeiro-deploy/)
