CI/CD / 系统课时
用 ApplicationSet 管理多环境应用
用 ApplicationSet 管理多环境应用
当开发、预发布和生产环境使用同一套 Helm Chart、只在 Values 与目标 Namespace 上存在差异时,逐份维护 Argo CD Application 很容易产生重复配置。本节用 ApplicationSet 把环境差异变成参数,让一个模板稳定生成多个独立 Application。
学习目标
- 理解 ApplicationSet 与生成出的 Application 之间的关系
- 使用 List Generator 为多个环境提供独立 Helm Values
- 验证生成结果,并识别批量模板带来的变更范围
把重复 Application 提取成模板
假设仓库中的 charts/webapp 是共享 Chart,而环境配置分别保存在 values-dev.yaml、values-staging.yaml 和 values-prod.yaml。如果手写三个 Application,repoURL、Chart 路径、目标集群等字段会重复,真正变化的通常只有环境名、Namespace 和 Values 文件。
ApplicationSet 的核心做法是把不变部分放入 Application 模板,把变化部分交给 Generator 产生。控制器读取参数后,为每组参数渲染一个 Application;之后仍由 Argo CD 按普通 Application 的方式执行比较与同步。

用 List Generator 描述环境差异
下面是一份可直接提交给 Kubernetes API 的 ApplicationSet。示例假设已经安装 Argo CD ApplicationSet 控制器,并将 Git 仓库地址替换为实际可访问的仓库。
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
name: webapp-environments
namespace: argocd
spec:
generators:
- list:
elements:
- environment: dev
namespace: webapp-dev
valuesFile: values-dev.yaml
- environment: staging
namespace: webapp-staging
valuesFile: values-staging.yaml
- environment: prod
namespace: webapp-prod
valuesFile: values-prod.yaml
template:
metadata:
name: 'webapp-{{environment}}'
spec:
project: default
source:
repoURL: https://git.example.com/platform/webapp-config.git
targetRevision: main
path: charts/webapp
helm:
valueFiles:
- '{{valuesFile}}'
destination:
server: https://kubernetes.default.svc
namespace: '{{namespace}}'
syncPolicy:
syncOptions:
- CreateNamespace=true这里的 environment、namespace 和 valuesFile 来自 elements。每个元素都会套用一次 template,因此最终得到 webapp-dev、webapp-staging 和 webapp-prod 三个 Application。Values 文件路径相对于 Helm Chart 的来源位置解析,因此必须与仓库实际目录匹配。
配置生效后,可先提交资源,再检查生成的 Application:
kubectl apply -f applicationset.yaml
kubectl -n argocd get applications -l argocd.argoproj.io/application-set-name=webapp-environments预期输出的名称关系如下;SYNC STATUS、HEALTH STATUS 等动态状态取决于实际仓库与集群,因此这里不假定其值。
NAME
webapp-dev
webapp-staging
webapp-prod如果标签选择器因所用版本或安装方式不适用,可以直接执行 kubectl -n argocd get applications,再按名称确认三个 Application 是否存在。
保持环境参数真正独立
ApplicationSet 消除的是重复 YAML,而不是环境边界。生产环境的镜像标签、副本数、资源限制或域名等差异,仍应保留在独立 Values 文件中。不要为了减少文件数量,把三个环境的业务参数重新塞回同一个模板条件分支,否则模板会逐渐变成难以审查的环境逻辑中心。
当环境数量来自目录、集群注册信息或其他规则时,还可以换用 Git、Cluster 等 Generator。选择 Generator 的标准不是“功能越多越好”,而是谁能够自然表达环境清单的真实来源;环境数量少且明确时,List Generator 往往最容易审查。
验证生成结果而不是只看 ApplicationSet
ApplicationSet 创建成功只说明生成器资源被 API 接受,并不能证明模板渲染出的 Application 一定正确。排查时应同时检查 ApplicationSet 状态和具体 Application。
kubectl -n argocd get applicationset webapp-environments
kubectl -n argocd get application webapp-prod -o yaml预期结果是第一条命令能找到 webapp-environments,第二条命令中的 spec.source.helm.valueFiles 指向生产 Values,spec.destination.namespace 为 webapp-prod。实际输出还包含版本、状态、时间和其他控制器字段,因此会因环境不同而变化。
如果 Application 没有生成,优先检查 Generator 参数和模板变量名;如果 Application 已生成但 Helm 渲染失败,再检查 Chart 路径、Values 文件路径与仓库权限。这样能把“生成 Application”和“Application 同步资源”两个阶段分开定位,而不是把所有错误都归因于 ApplicationSet。