4. Application 资源定义：Source（Git仓库）、Destination（目标集群）、Sync Policy（同步策略）详解

Argo CD 的 Application 是 GitOps 工作流的核心实体，它定义了“从何处拉取期望状态”、“部署到哪个目标集群”以及“如何执行同步”三个关键维度。本章将深入解析 Application 清单中的三大核心字段：Source、Destination 和 Sync Policy，帮助你在生产环境中精准控制每个应用的部署行为。

4.1 Source：定义期望状态的来源

Source 字段指定了 Argo CD 从哪个 Git 仓库、哪个分支、哪个路径拉取 Kubernetes 资源清单。它支持 Helm、Kustomize、Jsonnet 等多种配置管理工具。

4.1.1 Source 核心参数

4.1.2 多 Source 与多目标模式

Argo CD 2.6+ 支持 多 Source（Multi-Source），允许一个 Application 从多个 Git 仓库或同一仓库的不同路径合并资源。这在微服务架构中尤为实用：基础层（如 CRD、RBAC）来自一个仓库，业务层来自另一个仓库。

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: multi-source-app
spec:
  sources:
    - repoURL: 'https://github.com/example/infra-base.git'
      targetRevision: main
      path: crds
    - repoURL: 'https://github.com/example/app-config.git'
      targetRevision: release-1.0
      path: overlays/production
  destination:
    server: 'https://kubernetes.default.svc'
    namespace: production
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

4.2 Destination：定义目标集群与命名空间

Destination 字段告诉 Argo CD 将应用部署到哪个 Kubernetes 集群的哪个命名空间。它支持单集群、多集群（通过 Cluster Secret）以及控制平面自身。

4.2.1 Destination 核心参数

4.2.2 多集群部署模式

通过 Argo CD 的 Cluster Secret 机制，可以注册多个外部集群。Application 的 Destination 指向不同集群，实现“一次 Git 提交，多集群同步”。

# 注册外部集群的 Secret 示例
apiVersion: v1
kind: Secret
metadata:
  name: prod-cluster-01
  namespace: argocd
  labels:
    argocd.argoproj.io/secret-type: cluster
type: Opaque
stringData:
  name: prod-cluster-01
  server: https://192.168.1.100:6443
  config: |
    {
      "bearerToken": "<your->",
      "tlsClientConfig": {
        "insecure": false,
        "caData": "<base64-ca>"
      }
    }

4.3 Sync Policy：定义同步行为与自动化策略

Sync Policy 决定了 Argo CD 如何将 Source 中的期望状态应用到 Destination 集群。它包含自动化策略、修剪策略、自愈策略以及同步选项。

4.3.1 同步策略核心参数

4.3.2 三种典型同步策略配置

# 策略一：完全自动化（生产推荐）
syncPolicy:
  automated:
    prune: true
    selfHeal: true
  syncOptions:
    - CreateNamespace=true
    - ApplyOutOfSyncOnly=true
    - PruneLast=true

# 策略二：仅自动同步，不修剪（安全模式）
syncPolicy:
  automated:
    prune: false
    selfHeal: false

# 策略三：手动同步 + 重试机制
syncPolicy:
  retry:
    limit: 5
    backoff:
      duration: 10s
      factor: 2
      maxDuration: 5m

4.4 三大字段协同工作示例

以下是一个完整的 Application 清单，展示了 Source、Destination 和 Sync Policy 如何协同工作，实现生产级 GitOps 部署：

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: production-app
  namespace: argocd
spec:
  project: production

  # Source 定义：从 Git 仓库拉取 Helm Chart
  source:
    repoURL: 'https://github.com/example/helm-charts.git'
    targetRevision: main
    path: charts/web-app
    helm:
      valueFiles:
        - values-production.yaml
      parameters:
        - name: replicaCount
          value: '5'

  # Destination 定义：部署到生产集群
  destination:
    server: 'https://kubernetes.default.svc'
    namespace: production

  # Sync Policy 定义：全自动化 + 安全选项
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
      allowEmpty: false
    syncOptions:
      - CreateNamespace=true
      - ApplyOutOfSyncOnly=true
      - PruneLast=true
      - Validate=true
    retry:
      limit: 3
      backoff:
        duration: 5s
        factor: 2
        maxDuration: 2m

4.5 常见问题与避坑指南