跳转到主要内容
将企业从传统的环境设置迁移到声明式配置，是一项重大变更。Rollout 页面为企业管理员提供了对这一迁移过程的细粒度控制。你可以先为少数试点 org 启用蓝图，按自己的节奏逐步扩大范围，并在出现问题时立即回滚。

​
Enterprise 发布状态

Enterprise 有三个顶层状态，用于控制蓝图如何向各个组织开放：
状态含义对组织的影响
DisabledEnterprise 未启用蓝图没有任何组织会看到环境页面。所有组织都使用经典设置。
Default Off蓝图可用，但不是默认设置Enterprise Admin 可以为各个组织单独启用。新组织默认使用经典设置。
Default On蓝图默认对所有组织启用所有组织都使用蓝图，除非被明确切换回经典设置。新组织默认使用蓝图。
状态切换按顺序进行：Disabled → Default Off → Default On。你也可以向后切换 (Default On → Default Off) ，以放慢发布节奏。

​
默认关闭详情

在“默认关闭”状态下，尚未选择启用的组织会继续使用传统设置，使用体验不会发生任何变化。企业管理员可以在 Rollout 页面为单个组织启用该功能。只有这些组织会切换到声明式配置。 还有一个额外的开关：向所有组织显示迁移提示。启用后，仍在使用传统设置的组织管理员会在其 Machine Configuration 页面看到提示信息，鼓励他们迁移到声明式配置。这不会改变他们当前的设置，也不会让他们获得完整环境配置页面的访问权限。它只是让他们知道蓝图现已可用，并提供启用路径。这有助于你在开始迁移组织之前先提高认知。 当此开关被禁用时，未被明确启用的组织不会看到任何新内容。他们的使用体验保持不变。

​
按组织覆盖

Enterprise admins 可以在 Rollout 页面为单个组织覆盖发布状态：
  • 在 Default Off 时：让特定组织 启用 blueprints。这些组织会立即从经典设置切换为声明式配置。
  • 在 Default On 时：让特定组织 退出 blueprints，恢复为经典设置。这些组织会继续使用其经典配置。
覆盖设置是持久的，不会因 enterprise 状态变化而丢失。如果你在 Default Off 阶段为某个组织启用了 blueprints，那么当你切换到 Default On 时，它仍会保持启用 blueprints。

​
自动经典模式覆盖

当从 默认关闭 切换到 默认开启 时，系统会通过一项保护机制避免造成干扰：任何当前使用经典设置且已配置仓库的 org，都会自动获得一条显式的经典模式覆盖规则。这意味着，此次切换不会改变那些仍在实际使用经典设置的 org 的状态。它们会保持现状，直到你明确对其进行迁移。 没有仓库的 org (或已经使用蓝图的 org) 不受这项保护机制影响。 最佳做法是在向组织管理员开放之前，先在隔离环境中完成配置并进行验证。不要一次性大规模迁移。先在可控范围内开展，验证无误后再逐步扩大范围。

​
第 1 阶段：在隔离环境中构建并验证 (默认关闭)

首先让企业处于 默认关闭 模式。各组织不能自行选择启用，因此你可以完全掌控。
  1. 在企业级将蓝图状态从 已禁用 切换为 默认关闭，以启用蓝图。
  2. 创建一个专用测试组织，用于测试环境配置。该组织仅用于验证你的蓝图。
  3. 仅为该测试组织启用声明式配置 (通过 Rollout 页面上的按组织覆盖) 。
  4. 配置企业蓝图：安装所有共享的语言运行时、安全工具、企业证书、内部 CLI、代理设置和 registry 身份验证。这是每个组织都会继承的基础层。
  5. 为测试组织配置组织蓝图，加入任何组织级工具或 registry 配置。
  6. 为一组有代表性的代码仓库添加代码仓库蓝图。选择能覆盖你最常见技术栈的代码仓库。
  7. 进行端到端验证：在这些代码仓库上启动 Devin 会话，并确认一切正常。代码仓库应能成功克隆，依赖应能正确安装，lint/test/build 命令应能正常运行，且所有工具都处于预期版本。
不要只检查构建是否成功。构建通过并不总是意味着环境可用。缺少 PATH 条目、工具版本错误或缺失 registry 身份验证等问题，都可能被忽略。务必通过 运行一次真实的 Devin 会话来验证。

​
阶段 2：让 org 管理员可自行启用

