A configuração da organização pode ser exportada como um pacote portátil e aplicada a outra organização. Encontre-o em Configurações → Dados → Exportar configurações.
Isso é útil em três situações: criar uma segunda organização que deva corresponder a uma já existente, promover uma configuração de uma área de trabalho de teste para uma real e manter um registro revisável de como uma área de trabalho está configurada.
O que é incluído
O pacote abrange a configuração no nível da organização:
| Área | Incluído |
|---|---|
| Política e qualidade | Política da organização, políticas de qualidade, portas de projeto, políticas de ciclo de vida e regras de revisão |
| Agentes e modelos | AI profiles, chaves de provedor referências |
| Automação | Gatilhos e agendamentos |
| Conexões | Integrações de controle de versão, pontes de canal e servidores MCP |
| Acesso | Configuração de identidade corporativa e contas de serviço |
| Dados | Configurações de retenção, configuração de armazenamento e destinos de auditoria |
O que não é incluído
Os segredos nunca são transferidos. Chaves de provedor, tokens e credenciais são exportadas como espaços reservados. O pacote registra que uma chave existe e quem a utiliza, nunca seu valor — você deve inserir os segredos novamente após a importação.
Também são excluídos: tudo que corresponde à identidade da área de trabalho em vez de à configuração — o nome da organização, seus membros e sua relação de cobrança — além do histórico operacional, como tarefas, execuções e eventos de auditoria.
A regra é que um pacote descreve como uma área de trabalho está configurada, não o que aconteceu nela.
Visualize antes de aplicar
A aplicação de um pacote executa primeiro uma visualização, mostrando o que cada seção faria:
| Status | Significado |
|---|---|
applied | A configuração será criada ou atualizada |
unchanged | Já corresponde; nada a fazer |
needsRebind | Depende de algo que precise ser redefinido localmente |
failed | Não pode ser aplicado; o motivo é indicado |
Leia a visualização com atenção. needsRebind é o mais importante — ele sinaliza configurações que referenciam algo que não existe de forma idêntica no destino, geralmente uma conexão de repositório ou um segredo. Esses itens precisam de atenção antes que a configuração seja efetivamente equivalente.
Mantendo pacotes no controle de versão
Um pacote exportado é um arquivo, portanto pode ficar em um repositório, ser comparado e revisado. Para equipes que tratam a configuração como código, esse é o valor: uma alteração na política da organização vira um diff revisável em vez de um clique feito por alguém.
Como os segredos são espaços reservados, é seguro commitar um pacote — mas verifique se há algo que identifique sua própria configuração antes de torná-lo público.