Com os ambientes de PR ligados, cada pull request aberto no repositório ganha um ambiente temporário, chamado <projeto>-pr-<número>. Ele é uma cópia do ambiente base, com os serviços apontando para a branch do PR. Cada push no PR faz um novo deploy, e a Veloz comenta no PR com o status e o endereço de cada serviço.
Quando o PR é mesclado ou fechado, o ambiente é removido com tudo que ele criou: serviços, bancos, volumes e endereços.
Planos: os ambientes de PR estão disponíveis a partir do plano Pro.
Ligar os ambientes de PR
Abra Configurações do projeto → Ambientes de PR. O projeto precisa ter um repositório do GitHub conectado (veja GitHub).
| Opção | O que faz |
|---|---|
| Criar um ambiente para cada pull request | Liga os ambientes de PR. |
| Só os serviços afetados pelo PR | Faz deploy apenas dos serviços cujos arquivos o PR altera e dos serviços que eles referenciam. Os outros ficam no ambiente sem deploy. |
| PRs de bots | Também cria ambientes para PRs abertos por bots, como Dependabot e Renovate. |
| Ambiente base | O ambiente que cada PR copia. Por padrão, production. |
| Dados dos bancos | Bancos vazios, ou Cópia dos dados do ambiente base. |
Dados dos bancos
A cópia dos dados vale para bancos PostgreSQL no tier compartilhado com até 5 GB. Ela começa assim que o banco do ambiente fica pronto, e os serviços que referenciam o banco esperam a cópia terminar antes do deploy. Os outros bancos começam vazios, e um banco também começa vazio se a cópia falhar.
Para copiar só parte dos dados, ou criar dados de teste, use um seed.
O comentário no PR
A Veloz comenta no PR quando o ambiente é criado e atualiza o comentário a cada deploy. Ele mostra cada serviço com o status e o endereço, indica os serviços desligados no ambiente e, se o projeto tem um seed, mostra o status dele.
PRs de forks
Por segurança, a Veloz não cria ambientes para PRs vindos de forks, nem para PRs de quem não é membro da organização. Um fork poderia ler as variáveis do ambiente base.
Próximos passos
- Serviços por ambiente: deixar serviços de fora dos ambientes de PR
- Seed dos novos ambientes: preparar os dados de cada PR
- GitHub: conectar o repositório