Fazer deploy ↗
docs

GitHub

Auto-deploy a cada push, status checks no PR, deploys de preview branches — via Veloz GitHub App.

A Veloz se conecta ao GitHub via um GitHub App. Depois de autorizado, todo git push na branch configurada dispara um deploy automaticamente.

Configurar pelo dashboard

Quando você importa um projeto pelo dashboard (Novo projeto → Importar do GitHub), a integração já é configurada para você. Pula o resto desta página.

Configurar pela CLI

Se o seu projeto ainda não tem GitHub conectado:

veloz github setup

A CLI abre o navegador para você autorizar o Veloz GitHub App no repositório (você escolhe entre Todos os repositórios ou Selecionados).

Para verificar o status:

veloz github status

Mostra se o projeto tem GitHub conectado, qual repositório/branch está vinculado e se o webhook está saudável.

O que acontece em cada push

  1. GitHub envia um webhook para a Veloz
  2. A Veloz inicia um build com o commit do push
  3. Você acompanha o build no dashboard ou via veloz builds list
  4. Se passar, o serviço é trocado pelo novo build (rollout sem downtime)
  5. Se falhar, o serviço atual continua no ar e o status check no PR fica vermelho

Status checks no PR

Cada push em um pull request vira um status check. Você vê ✅ ou ❌ direto no GitHub, com um link para os logs do build.

Você pode bloquear merge quando o build falha — configure no GitHub em Settings → Branches → Branch protection rules → Require status checks.

Mudar a branch de deploy

Por padrão, deploys acontecem na branch main. Para mudar:

veloz config set --branch develop

Ou no dashboard, em Configurações → Build → Branch.

Auto-deploy só de tags

Se você prefere fazer deploy apenas quando taggear (style "release-on-tag"), ajuste a branch para o pattern de tag e use o GitHub Actions com a CLI da Veloz para disparar manualmente. Veja CI/CD.

Desconectar o GitHub

No dashboard, em Configurações → Integrações → GitHub → Desconectar. Os serviços continuam no ar — só não vão receber deploys automáticos.

Para revogar completamente o acesso ao app, vá em GitHub → Settings → Applications → Authorized GitHub Apps → Veloz → Revoke.

Próximos passos