# Ambientes de preview de pull request

Um preview de pull request leva as próprias variáveis, um banco que não é produção, e some quando o pull request fecha.

Canonical URL: https://unbroker.cloud/pt/blog/pull-request-preview-environments
Published: 2026-10-31
Reviewed: 2026-10-31
Author: Unbroker

## A resposta curta

Dê a cada pull request o próprio preview, com variáveis que não são segredos de produção, um banco que não é o de produção, e uma limpeza quando o pull request fecha.

A falha comum não é um preview que não sobe. É um preview que funciona porque está falando com a produção. As três perguntas abaixo são como evitar isso. Como ligar a função num app Next.js está em [deploy de Next.js com previews de pull request](https://unbroker.cloud/deploy/nextjs). Se você está saindo do Railway, a [alternativa ao Railway](https://unbroker.cloud/pt/alternativas/railway) é a comparação, e as previews na Unbroker exigem Pro.

## O que é um ambiente de preview

Um ambiente de preview roda o código de um pull request para alguém abrir antes do merge. Staging é um ambiente compartilhado para o release que você está prestes a publicar. Um preview é descartável e pertence àquele pull request.

### Um preview por pull request e um staging compartilhado

Um único ambiente de staging é fácil de manter, e todos os pull requests abertos compartilham os dados e as variáveis. Um preview por pull request deixa duas mudanças separadas, e cada um precisa ser limpo. Na Unbroker, um projeto tem ambientes de production, custom e preview. Nomes como staging, qa e dev aparecem como ambientes próprios. Desde 14 de outubro de 2026, previews de pull request são ambientes de preview do projeto, não projetos separados.

### Outros nomes

A Heroku chama a mesma ideia de review apps: um app descartável que roda o código de um pull request do GitHub e tem uma URL para compartilhar. Outros hosts dizem preview deployments ou ephemeral environments. Esses nomes não são uma comparação de preço. Este texto não repete a tarifa de ninguém.

## 1. Variáveis: o que um preview deve receber e o que não deve

Um preview deve receber API keys de teste, URLs de webhook de sandbox e um banco que dá para apagar. Não deve receber senhas de produção.

Na Unbroker, uma variável de serviço ou de projeto é All, Production ou Preview. Um valor com escopo de ambiente substitui All para a mesma chave. Variáveis que já existiam ficam em All até você mudá-las. Um preview novo copia All e Preview, e nunca copia valores que são só de Production. Um preview que já existe fica com a cópia que tem. Mudar o rótulo para Production não tira um segredo de um preview que já o recebeu. Remova lá, ou recrie o preview, e rode a credencial se ela pode ter vazado. Variáveis de serviço, as compartilhadas do projeto, os prefixos públicos do build e a rotação estão em [variáveis de ambiente e segredos](https://unbroker.cloud/pt/blog/environment-variables-and-secrets).

O GitHub Actions, exceto `GITHUB_TOKEN`, não passa segredos para um workflow disparado por um fork. A Unbroker não cria previews automáticos de pull request para branches de fora do repositório conectado, porque esse código poderia ler os segredos do preview. Um fork dá para revisar por outro caminho. Não resolva isso colocando segredos de produção em All.

<aside class="plan-box">
<p><strong>Na Unbroker.</strong> Deixe as credenciais de produção em Production. Aponte os previews para um banco de staging ou uma API key de teste com Preview. Previews de pull request exigem Pro. As regras estão na <a href="https://docs.unbroker.cloud/deployments/environment-variables">documentação de variáveis</a>.</p>
</aside>

## 2. Bancos: com o que o preview fala

O preview roda o connection string que você deu. O tráfego privado dentro da Unbroker fica na mesma organização e no mesmo ambiente, então um preview não alcança os pods de produção por esse caminho. Uma URL que você cola numa variável não é essa rede privada. Se a string é a de produção, o preview está em cima de dados de produção.

### Um banco de staging compartilhado

Todos os previews falam com um banco que você aceita quebrar. A configuração é uma variável. Uma migração em qualquer pull request muda esse schema para todos. Os dados de seed se misturam assim que dois branches escrevem.

### Um banco novo por pull request

Cada pull request recebe um banco vazio e um seed. Mudanças de schema ficam naquele pull request. Você precisa criar o banco, carregar o seed e apagá-lo com o pull request. A documentação da Unbroker não diz que o produto cria esse banco para você. A home desenha um banco novo num pull request. Esse desenho não é um comportamento documentado, então este texto não afirma isso.

### Migrações

Rode uma migração só contra o banco que esse preview pode alterar. Apontada para o banco de staging compartilhado, ela muda o staging para todo mundo. Apontada para produção, muda a produção. [Postgres em produção](https://unbroker.cloud/pt/blog/postgres-in-production) é onde o restore e o rollback de dados se separam de um rollback de código. Rodar essa migração uma vez, antes de o release ir ao ar, está em [migrações de banco de dados no deploy](https://unbroker.cloud/pt/blog/database-migrations-on-deploy).

<aside class="plan-box">
<p><strong>Na Unbroker.</strong> Escolha o banco com uma variável de escopo Preview. Não coloque o connection string de produção em All. O produto não documenta um banco criado por pull request.</p>
</aside>

## 3. Ciclo de vida: builds, limpeza e o que sobra

Abrir ou atualizar um pull request cria ou atualiza o preview quando o serviço está com previews ligados. Fechar o pull request desmonta o stack. O merge também o remove. Um preview interrompido no meio é retomado. Uma tarefa de limpeza também apaga previews vencidos. Atividade num preview renova um vencimento de sete dias.

Deploys manuais, deploy hooks e previews de pull request ignoram watch paths. Um preview mesmo assim é construído quando o pull request atualiza, mesmo que a mudança esteja fora dos caminhos que pulariam um push no branch de produção. Qual branch esse push publica, e quando ele espera os checks do GitHub, está em [Deploy com git push](https://unbroker.cloud/pt/blog/deploy-on-git-push). Previews herdam a proteção de acesso do serviço e o ajuste de Wait for CI. Eles só rodam código de branches do repositório conectado.

A Unbroker não publica um preço separado para um preview. Previews exigem Pro. Este texto não inventa uma cobrança por hora nem por pull request.

O tráfego de um projeto pode ser filtrado para production ou para preview. Essa vista pede um plano pago e uma célula que colete tráfego.

<aside class="plan-box">
<p><strong>Na Unbroker.</strong> Previews são ambientes de preview do projeto. Feche ou faça merge do pull request e o preview é removido. A nota de Git está em <a href="https://docs.unbroker.cloud/deployments/git">Deploy from Git</a>, e o changelog de 14 de outubro é o que moveu os previews para o projeto.</p>
</aside>

## Previews e agentes de código

Um agente pode abrir um pull request que parece pronto e mesmo assim aponta para o banco errado. Revise esse pull request num preview que não consegue ler a produção. Depois faça o merge.

Como dar um token ao agente, e o que esse token não deve ver, está em [deixar um agente fazer deploy com cuidado](https://unbroker.cloud/pt/blog/coding-agent-deploy-safely). O checklist de produção do app está em [fazer deploy de um app feito com Cursor](https://unbroker.cloud/pt/deploy/cursor). Nenhuma das duas páginas se repete aqui.

## Lista de um ambiente de preview

Faça isto antes do primeiro pull request de alguém que não seja você. Cada linha é uma checagem.

1. Ligue previews de pull request só num plano que os inclua.
2. Coloque segredos de produção em Production, não em All.
3. Dê ao preview API keys de teste e webhooks de sandbox.
4. Aponte o preview para um banco que você possa apagar.
5. Não cole o connection string de produção numa variável Preview.
6. Decida se os previews compartilham um banco de staging ou se você cria um banco por pull request.
7. Rode migrações só contra esse banco escolhido.
8. Feche um pull request de teste e confirme que o preview sumiu.
9. Rotacione qualquer segredo que um preview antigo já tenha copiado.
10. Revise o pull request de um agente nesse preview antes do merge.

## Como fica na Unbroker

Previews de pull request exigem Pro. As variáveis são All, Production ou Preview, e um preview novo copia só All e Preview. Previews são ambientes do projeto, não projetos separados. Fechar ou fazer merge do pull request remove o preview. Um preview interrompido no meio é retomado. O que o Pro inclui está em [preços](https://unbroker.cloud/pt/precos). O mapa de deploys é a [visão geral de deployments](https://docs.unbroker.cloud/deployments/overview). O tutorial de Git é [Deploy from Git](https://docs.unbroker.cloud/guides/deploy-from-git).

## Perguntas frequentes

### O que é um ambiente de preview de pull request?

É uma cópia no ar do branch do pull request, separada da produção, para abrir essa mudança antes do merge. Na Unbroker, abrir ou atualizar um pull request do GitHub cria ou atualiza esse preview quando o serviço está com previews ligados. Fechar ou fazer merge do pull request remove o preview.

### Qual é a diferença entre um ambiente de staging e um preview?

Staging é um lugar compartilhado para o próximo release. Um preview está preso a um pull request e vai embora com ele. Na Unbroker, staging é um ambiente nomeado do projeto. Previews de pull request são ambientes de preview desse mesmo projeto, não projetos separados.

### Um preview deve usar as variáveis de produção?

Não. Um preview que consegue ler segredos de produção também pode ser lido por quem abre o pull request. Na Unbroker, um preview novo copia All e Preview e não recebe valores que são só de Production. Coloque a credencial do banco de produção em Production, não em All, a menos que você queira que os previews a vejam.

### Que banco um ambiente de preview deve usar?

Não o de produção. Um banco de staging compartilhado é simples e uma migração de um pull request pode quebrá-lo para os outros. Um banco novo por pull request, com dados de seed, fica isolado e você precisa criá-lo. A documentação da Unbroker não diz que cada preview recebe o próprio banco. Você escolhe o banco com uma variável de escopo Preview.

### Como rodo migrações num ambiente de preview?

Rode só contra o banco que esse preview pode alterar. Uma migração apontada para um banco de staging compartilhado muda esse schema para todos os outros previews. Uma migração apontada para produção muda a produção. A documentação não descreve um banco automático por pull request.

### O que acontece com o preview quando o pull request é fechado?

Na Unbroker, fechar o pull request desmonta o stack desse preview, e o merge também o remove. Um preview interrompido no meio é retomado. Atividade no preview renova um vencimento de sete dias, e uma tarefa de limpeza apaga previews vencidos.

### Ambientes de preview custam enquanto rodam?

A Unbroker não publica um preço separado para um preview. Previews de pull request do GitHub exigem Pro. Este texto não inventa uma cobrança por preview.

### Como reviso o pull request de um agente de código antes do merge?

Abra o pull request do agente num preview sem credenciais de produção e sem o banco de produção. Leia a mudança e depois faça o merge. Como dar um token ao agente está no post do agente, e não se repete aqui.

## Related reading

- [Deploy de Next.js com previews de pull request](https://unbroker.cloud/deploy/nextjs)
- [O que o Pro inclui](https://unbroker.cloud/pt/precos)
- [Checklist de produção para apps feitos com IA](https://unbroker.cloud/pt/deploy/cursor)
- [Deixar um agente fazer deploy com cuidado](https://unbroker.cloud/pt/blog/coding-agent-deploy-safely)
- [Postgres em produção](https://unbroker.cloud/pt/blog/postgres-in-production)
