3. Argo CD 核心概念：Application、Project、Repository、Sync Policy、Sync Status、Health Status 详解

在深入资源配额校准与性能调优之前，必须透彻理解 Argo CD 的六大核心概念。这些概念构成了 GitOps 工作流的骨架，也是后续配置 Envoy 流量治理与资源限制的基础。本章将逐一拆解每个概念的定义、作用域、配置方式及常见陷阱。

3.1 Application（应用）

Application 是 Argo CD 中最核心的 CRD（Custom Resource Definition），它定义了一个部署单元：从哪个 Git 仓库拉取清单、部署到哪个目标集群/命名空间、以及如何同步。每个 Application 实例代表一条从“声明式期望状态”到“运行时实际状态”的持续交付管道。

3.2 Project（项目）

Project 是 Argo CD 中逻辑隔离与权限控制的单元。它定义了哪些用户/角色可以访问哪些 Application、允许部署到哪些目标集群/命名空间、以及允许从哪些 Git 仓库拉取清单。Project 是 RBAC 与资源配额管理的边界。

• 源白名单（sourceRepos）：限制 Application 只能引用指定的 Git 仓库。
• 目标白名单（destinations）：限制 Application 只能部署到指定的集群和命名空间。
• 集群资源黑名单（clusterResourceBlacklist）：禁止 Application 创建集群级别的资源（如 ClusterRole、PersistentVolume）。
• 命名空间资源黑名单（namespaceResourceBlacklist）：禁止创建特定命名空间资源类型。

3.3 Repository（仓库）

Repository 是 Argo CD 连接 Git 仓库的凭证与配置对象。它存储仓库 URL、认证方式（SSH 密钥、HTTPS 用户名密码、GitHub App 等）、以及连接状态。Argo CD 通过 Repository 对象来拉取 Application 中定义的 source 内容。

3.4 Sync Policy（同步策略）

Sync Policy 决定了 Argo CD 如何将 Git 中的期望状态应用到目标集群。它分为手动同步和自动同步两大类，自动同步下可进一步配置自愈（Self-Heal）和允许删除资源（Prune）。

• 手动同步（Manual）：默认策略。需要人工点击“Sync”按钮或调用 API 触发同步。适用于变更审批流程严格的环境。
• 自动同步（Automated）：Argo CD 定期检测 Git 与集群的差异，自动执行同步。
  • prune: true：允许删除集群中不再存在于 Git 中的资源。
  • selfHeal: true：当集群资源被手动修改（配置漂移）时，自动回滚到 Git 中的状态。
• 同步选项（Sync Options）：如 Validate=false（跳过服务端校验）、PruneLast=true（先创建新资源再删除旧资源）、ApplyOutOfSyncOnly=true（仅同步不同步的资源）。

3.5 Sync Status（同步状态）

Sync Status 表示 Application 的期望状态与实际状态的一致性。Argo CD 通过对比 Git 中的清单与集群中运行的资源来判定状态。状态变化是触发同步策略的依据。

3.6 Health Status（健康状态）

Health Status 评估 Application 管理的资源是否正常运行。Argo CD 内置了针对常见 Kubernetes 资源（Deployment、StatefulSet、Service、Ingress 等）的健康检查逻辑，也支持通过 Lua 脚本自定义健康检查。

3.7 核心概念关系图

下图展示了 Application、Project、Repository 以及 Sync/Health 状态之间的逻辑关系，帮助理解 Argo CD 的配置流与状态流。

3.8 状态流转与典型场景

理解 Sync Status 与 Health Status 的组合，是 SRE 日常排障的核心技能。下表列出常见状态组合及对应的运维动作。

3.9 多集群与多仓库场景下的概念映射

在企业级部署中，一个 Argo CD 实例通常管理多个集群和多个 Git 仓库。下图展示了多集群场景下 Application、Project、Repository 的映射关系。

3.10 实战：Application 完整 YAML 示例

以下是一个生产级 Application 配置，集成了自动同步、自愈、Prune 以及自定义健康检查（通过 Lua 脚本）。

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: production-frontend
  namespace: argocd
spec:
  project: production
  source:
    repoURL: 'https://github.com/company/frontend-config.git'
    targetRevision: main
    path: k8s/overlays/prod
    helm:
      valueFiles:
        - values-prod.yaml
  destination:
    server: 'https://kubernetes.default.svc'
    namespace: frontend-prod
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - ApplyOutOfSyncOnly=true
      - PruneLast=true
      - Validate=false
  ignoreDifferences:
    - group: apps
      kind: Deployment
      jsonPointers:
        - /spec/replicas
  health:
    lua: |
      hs = {}
      if obj.status ~= nil and obj.status.availableReplicas ~= nil then
        if obj.status.availableReplicas >= obj.spec.replicas then
          hs.status = "Healthy"
          hs.message = "All replicas are available"
        else
          hs.status = "Degraded"
          hs.message = "Not enough replicas"
        end
      else
        hs.status = "Progressing"
        hs.message = "Waiting for status"
      end
      return hs