Skip to main content
A configuração do ambiente Enterprise se aplica à infraestrutura de que todas as equipes da sua organização precisam: conexões VPN, certificados de CA, configuração de proxy e substituições de DNS. Esta página aborda conceitos específicos do Enterprise. Para a configuração geral do ambiente, consulte o guia de Configuração do ambiente.

​
O que pertence ao nível Enterprise

Navegue até Configurações do Enterprise > Ambiente (ou clique em “configuração em nível Enterprise” na página Configurações de Ambiente de qualquer org). O formato YAML é idêntico à configuração em nível de org e repo — as mesmas seções initialize, maintenance e knowledge se aplicam.
Caso de usoEnterprisenível da organizaçãoNível do repo
Acesso à VPN / rede✓
Certificados de CA✓
Configuração de proxy✓
Substituições de DNS✓
Assinatura GPG de commit✓
Runtimes de linguagem compartilhados✓
Ferramentas de CLI em nível da organização✓
Autenticação em registro privado✓
Dependências do repo✓
Testes/lint específicos do repo✓
As alterações no Enterprise têm alto impacto. Salvar aciona builds para todas as organizações. Teste primeiro os comandos de infraestrutura em uma única org (usando a configuração em nível da organização) antes de aplicá-los no nível Enterprise.
A configuração no nível Enterprise não pode clonar repositórios — a clonagem de repositórios exige acesso em nível de org. Use a configuração do Enterprise apenas para infraestrutura compartilhada (VPN, certificados, ferramentas). A clonagem de repo é gerenciada automaticamente no nível da organização.
Para exemplos de VPN, certificado de CA, proxy e registro privado, consulte Exemplos de Enterprise na página Exemplos de configuração.

​
Permissões do Enterprise

AçãoFunção necessária
Visualizar/editar a configuração do EnterpriseEnterprise Admin
Visualizar/editar a configuração da orgOrg Admin ou Enterprise Admin
Visualizar a configuração do repoQualquer membro da org
Editar a configuração do repoMembro com permissão ManageOrgSnapshots

​
Cascata de builds

Quando você altera a configuração do Enterprise:
  1. Uma nova build é acionada para cada organização
  2. A build de cada org inclui: configuração do Enterprise → configuração da org → todas as configurações dos repositórios
  3. As builds são executadas de forma independente por org — a falha de uma org não afeta as demais
  4. Cada org recebe sua própria imagem da máquina
A ordem é importante para as etapas initialize do Enterprise. A VPN deve vir primeiro (para que os hosts internos fiquem acessíveis), depois o DNS (para que os nomes sejam resolvidos), depois os certificados (para que o HTTPS funcione), depois o proxy (para que o tráfego seja roteado corretamente) e, por fim, quaisquer ferramentas que façam download de origens internas.

​
Gerenciamento de múltiplas organizações

Ordem de configuração recomendada:
  1. Configuração do Enterprise primeiro — configure a infraestrutura compartilhada (VPN, certificados, proxy)
  2. Configuração em nível da organização em seguida — cada administrador da org configura as ferramentas compartilhadas e o acesso ao registro
  3. Configuração específica do repo por último — as equipes configuram seus repositórios individuais
Cada org recebe sua própria imagem da máquina. A configuração do Enterprise é compartilhada e aditiva, mas as configurações em nível da org e do repo têm escopo próprio — a configuração da Org A não afeta a Org B, e falhas de build em uma org não afetam as demais. Para saber mais sobre a estrutura das orgs, consulte Entendendo as organizações. A hierarquia de configuração (Enterprise → Org → Repo) é estritamente aditiva. Os comandos de cada nível são executados em sequência, após a conclusão do nível anterior. Os níveis inferiores não podem sobrescrever nem modificar o que os níveis superiores configuram.

​
Migração no Enterprise

Para empresas Enterprise que estão migrando da configuração interativa legacy para a configuração declarativa:
  1. Configure primeiro o YAML no nível Enterprise — infraestrutura compartilhada, como VPN, certificados e configurações de proxy.
  2. Migre uma org por vez. Cada org tem seu próprio botão de alternância “Use legacy machine snapshot”, para que a migração possa ser feita de forma gradual sem afetar outras equipes.
  3. Considere uma org de teste. Para grandes empresas Enterprise, crie uma organização de teste dedicada para validar a configuração declarativa antes de implantá-la nas org de produção.
  4. Use o Devin para escalar. O Devin pode configurar repos por meio de sessões paralelas — inicie uma sessão por repo, e o Devin gerará automaticamente propostas de configuração. Isso funciona bem para integrar de 10 a mais de 100 repos.
Para ver o guia completo de migração (incluindo o workflow passo a passo e a abordagem de teste), consulte Migrando da configuração interativa.

​
Próximas etapas