CI/CD / 系统课时
选择多环境仓库目录布局
选择多环境仓库目录布局
同一个应用进入开发、预发布和生产环境后,真正需要变化的通常不是 Chart 模板,而是镜像版本、副本数、域名和资源限制。本篇比较三种常见仓库布局,并给出一种便于 Argo CD 持续同步和审查环境差异的组织方式。
学习目标
- 区分单 Chart 多 Values、环境目录和应用配置分离三种布局
- 根据环境数量、团队边界和发布权限选择仓库结构
- 设计让环境差异可审查、可追踪的 Helm 配置目录
三种布局解决的问题不同
最简单的做法是在应用仓库中保留一份 Chart,再为每个环境准备独立 Values 文件。例如:
shop/
Chart.yaml
templates/
values.yaml
values-dev.yaml
values-staging.yaml
values-prod.yaml这属于单 Chart 多 Values。模板只维护一份,环境差异集中在 Values 中,适合环境数量少、同一团队同时负责应用代码和部署配置的项目。
当每个环境还需要独立的 Argo CD Application、命名空间或其他 Kubernetes 配置时,可以进一步使用环境目录:
apps/
shop/
chart/
environments/
dev/
values.yaml
staging/
values.yaml
prod/
values.yaml环境目录让差异具有明确边界。代码评审时看到 prod/values.yaml 被修改,就能立即知道变更作用于生产环境,而不必从多个命名相似的文件中判断目标环境。

应用配置分离适合更强的治理边界
规模扩大后,可以把应用源码与部署配置放入不同仓库。应用仓库负责构建镜像和维护 Chart,GitOps 仓库只保存环境希望运行的版本与配置。例如 GitOps 仓库可以采用:
gitops/
shop/
dev/
values.yaml
staging/
values.yaml
prod/
values.yaml这时应用发布不再等于直接修改生产环境。CI 可以构建并推送镜像,而部署动作表现为对 GitOps 仓库中镜像标签等声明状态的修改。生产配置还可以使用独立审批规则和仓库写权限。
这种方式的代价是跨仓库变更多了一层协调。Chart 接口发生不兼容变化时,必须确认 GitOps 仓库中的 Values 仍与新 Chart 匹配。因此,拆仓库不是天然更先进,而是在团队职责和权限确实需要分离时才值得采用。
用 Helm 验证目录设计
无论采用哪种布局,都应保证某个环境的配置能够明确组合成最终清单。假设当前目录包含 Chart 和 environments/prod/values.yaml,可以先在本地渲染生产配置:
helm template shop ./chart -f ./environments/prod/values.yaml预期输出
---
# Source: shop/templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: shop实际清单会随 Chart 模板变化;关键验证点是 Helm 能成功读取指定环境的 Values 并生成 Kubernetes 清单,而不是得到某一组固定字段。
按团队边界做选择
环境少、团队小且 Chart 与部署由同一组人员维护时,优先选择单 Chart 多 Values,结构最直接。环境配置逐渐复杂,需要为每个环境放置更多资源时,环境目录通常更易维护。
当应用开发与平台发布由不同团队负责,尤其生产环境需要独立审批和权限控制时,再把应用仓库与 GitOps 配置仓库分离。无论采用哪一种方案,都应尽量让 Chart 表达应用的通用部署能力,让环境目录只保存真正的差异,避免复制整套模板后形成难以同步的多个版本。