# Como fazer deploy a partir do GitHub

> Em Deploy IA › Integrações, clique em conectar GitHub e autorize o app. Depois, em Adicionar projeto › Importar do GitHub, escolha o repositório, confira as configurações de build e clique em Publicar projeto.

> **Atenção: este tutorial mexe na segurança da sua conta.** As mudanças descritas aqui são feitas por sua conta e risco. Confira cada passo antes de aplicar.

Para publicar direto de um repositório, conecte o GitHub em **Deploy IA › Integrações › conectar GitHub** e depois crie o projeto em **Adicionar projeto › Importar do GitHub**. A StayCloud clona o repositório, faz o build e publica.

## Antes de começar
- Você precisa de acesso ao painel em `dash.staycloud.com` e de uma conta no GitHub com o repositório do projeto.
- A conexão usa o app **staybuilder-cloud** do GitHub, que permite importar repositórios privados e públicos.

## Conectar o GitHub
1. No menu da esquerda, clique em **Deploy IA**.
   Resultado: abre a página **Projetos**, com o menu do Deploy.

![Menu da esquerda com o item Deploy IA destacado](/imagens/0e88ce6e176b5c07d9fe72da3cce14c58ee84261f2a8ed2851fd6c53429284c2.webp)

2. No menu do Deploy, em **Ferramentas**, clique em **Integrações**.
   Resultado: abre a tela **Integrações**, com os quadros **GitHub App** e **Cloud Agent · CLI**.

![Menu do Deploy com o item Integrações destacado, em Ferramentas](/imagens/331c558e0d5c012bd094cf7cba4905e02eaff1da2dd54fe9113c595158f25cdf.webp)

3. No quadro **GitHub App**, que mostra **não conectado**, clique em **conectar GitHub**.
   Resultado: o GitHub abre e pede que você autorize o app.

![Tela Integrações com o quadro GitHub App não conectado e o botão conectar GitHub](/imagens/1d971eb2519a492588e8f30a36e3e74bcc027ac2b0f72a713b55634ac871cd40.webp)

4. No GitHub, escolha os repositórios que o app pode acessar e confirme.
   Resultado: você volta ao painel, e o quadro **GitHub App** passa a mostrar a conta conectada.

## Importar o repositório
1. No menu do Deploy, clique em **Adicionar** (ou em **Projetos › Adicionar projeto**).
   Resultado: abre a tela **Criar projeto**.
2. Clique em **Importar do GitHub**.
   Resultado: abre a etapa **Selecione um repositório**. A StayCloud clona e constrói a partir da branch padrão; você ajusta tudo no passo seguinte.

![Tela Criar projeto com os métodos Importar do GitHub, Upload de .zip e Deploy via CLI](/imagens/166bff652cb8f2fd42f28d52e1288b25da9c914f8aa32a96650822180d9f710f.webp)

![Etapa Selecione um repositório, com o quadro Conecte sua conta do GitHub e o link gerenciar integração](/imagens/b9b9462239dc58bd4b1173b5e8f8ceb1f5685ed7225cf21af2b1907cbeb50a21.webp)

3. Escolha o repositório na lista e clique em **Próximo**.
   Resultado: abre a etapa **Configure o projeto**.
4. Confira **Nome do projeto**, **Branch**, **Preset de build** (detectado pelo `package.json` e pelos arquivos do repositório) e **Diretório de saída** (automático quando vazio). Em **Configurações avançadas**, adicione as variáveis de ambiente, se o projeto precisar.
5. Clique em **Publicar projeto**.
   Resultado: a análise do framework roda no servidor durante o primeiro deploy, e o projeto vai ao ar ao fim do build.

## Como saber se deu certo
O projeto aparece em **Projetos** com a etiqueta **no ar**, e a aba **Deploys** do projeto mostra a publicação como **pronto**.

## Se algo der errado
### O repositório não aparece na lista
Causa: o app do GitHub não recebeu acesso a esse repositório. Solução: em **Integrações**, clique em **gerenciar integração** e libere o repositório no GitHub.

## Relacionados
- Como fazer o primeiro deploy na StayCloud
- Como configurar variáveis de ambiente do projeto no Deploy
- Como acompanhar os deployments e ler os logs no Deploy

---
Fonte: https://help.staycloud.com/artigos/como-fazer-deploy-a-partir-do-github