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 的方式执行比较与同步。

ApplicationSet 从环境参数生成多个 Application 的关系

用 List Generator 描述环境差异

下面是一份可直接提交给 Kubernetes API 的 ApplicationSet。示例假设已经安装 Argo CD ApplicationSet 控制器,并将 Git 仓库地址替换为实际可访问的仓库。

yaml
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:

bash
kubectl apply -f applicationset.yaml
kubectl -n argocd get applications -l argocd.argoproj.io/application-set-name=webapp-environments

预期输出的名称关系如下;SYNC STATUS、HEALTH STATUS 等动态状态取决于实际仓库与集群,因此这里不假定其值。

text
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。

bash
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。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 ApplicationSet 管理多环境应用

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

登录哪都通