CI/CD / 系统课时

设计应用仓库与 Chart 仓库关系

设计应用仓库与 Chart 仓库关系

GitOps 落地时,仓库怎么拆会直接影响开发协作、版本追踪和环境发布。本节从应用代码、Helm Chart 与环境配置三类资产出发,设计可维护的仓库关系,并根据团队规模和发布频率选择合适的拆分边界。

学习目标

  • 区分应用代码、Helm Chart 与环境配置各自的变更职责
  • 根据团队规模和发布频率选择单仓库或多仓库方案
  • 能验证 Argo CD 实际追踪的是哪个仓库、路径和版本

先分清三类需要版本化的资产

一个采用 Helm 与 Argo CD 的应用,通常至少存在三类 Git 内容。应用仓库保存源代码、测试和镜像构建定义;Chart 描述 Kubernetes 资源模板及默认值;环境配置决定某个环境最终使用哪个镜像版本、域名、副本数和资源参数。

这三类内容的变化节奏并不相同。开发者可能一天提交多次业务代码,但 Chart 的 Deployment 模板数周才变化一次;生产环境的镜像版本则可能由独立发布流程更新。因此,仓库边界应围绕谁修改、多久修改一次、谁审批来设计,而不是为了目录整齐机械拆分。

应用代码、Chart 与环境配置的仓库关系

小团队可以先采用单仓库

应用数量少、同一团队同时维护代码和部署定义时,可以把 Chart 与应用代码放在一个仓库。这样一次代码评审就能看到业务实现和部署模板的关联变化,维护成本最低。

例如仓库可以采用下面的目录。这里是片段示例,用于说明仓库布局,不代表需要执行的 Shell 命令。

text
payment-service/
  src/
  Dockerfile
  charts/
    payment-service/
      Chart.yaml
      values.yaml
      templates/
  environments/
    dev-values.yaml
    prod-values.yaml

这种方案适合发布权限基本一致的团队,但代码提交和生产配置处在同一权限边界。如果生产发布需要独立审批,或者多个应用共享同一套 Chart,继续放在单仓库中会让权限和版本关系越来越难管理。

多团队更适合拆出环境配置

当应用开发与平台运维由不同人员负责时,更常见的做法是应用仓库负责构建镜像,Chart 仓库负责可复用部署模板,环境仓库保存各环境期望状态。生产发布因此可以表现为环境仓库中的一次明确 Git 变更。

环境仓库可以保持非常直接的结构:

text
gitops-environments/
  payment-service/
    dev/
      values.yaml
    staging/
      values.yaml
    prod/
      values.yaml

例如生产配置只固定已经构建完成的镜像版本:

yaml
image:
  repository: registry.example.com/payment-service
  tag: "2.4.1"
replicaCount: 4

这是配置文件示例,不产生固定控制台输出。生效行为是 Helm 渲染时使用 2.4.1 镜像和 4 个副本;可以通过 Argo CD 的 Application 源配置和集群 Deployment 状态验证实际版本。

让 Argo CD 的追踪边界保持明确

无论采用哪种拆分方式,都应能回答三个问题:Argo CD 从哪个仓库读取、读取哪个路径、追踪哪个 revision。可以直接检查 Application 资源:

bash
kubectl -n argocd get application payment-service -o jsonpath='{.spec.source.repoURL}{"\n"}{.spec.source.path}{"\n"}{.spec.source.targetRevision}{"\n"}'

预期输出

text
https://git.example.com/platform/gitops-environments.git
payment-service/prod
main

仓库地址、路径和分支会随实际配置不同。若使用多源 Application,源信息位于 spec.sources,不能再用这个单源字段组合判断全部来源。

用变更边界决定是否继续拆仓

仓库拆得越多并不代表 GitOps 越成熟。小团队中,单仓库可以减少跨仓版本协调;当 Chart 被多个应用复用时,独立 Chart 仓库更容易做版本管理;当生产配置有独立审批、审计或权限要求时,环境仓库通常值得单独维护。

最终应让一次 Git 提交的含义足够清楚:代码仓库回答“构建什么”,Chart 回答“怎样部署”,环境配置回答“某个环境现在应该运行什么”。只要职责和版本关系能够稳定追踪,就没有必要为了形式继续增加仓库数量。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计应用仓库与 Chart 仓库关系

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通