Enterprise 环境概览

**前提条件：**本指南默认你已熟悉声明式环境配置。入门介绍请参阅声明式环境配置。

配置环境之前，请先确保已连接你的 SCM 提供商 (Enterprise Settings > Integrations) ，并且已为每个组织授予其仓库访问权限 (Enterprise Settings > Repository Permissions) 。在明确授予访问权限之前，各组织无法将 repo 添加到其环境中。详情请参阅 Git Integrations。

企业管理员可以定义一个适用于 Enterprise 内每个组织的基础环境。这样，你就能集中管理 Devin 使用的工具、运行时和安全基础架构，同时仍允许各个 org 和代码仓库在此基础上进行自定义配置。

蓝图层级

Devin 的环境配置采用三级层级结构，下一层级基于上一层级构建：

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

Tier	Who manages it	Scope
企业版	企业管理员	所有组织和所有仓库
组织	组织管理员	该组织中的所有仓库
仓库	组织管理员或仓库配置	单个仓库

这种关系是叠加式的：组织和仓库蓝图是在企业蓝图的基础上继续构建的，而不是替代它。每次构建时，都会先运行企业蓝图，以建立基线环境。接着运行组织蓝图，添加团队特定的配置。最后，再运行各个仓库的蓝图，完成项目特定的设置。有关组织蓝图和仓库蓝图之间关系的说明，请参阅蓝图作用域。

配置企业蓝图

前往 Enterprise Settings > Environments，然后打开 Blueprint 选项卡，定义企业蓝图。其格式与组织和代码仓库蓝图相同，包含 initialize、maintenance 和 knowledge 三个部分。企业蓝图和组织蓝图还支持 post-build 部分，用于在所有代码仓库完成克隆并设置完毕后运行命令。在每次构建期间，企业蓝图都会最先运行，先于组织和代码仓库蓝图。这意味着在企业级安装的工具和运行时可供所有下游蓝图使用。

企业蓝图中应包含的内容

企业蓝图适用于每个组织都需要的工具和配置。常见用例：

标准语言运行时

在整个企业范围内统一固定语言版本，确保每个团队都使用相同的工具链：

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"

安全工具与合规扫描

安装各项目都必须使用的扫描和审计工具：

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

内部 CLI 工具和实用程序

将公司专用工具分发到各个环境中：

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

共享软件包仓库配置

将软件包管理器配置为使用你的内部仓库：

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/

企业代理与证书设置

安装企业 CA 证书并配置代理设置：

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

各层级如何协同

在构建过程中，每个层级的步骤都会按固定顺序执行。较前层级的输出可供后续层级使用。在企业级安装的工具无需重新安装，即可直接在组织和代码仓库蓝图中使用。一次构建会按以下顺序创建新的快照：

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

post-build 步骤会在每个代码仓库都完成克隆和设置后运行，因此可以对完整组装好的环境进行验证。post-build 步骤返回非零退出代码会导致构建失败，并且不会生成快照。请参阅蓝图参考中的 post-build。各层级是叠加生效的：代码仓库蓝图可以使用由组织或企业蓝图安装的工具。较低层级不能覆盖较高层级已设置的内容。构建通常需要 5–15 分钟。单个命令会在 3 小时后超时。所有层级中的 knowledge 条目都会被汇总并提供给 Devin。如果多个层级定义了同名的 knowledge 条目，它们都会一并包含在内。它们不会相互覆盖。

企业级 secrets

企业管理员可以在企业级定义 secrets。这些 secrets 会在每一次构建和每一次会话期间，作为环境变量在所有组织中可用，包括企业级、组织级和代码仓库蓝图步骤，除非它们被标记为仅构建。对于整个公司范围内共享的凭据，请使用企业级 secrets：

内部软件包仓库令牌
企业代理身份验证
内部服务共用的 API key
企业工具的许可证密钥

企业级 secrets 在企业蓝图编辑器中的 Secrets 选项卡内管理。前往 Enterprise Settings > Environments > Blueprint 并切换到 Secrets 选项卡 (直达链接) ，即可在管理蓝图配置的同时管理企业级 secrets。

管理企业级 secrets 需要 ManageAccountResources 权限。

如果某个组织 secret 与企业级 secret 同名，则组织 secret 优先生效。这样各个组织就可以在需要时覆盖企业级默认设置。

仅构建期 enterprise secret

添加 enterprise secret 时，开启 仅构建 即可将其使用范围限制在环境配置阶段。仅构建期的 secret 只在快照构建期间对企业蓝图和组织蓝图的步骤可用。它会在克隆仓库之前被移除，因此仓库蓝图步骤和 post-build 步骤都无法读取，在 Devin 会话中也始终不可用。以这种方式标记的 secrets 会在 secrets 列表中显示 仅构建 标记。

企业范围内重建

企业管理员可以触发一次重建，并将其级联到所有组织。这在以下情况下很有用：

你更新了企业蓝图 (例如，将 Python 从 3.11 升级到 3.12)
你轮换了企业级 secret
你需要在安全补丁后刷新所有环境

在 Enterprise Settings > Environments > Blueprint 中保存企业蓝图，即可触发企业范围内重建。每个组织的构建都会使用更新后的企业蓝图运行，随后再应用其各自的组织蓝图和代码仓库蓝图。

企业范围内重建会遵循每个组织各自的构建队列。如果某个组织已经有构建正在进行中，由企业触发的重建会排在其后。如果某个构建已经在队列中，它会被取消并由企业触发的重建替代。

跨组织管理 rollout

Rollout 页面可让您在企业范围内查看各组织的环境健康状况和蓝图覆盖情况。您可以通过该页面查找未配置蓝图，或构建失败、长期未更新的组织。有关分阶段采用蓝图的 playbook 及构建健康状况指导，请参阅 Rollout 健康状况。

场景：与 ACME Corp 共同成长 — 随着公司规模扩大，选择层级的实际示例
rollout 健康状况
最佳实践
蓝图参考
声明式环境配置

快速开始

部署

环境管理

本地 Agent 控制项

用量管理

集成

安全与访问

用例与教程

Enterprise 环境概览

蓝图层级

配置企业蓝图

企业蓝图中应包含的内容

标准语言运行时

安全工具与合规扫描

内部 CLI 工具和实用程序

共享软件包仓库配置

企业代理与证书设置

各层级如何协同

企业级 secrets

仅构建期 enterprise secret

企业范围内重建

跨组织管理 rollout

​蓝图层级

​配置企业蓝图

​企业蓝图中应包含的内容

​标准语言运行时

​安全工具与合规扫描

​内部 CLI 工具和实用程序

​共享软件包仓库配置

​企业代理与证书设置

​各层级如何协同

​企业级 secrets

​仅构建期 enterprise secret

​企业范围内重建

​跨组织管理 rollout

​相关页面

蓝图层级

配置企业蓝图

企业蓝图中应包含的内容

标准语言运行时

安全工具与合规扫描

内部 CLI 工具和实用程序

共享软件包仓库配置

企业代理与证书设置

各层级如何协同

企业级 secrets

仅构建期 enterprise secret

企业范围内重建

跨组织管理 rollout

相关页面