> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Fazer deploy de um repositório do GitHub na Vertra Cloud

> Crie uma aplicação a partir de um repositório público ou privado do GitHub e ative o deploy automático a cada push na branch que você escolher.

Uma aplicação da Vertra Cloud pode ser criada a partir de um repositório do GitHub, público ou
privado, e atualizada automaticamente a cada push na branch que você escolher. Criar pelo GitHub
funciona em qualquer plano; o deploy automático exige o plano **Intermediary** ou superior.

## Criar a aplicação a partir do GitHub

**1. Abra Novo Projeto**

No dashboard, clique em **Novo Projeto** e escolha **Importar do GitHub**.

**2. Informe o repositório**

Cole a URL do repositório (`https://github.com/owner/repository`) ou use **Escolher entre os
meus repositórios** para listar os repositórios da sua conta. Repositórios privados exigem
conectar sua conta do GitHub, o que instala o app da Vertra Cloud nos repositórios que você
autorizar.

**3. Escolha a branch**

A branch padrão do repositório já vem selecionada. Escolha outra branch e a árvore de arquivos
e o código importado passam a ser dela.

**4. Siga o fluxo normal**

A partir daqui o fluxo é o mesmo de enviar um `.zip`: build, ambiente, rede, revisão e
deploy. Veja [Primeiro deploy](https://docs.vertracloud.app/pt-br/how-to-host.md).

Para enviar uma nova versão depois, ative o deploy automático abaixo ou use `vertra deploy` na
[CLI](https://docs.vertracloud.app/pt-br/cli.md).

## Ativar o deploy automático

Com o deploy automático ativado, cada push na branch escolhida publica a nova versão: a plataforma
baixa o código daquele commit e faz o deploy. Sem branch escolhida, um push na `main` ou na
`master` faz o deploy.

1. Na aplicação, abra **Config → Deploy** e vá até **Deploy automático**.
2. Escolha a conta do GitHub e o repositório.
3. Escolha a branch. A branch padrão do repositório já vem selecionada. Se a lista de branches não
   puder ser carregada, o webhook segue a `main` ou a `master`.
4. Clique em **Ativar deploy automático**.

A Vertra Cloud cria o webhook no repositório para você; não é preciso configurar nada no
GitHub. A mesma seção mostra a branch atual e permite trocá-la; vincular de novo sem branch volta
para `main` ou `master`. Para desativar, use **Desativar**. O webhook também é removido
quando a aplicação é excluída.

> [!NOTE]
>
> Pushes em outras branches são ignorados. Webhooks criados antes da seleção de branch existir
> continuam seguindo `main` e `master`. Cada push conta para o
> [limite de deploys por hora](https://docs.vertracloud.app/pt-br/plans-and-limits.md#limite-de-deploys-por-hora) do plano; um push que chega depois de o
> limite ser excedido é descartado e registrado na aba **Atividades**.

## Pela API

O deploy automático também pode ser criado, consultado e removido pela
[API de deploys](https://docs.vertracloud.app/api-reference/endpoint/apps/deploys/webhookurl.md), com uma chave que tenha o
escopo `apps:write`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.