Jenkins X 项目迁移至 GCP Artifact Registry 的技术方案

背景概述

Google Cloud Platform 近期宣布将逐步淘汰 Container Registry 服务，并推荐用户迁移至新一代的 Artifact Registry。作为基于 GKE 的 Jenkins X 项目，需要及时完成这一技术迁移以确保容器镜像存储服务的持续可用性。

技术挑战分析

从 Container Registry 迁移到 Artifact Registry 涉及多个层面的技术调整：

1. 基础设施层需要重新配置镜像存储服务
2. 权限模型需要相应调整
3. 现有工作流程需要保持兼容
4. 迁移过程需要确保业务连续性

具体实施方案

1. Terraform 模块改造

核心改造集中在 terraform-google-jx 模块中，主要变更点包括：

• 默认启用 Artifact Registry 而非 Container Registry
• 自动创建 docker 存储库（默认命名为"oci"）
• 权限配置调整为 Artifact Registry 所需权限
• 在 jx-requirements.yml 中正确配置 registry 相关信息

存储库区域和现有存储库支持作为可选参数提供，确保灵活性。此变更被标记为破坏性更新，需要用户特别注意。

2. 配套仓库同步更新

相关配套仓库需要同步更新以保持兼容：

• jx3-terraform-gke 仓库适配新的基础设施配置
• jx3-gke-gsm 仓库调整密钥管理策略
• jx3-oss-infra 仓库更新基础设施定义

3. 认证机制优化

认证机制方面，Tekton 已具备自动处理能力，但 secret-schema.yaml 可能需要相应更新以支持新的认证方式。采用服务账号作为默认认证方式，既简化配置又确保安全性。

4. 迁移路径设计

对于已有环境的迁移，建议采用以下策略：

1. 先创建新的 Artifact Registry 存储库
2. 逐步将应用重新构建并推送到新仓库
3. 验证新流程正常工作后，再停用旧 Container Registry

Google 提供的镜像迁移工具可作为辅助手段，但不建议作为主要迁移方式，以避免潜在的兼容性问题。

最佳实践建议

1. 权限管理：确保服务账号拥有 artifactregistry.admin 角色
2. 命名规范：遵循一致的存储库命名规则
3. 区域选择：根据业务需求合理选择存储库区域
4. 监控告警：设置适当的监控以跟踪镜像推送/拉取情况

未来演进方向

虽然当前方案采用单一存储库设计已能满足多数场景，未来可考虑支持基于 git 仓库所有者的动态存储库创建，以提供更精细的权限控制和资源隔离。

通过上述改造，Jenkins X 在 GKE 上的容器镜像管理将全面升级至 Artifact Registry，既符合 Google Cloud 的技术路线图，又能为用户提供更稳定可靠的镜像存储服务。