Visão geral do ambiente Enterprise

Pré-requisitos: Este guia pressupõe familiaridade com a configuração declarativa de ambientes. Consulte Configuração declarativa de ambiente para uma introdução.

Antes de configurar ambientes, certifique-se de que seu provedor de SCM esteja conectado (Configurações do Enterprise > Integrações) e de que cada organização tenha recebido acesso aos seus repositórios (Configurações do Enterprise > Permissões de Repositório). As orgs não podem adicionar repositórios ao ambiente até que esse acesso seja concedido explicitamente. Consulte Integrações com Git para mais detalhes.

Os admins do Enterprise podem definir um ambiente base que se aplica a todas as organizações do Enterprise. Isso dá a você controle centralizado sobre as ferramentas, runtimes e a infraestrutura de segurança que o Devin usa, sem deixar de permitir que orgs e repositórios individuais personalizem sua própria configuração sobre essa base.

A hierarquia do blueprint

A configuração do ambiente do Devin segue uma hierarquia de três níveis. Cada nível se baseia no anterior:

+-----------------------------------------+
|  Enterprise Blueprint                   |
|  Python 3.12, Node 20, security tools   |
+-----------------------------------------+
|  Organization Blueprint                 |
|  private npm registry, team linting     |
+-----------------------------------------+
|  Repository Blueprint                   |
|  npm install, project-specific config   |
+-----------------------------------------+

Nível	Quem gerencia	Escopo
Enterprise	admins do Enterprise	Todas as organizações, todos os repositórios
Organização	admins da organização	Todos os repositórios da organização
Repositório	admins da organização ou configuração do repositório	Um único repositório

A relação é aditiva: os blueprints da organização e do repositório se somam ao blueprint Enterprise; eles não o substituem. Durante cada build, o blueprint Enterprise é executado primeiro, estabelecendo a base. Em seguida, o blueprint da organização é executado, adicionando configurações específicas da equipe. Por fim, o blueprint de cada repositório é executado com a configuração específica do projeto. Consulte Escopo do blueprint para entender como os blueprints da organização e do repositório se relacionam.

Configurando o blueprint Enterprise

Navegue até Enterprise Settings > Environments e abra a aba Blueprint para definir o blueprint Enterprise. Ele segue o mesmo formato dos blueprints de organização e repositório, com as seções initialize, maintenance e knowledge. Os blueprints Enterprise e de organização também oferecem suporte a uma seção post-build para comandos executados após todos os repositórios serem clonados e configurados. O blueprint Enterprise é executado primeiro em cada build, antes dos blueprints de organização e repositório. Isso significa que as ferramentas e os runtimes instalados no nível Enterprise ficam disponíveis para todos os blueprints posteriores.

O que incluir no blueprint Enterprise

O blueprint Enterprise serve para ferramentas e configurações de que toda organização precisa. Casos de uso comuns:

Runtime padrão para linguagens

Fixe versões de linguagens em toda a organização para que cada equipe trabalhe com o mesmo conjunto de ferramentas:

initialize:
  - name: "Install Python 3.12"
    uses: github.com/actions/setup-python@v5
    with:
      python-version: "3.12"

  - name: "Install Node.js 20"
    uses: github.com/actions/setup-node@v4
    with:
      node-version: "20"

  - name: "Install Go 1.22"
    uses: github.com/actions/setup-go@v5
    with:
      go-version: "1.22"

Ferramentas de segurança e varredura de conformidade

Instale ferramentas de varredura e de auditoria que todo projeto deve usar:

initialize:
  - name: "Install security tools"
    run: |
      npm install -g snyk
      pip install safety bandit
      curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sh

Ferramentas e utilitários internos de linha de comando

Distribua ferramentas próprias da empresa para cada ambiente:

initialize:
  - name: "Install internal CLI"
    run: |
      curl -L https://internal.example.com/cli/latest/linux-amd64 \
        -o /usr/local/bin/internal-cli
      chmod +x /usr/local/bin/internal-cli

Configuração compartilhada do registro de pacotes

Configure os gerenciadores de pacotes para usar seus registros internos:

initialize:
  - name: "Configure internal registries"
    run: |
      npm config set registry https://npm.internal.example.com/
      pip config set global.index-url https://pypi.internal.example.com/simple/

Configuração de proxy e certificados corporativos

Instale os certificados de CA corporativa e configure o proxy:

initialize:
  - name: "Install corporate certificates"
    run: |
      cp "$FILE_CORPORATE_CA_CERT" /usr/local/share/ca-certificates/corporate-ca.crt
      update-ca-certificates
      echo 'export NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/corporate-ca.crt' >> ~/.bashrc

Como os níveis interagem

Durante uma build, as etapas de cada nível são executadas em uma sequência fixa. O resultado dos níveis anteriores fica disponível para os seguintes. As ferramentas instaladas no nível Enterprise ficam prontas para uso nos blueprints de organização e repositório sem precisar ser reinstaladas. Uma build cria um novo snapshot nesta ordem:

1. Enterprise blueprint (runs in ~):
   a. initialize
   b. maintenance
2. Organization blueprint (runs in ~):
   a. initialize
   b. maintenance
3. Clone all repositories (up to 10 concurrent)
4. For each configured repo, in the order shown in Settings
   (runs in ~/repos/<repo-name>):
   a. initialize
   b. maintenance
5. post-build (org- and enterprise-level; runs in ~)
6. Health check, then snapshot is saved

