Skip to main content
企业级环境配置适用于你的组织内所有团队都需要的基础架构:VPN 连接、CA 证书、代理配置和 DNS 覆盖。本页介绍企业级特有的概念。有关通用环境配置,请参阅环境配置指南。

哪些内容属于企业级

前往 Enterprise Settings > Environment (或在任意 组织 的 Environment Settings 页面点击 “Enterprise-wide setup”) 。YAML 格式与组织级和仓库级配置完全一致——同样适用 initializemaintenanceknowledge 这几个部分。
使用场景Enterprise组织级仓库级
VPN / 网络访问
CA 证书
代理配置
DNS 覆盖
GPG commit 签名
共享语言运行时
组织级 CLI 工具
私有 registry 认证
仓库依赖
仓库级测试/lint
企业级更改影响范围很大。 保存后会触发所有组织的构建。在企业级应用之前,请先在单个 组织 中测试基础架构命令 (使用组织级配置) 。
企业级配置不能克隆代码仓库——克隆代码仓库需要组织级访问权限。企业级配置仅应用于共享基础架构 (VPN、证书、工具) 。代码仓库克隆会在组织级自动处理。
有关 VPN、CA 证书、代理和私有 registry 的示例,请参阅“配置示例”页面中的 企业级示例

企业级权限

操作所需角色
查看/编辑 企业级 配置Enterprise Admin
查看/编辑 组织 配置Org Admin 或 Enterprise Admin
查看 代码仓库 配置任何 组织 成员
编辑 代码仓库 配置拥有 ManageOrgSnapshots 权限的 Member

构建级联

当你更改企业级配置时:
  1. 每个组织都会触发一次新的构建
  2. 每个组织的构建包含:企业级配置 → 组织配置 → 所有 代码仓库 配置
  3. 各组织的构建彼此独立运行——一个组织构建失败不会影响其他组织
  4. 每个组织都会获得自己的机器镜像
企业级 initialize 步骤的顺序很重要。 必须先配置 VPN (这样才能访问内部主机) ,然后配置 DNS (这样名称才能解析) ,接着配置证书 (这样 HTTPS 才能正常工作) ,然后配置代理 (这样流量才能正确路由) ,最后再配置任何需要从内部源下载内容的工具。

多组织管理

推荐的配置顺序:
  1. 先配置 企业级 — 设置共享基础架构 (VPN、证书、代理)
  2. 接着进行组织级配置 — 由各 组织 的管理员配置共享工具和 registry 访问权限
  3. 最后进行代码仓库级配置 — 各团队配置各自的代码仓库
每个 组织 都有自己的机器镜像。企业级配置是共享且可叠加的,但组织级和仓库级配置彼此隔离——Org A 的配置不会影响 Org B,一个 组织 中的构建失败也不会影响其他 组织。有关 组织 结构的更多信息,请参阅了解组织结构 配置层级 (企业级 → Org → Repo) 是严格可叠加的。每一层的命令都会在上一层完成后按顺序运行。较低层级不能覆盖或修改较高层级已配置的内容。

企业迁移

对于从旧版交互式设置迁移到声明式配置的企业:
  1. 先配置企业级 YAML。 先设置共享基础架构,例如 VPN、证书和代理设置。
  2. 一次迁移一个 组织。 每个 组织 都有各自的“使用旧版机器快照”开关,因此你可以逐步迁移,而不影响其他团队。
  3. 考虑创建测试 组织。 对于大型企业,建议先创建一个专用的测试 组织,在向生产 组织 推出之前验证声明式配置。
  4. 使用 Devin 进行规模化配置。 Devin 可以通过并行 session 配置 代码仓库——为每个 代码仓库 启动一个 session,Devin 会自动生成配置建议。这种方式非常适合为 10–100+ 个 代码仓库 完成接入。
有关完整的迁移指南 (包括分步骤工作流程和测试方法) ,请参阅 从交互式设置迁移

后续步骤