一旦你确认 enterprise → org → repo 蓝图栈能够正确组合并生成可用环境：
  1. 在内部沟通，告知 org 管理员声明式配置现已可用，并已准备就绪。
  2. 启用迁移提示：切换 “Show migration nudge to all organizations”，让使用经典设置方式的 org 管理员看到鼓励他们迁移的提示。
  3. org 管理员现在可以迁移各自的组织。由于 enterprise 蓝图已提供基础层 (运行时、工具、证书、制品仓库) ，org 管理员只需配置其团队和 repo 特有的内容。
每位 org 管理员都可以使用 迁移助手 轻松完成此操作。Devin 可以检查该组织现有的快照，并自动生成等效的蓝图配置。有关详细步骤，请参阅迁移到声明式配置。 为你最常见的技术栈 (Node.js、Python、Java、Go、多语言 monorepo) 建立一个模板蓝图库，并在内部共享，这样 org 管理员就不必从零开始。模板库 是一个很好的基础。

​
第 3 阶段：扩展并清理

  1. 当大多数组织都已切换到蓝图后，切换为默认开启。此前使用带有 repo 的经典设置的组织会自动获得经典覆盖，因此对它们不会有任何影响。
  2. 在此之后新创建的组织将默认启用蓝图。
  3. 监控 Rollout 页面，查看所有组织的构建健康状况。按“Classic”筛选即可查看哪些组织尚未迁移。
  4. 与其余组织管理员协作，迁移剩余未完成的组织。迁移助手可让这一过程变得非常直接。
  5. 当所有组织都已在蓝图上完成验证后，移除经典覆盖。
经典配置始终会被保留。组织切换到蓝图时不会删除任何内容。如果出现问题，企业管理员可以立即从 Rollout 页面将任何组织切换回经典设置。

​
回滚

事情并不总能一帆风顺。发布系统在各个层级都支持回滚。

​
按组织回滚

Enterprise 管理员可以在 Rollout 页面将任意单个组织切换回经典设置：
  • 该组织会立即恢复为使用其经典设置快照。
  • 经典配置会被保留。组织切换到蓝图时不会丢失任何内容，因此切换回去是安全的。
  • 活跃会话不受影响。更改会在下一个会话生效。

​
Enterprise 级别回滚

Enterprise 管理员可以从 Default On 切换回 Default Off：
  • 具有显式蓝图覆盖设置的组织会保留这些设置，继续使用蓝图。
  • 默认使用蓝图 (无覆盖设置) 的组织会恢复为经典设置。
  • 这是一个安全操作。无论向哪个方向切换，都不会丢失任何配置数据。
回滚不会删除蓝图或经典配置。无论当前启用的是哪种模式，两者都会被保留，因此你可以来回切换而不会丢失已有工作成果。

​
监控发布运行状况

Rollout 页面提供了一个仪表板，用于跟踪整个企业范围内的迁移进度。

​
KPI 行

在页面顶部，汇总指标可帮助你快速了解发布进度：
  • Blueprint 组织：当前使用 Blueprint 的组织数量
  • Rollout 百分比：使用 Blueprint 的组织占组织总数的比例
  • 构建健康状况：所有 Blueprint 组织的构建状态汇总

​
各组织表格

在 KPI 下方，详细表格会显示每个组织的信息：
列说明
Organization组织名称
State当前模式：Blueprints 或 Classic
Override该组织的状态是否为显式覆盖，而不是采用企业默认值
Classic repos使用 Classic 设置配置的 repo 数量
Blueprint repos使用 Blueprints 的 repo 数量
Latest build最近一次构建的状态 (成功、部分成功、失败等)

​
筛选

可按以下条件筛选表格：
  • 全部：企业中的所有组织
  • Blueprints：当前使用蓝图的组织
  • Classic：当前使用经典配置的组织
  • Overrides：具有显式状态覆盖的组织 (包括任一方向的覆盖)

​
并发安全

状态转换机制可防止同时发生的更改。如果你加载页面后到提交更改前的这段时间内，另一位管理员更改了企业状态，该请求会因冲突错误而被拒绝。 这可防止多位企业管理员同时操作时意外覆盖彼此的更改。如果你的更改被拒绝，请刷新页面查看当前状态，并在确认仍适用后重新提交。

​
审计日志记录

所有 rollout 状态变更都会记录在审计日志中：
  • Enterprise 状态变更 (Disabled → Default Off、Default Off → Default On 等)
  • 各 org 的覆盖设置变更 (org 选择加入、org 选择退出、移除覆盖)
  • 由哪位 Admin 在何时进行了更改
这些日志可通过你所在 Enterprise 的标准审计日志界面查看。