Pular para o conteúdo

Ambientes

A função Ambientes oferece branching semelhante ao Git para todo o backend. Cada ambiente é uma cópia totalmente isolada da sua aplicação — incluindo base de dados, schema API, roles, provedores de arquivos, rotas gateway e configuração de segurança — permitindo desenvolver, testar e preparar alterações sem afetar dados de produção.

Cada projeto começa com um único ambiente master. A partir daí pode ramificar novos ambientes que herdam o schema da base de dados (e opcionalmente dados) de qualquer ambiente existente. Cada ramo opera independentemente: alterações num ambiente não se propagam a outros até merge explícita.


  • Isolamento de ambientes: Cada ambiente tem a sua própria base PostgreSQL para separação completa de dados.
  • Modos de ramo: Full (schema + dados) ou System (apenas schema).
  • Cópia de configuração: Provedores de armazenamento, rotas gateway, definições de segurança e variáveis de ambiente podem ser copiados opcionalmente.
  • Ciclo de vida de estados: active, branching, merging, error, archived.
  • Relações parent-child: Estrutura em árvore para operações diff e merge.
  • Schema Diff: Compara schemas de dois ambientes. Ver Environment Diff.
  • Merge: Aplica alterações de schema com backup automático. Ver Environment Merge.
  • Backups: Backups automáticos pre-merge e manuais em S3. Ver Backups.
  • Histórico de migrações: Rasto de auditoria completo de todas as operações de merge.

Todos os recursos backend estão limitados ao ambiente selecionado. Ao mudar via o Seletor de ambiente:

RecursoPor ambiente
Tabelas e schema DBSim
API Explorer (GraphQL)Sim
SQL PlaygroundSim
Acesso baseado em rolesSim
Provedores de armazenamentoSim
Provedores de autenticaçãoSim
API KeysSim
Rotas API Gateway personalizadasSim
Config segurança (CORS, limites)Sim
Variáveis de ambienteSim
IntegraçõesSim

Nota: A mudança de ambiente aciona um reload completo do contexto.


  1. Isolamento de armazenamento: Cada ambiente tem uma base dedicada.
  2. Âmbito de configuração: Todas as definições são geridas independentemente por ambiente.
  3. Contexto da plataforma: O ambiente atual é propagado em toda a plataforma.