Deploy via GitHub
O Guara Cloud se integra diretamente com o GitHub para oferecer deploys automaticos a cada push. Quando voce faz push na branch configurada, um novo deploy e iniciado automaticamente.
Instalando o GitHub App
Para conectar seus repositorios, voce precisa instalar o Guara Cloud GitHub App na sua conta ou organizacao GitHub.
-
Acesse as configuracoes de GitHub
No dashboard do Guara Cloud, va ate Configuracoes > GitHub ou clique em “Conectar GitHub” ao criar um servico.
-
Instale o Guara Cloud App
Voce sera redirecionado para o GitHub. Escolha se deseja conceder acesso a todos os repositorios ou apenas a repositorios especificos.
-
Confirme a instalacao
Apos autorizar, voce sera redirecionado de volta ao Guara Cloud. Seus repositorios estarao disponiveis para conexao.
Conectando um repositorio
Apos instalar o GitHub App, voce pode conectar um repositorio a qualquer servico:
- Acesse a pagina do servico no dashboard
- Na secao Fonte, clique em Conectar Repositorio
- Selecione o repositorio da lista
- Escolha a branch que dispara deploys automaticos (por exemplo,
main) - Para monorepos, defina o diretorio raiz do servico (por exemplo,
/apps/api)
Branch de deploy
A branch configurada e a que dispara deploys automaticos. Quando voce faz push nessa branch, o Guara Cloud:
- Detecta as mudancas via webhook
- Inicia o build da nova versao
- Faz o deploy automaticamente quando o build finaliza
Voce pode alterar a branch de deploy a qualquer momento nas configuracoes do servico.
Suporte a monorepo
Se voce usa um monorepo (varios projetos no mesmo repositorio), o Guara Cloud oferece filtragem por caminho. Isso significa que o deploy so e disparado quando arquivos dentro do diretorio configurado sao alterados.
Por exemplo, se o diretorio raiz do servico e /apps/api:
| Arquivo alterado | Dispara deploy? | Motivo |
|---|---|---|
apps/api/src/main.ts | Sim | Dentro de apps/api |
apps/api/package.json | Sim | Dentro de apps/api |
apps/web/src/page.tsx | Nao | Diretorio diferente |
README.md | Nao | Arquivo na raiz do repo |
Desconectando o GitHub
Voce pode desconectar o GitHub de um servico a qualquer momento:
- Acesse a pagina do servico
- Na secao Fonte, clique em Desconectar
- Confirme a acao
Ao desconectar, o servico continua rodando com o ultimo deploy bem-sucedido, mas deploys automaticos sao desativados. Voce pode reconectar o mesmo repositorio ou um diferente a qualquer momento.
Se voce desinstalar o Guara Cloud App diretamente pelo GitHub, todos os servicos conectados serao desconectados automaticamente.