3. ApplicationSet 控制器概述：解决多集群/多环境部署的痛点，模板化生成 Application

在 GitOps 实践中，当需要将同一套应用部署到多个集群（开发、测试、预发、生产）或多个地域时，如果为每个目标手动创建 ArgoCD Application，将面临巨大的维护成本和配置漂移风险。ApplicationSet 控制器正是为解决这一核心痛点而设计的——它通过模板化机制，将 Application 的生成逻辑与部署目标解耦，实现“一次定义，批量生成”。

3.1 多集群/多环境部署的四大痛点

在引入 ApplicationSet 之前，团队通常采用“复制-修改”的方式管理多环境 Application，这种方式在 3 个以上目标时就会迅速失控：

3.2 ApplicationSet 是什么？

ApplicationSet 是 ArgoCD 的一个子项目，也是一个 Kubernetes CRD（Custom Resource Definition）。它定义了一个“生成器 + 模板”的组合：

• 生成器（Generators）： 负责动态生成一组参数（如集群名称、环境标签、地域代码）。
• 模板（Template）： 一个标准的 ArgoCD Application 定义，其中使用 {{参数名}} 占位符引用生成器输出的参数。

当 ApplicationSet 控制器检测到生成器的输入发生变化（如集群列表更新、Git 仓库新增分支），它会自动重新渲染模板，创建、更新或删除对应的 Application 实例。

3.3 核心架构与工作流程

下图展示了 ApplicationSet 控制器如何将“生成器参数”与“Application 模板”结合，最终在多个目标集群上生成独立的 Application：

3.4 模板化生成 Application 的典型示例

以下是一个使用 Cluster Generator 的 ApplicationSet 示例。它会自动发现 ArgoCD 中注册的所有集群，并为每个集群生成一个 Application：

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: myapp-multi-cluster
spec:
  generators:
    - clusters: {}  # 自动发现所有已注册集群
  template:
    metadata:
      name: '{{name}}-myapp'  # {{name}} 由生成器自动填充为集群名称
    spec:
      project: default
      source:
        repoURL: https://git.company.com/myapp.git
        targetRevision: HEAD
        path: 'overlays/{{name}}'  # 每个集群使用独立的 overlay 目录
      destination:
        server: '{{server}}'       # {{server}} 由生成器自动填充为集群 API Server URL
        namespace: myapp
      syncPolicy:
        automated:
          prune: true
          selfHeal: true

3.5 五种核心生成器对比

ApplicationSet 提供了多种生成器以适应不同的部署场景。选择合适的生成器是设计 GitOps 流水线的关键一步：

3.6 ApplicationSet 带来的核心价值

引入 ApplicationSet 后，多集群/多环境部署的运维模式发生了根本性转变：

• 声明式扩缩： 新增集群只需在 ArgoCD 中注册，ApplicationSet 自动为其创建 Application，无需手动编写 YAML。
• 单一事实来源： 所有环境的差异通过生成器参数表达，模板本身保持纯净，避免配置漂移。
• 环境一致性审计： 通过对比不同环境生成的 Application 参数，可以快速发现环境间的非预期差异。
• 波次编排基础： ApplicationSet 的 syncPolicy 和后续章节将介绍的 Progressive Sync 功能，为滚动发布和金丝雀部署提供了天然的编排入口。