As etapas de post-build são executadas depois que todos os repositórios forem clonados e configurados, para que possam validar o ambiente completamente montado. Um código de saída diferente de zero em uma etapa de post-build faz a build falhar, e nenhum snapshot é gerado. Consulte post-build na Referência de blueprints. Os níveis são aditivos: blueprints de repositório podem usar ferramentas instaladas pelo blueprint da organização ou pelo blueprint Enterprise. Níveis inferiores não podem sobrescrever o que um nível superior configurou. Builds normalmente levam de 5 a 15 minutos. Comandos individuais atingem o tempo limite após 3 horas. Os itens de knowledge de todos os níveis são coletados e disponibilizados ao Devin. Se vários níveis definirem um item de knowledge com o mesmo nome, todos eles serão incluídos. Eles não sobrescrevem uns aos outros.

Segredos do Enterprise

Os admins do Enterprise podem definir segredos no nível Enterprise. Esses segredos ficam disponíveis como variáveis de ambiente durante cada build e cada sessão em todas as organizações, inclusive em etapas de blueprint Enterprise, da organização e do repositório, a menos que estejam marcados como somente build. Use segredos do Enterprise para credenciais compartilhadas em toda a empresa:

Tokens de registros de pacotes internos
Autenticação de proxy corporativo
Chaves de API compartilhadas para serviços internos
Chaves de licença para ferramentas Enterprise

Os segredos do Enterprise são gerenciados na aba Segredos dentro do editor de blueprint Enterprise. Acesse Enterprise Settings > Environments > Blueprint e mude para a aba Segredos (link direto) para gerenciar segredos em todo o Enterprise junto com a configuração do seu blueprint.

Gerenciar segredos do Enterprise requer a permissão ManageAccountResources.

Se um segredo da organização tiver o mesmo nome que um segredo do Enterprise, o segredo da organização terá precedência. Isso permite que organizações individuais substituam os padrões definidos para todo o Enterprise quando necessário.

Segredos do Enterprise apenas para build

Ao adicionar um segredo do Enterprise, ative Build only para restringi-lo à configuração do ambiente. Um segredo apenas para build fica disponível somente para as etapas de blueprints de enterprise e de org durante os builds do snapshot. Ele é removido antes que os repositórios sejam clonados, portanto as etapas de blueprint de repo e as etapas post-build não conseguem lê-lo, e ele nunca fica disponível nas sessões do Devin. Os segredos marcados dessa forma exibem um badge Build only na lista de segredos.

Rebuilds em todo o Enterprise

Os admins do Enterprise podem acionar um rebuild em cascata para todas as organizações. Isso é útil quando:

Você atualiza o blueprint Enterprise (por exemplo, faz upgrade do Python da versão 3.11 para 3.12)
Você rotaciona um segredo do Enterprise
Você precisa atualizar todos os ambientes após um patch de segurança

Acione um rebuild em todo o Enterprise salvando o blueprint Enterprise em Enterprise Settings > Environments > Blueprint. O build de cada organização é executado com o blueprint Enterprise atualizado, seguido pelos blueprints da própria organização e do repositório.

Os rebuilds em todo o Enterprise respeitam a fila de builds de cada organização. Se uma organização já tiver um build em andamento, o rebuild acionado pelo Enterprise entra na fila atrás dele. Se já houver um build na fila, ele será cancelado e substituído pelo acionado pelo Enterprise.

Gerenciamento do rollout entre organizações

A página Rollout oferece visibilidade em toda a Enterprise sobre a integridade dos ambientes de cada organização e a cobertura de blueprints. Use-a para identificar organizações sem blueprint ou com builds com falha ou obsoletos. Consulte Integridade do rollout para conhecer o playbook de adoção gradual de blueprints e as orientações sobre a integridade dos builds.

Cenários: crescendo com a ACME Corp — exemplos práticos de como escolher um nível conforme a empresa cresce

Primeiros passos

Implantação

Gerenciamento de ambiente

Controles do agente local

Gerenciamento de uso

Integrações

Security e acesso

Casos de uso e tutoriais

Visão geral do ambiente Enterprise

A hierarquia do blueprint

Configurando o blueprint Enterprise

O que incluir no blueprint Enterprise

Runtime padrão para linguagens

Ferramentas de segurança e varredura de conformidade

Ferramentas e utilitários internos de linha de comando

Configuração compartilhada do registro de pacotes

Configuração de proxy e certificados corporativos

Como os níveis interagem

Segredos do Enterprise

Segredos do Enterprise apenas para build

Rebuilds em todo o Enterprise

Gerenciamento do rollout entre organizações

​A hierarquia do blueprint

​Configurando o blueprint Enterprise

​O que incluir no blueprint Enterprise

​Runtime padrão para linguagens

​Ferramentas de segurança e varredura de conformidade

​Ferramentas e utilitários internos de linha de comando

​Configuração compartilhada do registro de pacotes

​Configuração de proxy e certificados corporativos

​Como os níveis interagem

​Segredos do Enterprise

​Segredos do Enterprise apenas para build

​Rebuilds em todo o Enterprise

​Gerenciamento do rollout entre organizações

​Páginas relacionadas

A hierarquia do blueprint

Configurando o blueprint Enterprise

O que incluir no blueprint Enterprise

Runtime padrão para linguagens

Ferramentas de segurança e varredura de conformidade

Ferramentas e utilitários internos de linha de comando

Configuração compartilhada do registro de pacotes

Configuração de proxy e certificados corporativos

Como os níveis interagem

Segredos do Enterprise

Segredos do Enterprise apenas para build

Rebuilds em todo o Enterprise

Gerenciamento do rollout entre organizações

Páginas relacionadas