2. Argo CD 基础回顾：核心概念

在深入容量规划与多集群资源分配之前，必须牢固掌握 Argo CD 的四个核心抽象：Application、Project、Repository 和 Cluster。这四个概念构成了 Argo CD 声明式 GitOps 的基石，也是后续所有容量规划策略的操作对象。

2.1 核心概念总览

下表从定义、作用域、典型用途三个维度对比了四个核心概念，帮助你快速建立整体认知。

2.2 Application（应用）

Application 是 Argo CD 中最核心的资源对象。它定义了一个“从 Git 仓库的某个路径同步到目标集群的某个命名空间”的完整部署单元。每个 Application 包含三个关键部分：

• Source（来源）：指定 Git 仓库 URL、目标分支、路径以及配置管理工具（Helm、Kustomize、纯 YAML）。
• Destination（目标）：指定目标集群的 API Server URL 或集群名称，以及目标命名空间。
• Sync Policy（同步策略）：定义自动同步、自动修剪、自动自愈等行为。

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: payment-service
  namespace: argocd
spec:
  project: production
  source:
    repoURL: 'https://git.company.com/backend/payment.git'
    targetRevision: main
    path: deploy/overlays/production
  destination:
    server: 'https://kubernetes.default.svc'
    namespace: payment
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

2.3 Project（项目）

Project 是 Argo CD 中的租户隔离单元。它定义了哪些 Repository、Cluster 和 Namespace 可以被该 Project 下的 Application 使用。Project 还支持设置资源配额（Resource Quotas）和全局策略。

一个典型的 Project 配置包含以下约束：

• sourceRepos：允许引用的 Git 仓库列表。
• destinations：允许部署的目标集群和命名空间组合。
• clusterResourceWhitelist / Blacklist：允许或禁止的集群级资源类型。
• namespaceResourceWhitelist / Blacklist：允许或禁止的命名空间级资源类型。
• orphanedResources：是否监控并处理孤儿资源。

apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
  name: production
  namespace: argocd
spec:
  sourceRepos:
    - 'https://git.company.com/backend/*'
    - 'https://git.company.com/infra/*'
  destinations:
    - namespace: 'payment'
      server: 'https://kubernetes.default.svc'
    - namespace: 'inventory'
      server: 'https://prod-cluster-2.example.com'
  clusterResourceWhitelist:
    - group: ''
      kind: Namespace
  namespaceResourceBlacklist:
    - group: 'rbac.authorization.k8s.io'
      kind: RoleBinding

2.4 Repository（仓库）

Repository 是 Argo CD 连接 Git 仓库的凭证与配置对象。Argo CD 支持公开仓库和私有仓库（通过 SSH 密钥、HTTPS 用户名密码或 GitHub App 认证）。

Repository 的配置包括：

• URL：Git 仓库地址。
• 类型：git 或 helm。
• 认证信息：sshPrivateKey、password、tlsClientCertData 等。
• 代理设置：proxy、insecure 等。

apiVersion: v1
kind: Secret
metadata:
  name: repo-backend
  namespace: argocd
  labels:
    argocd.argoproj.io/secret-type: repository
stringData:
  type: git
  url: https://git.company.com/backend/payment.git
  username: git-robot
  password: ${GIT_}

2.5 Cluster（集群）

Cluster 对象定义了 Argo CD 可以管理的外部 Kubernetes 集群。Argo CD 通过 kubeconfig 或 Service Account 连接到目标集群，并在目标集群上安装一个 argocd-manager ServiceAccount 来执行部署操作。

Cluster 配置的关键字段：

• server：目标集群的 API Server URL。
• name：集群别名，用于在 Application 中引用。
• config：认证信息（bearerToken、tlsClientConfig 等）。
• namespaces：可选，限制 Argo CD 可以操作的命名空间列表。

apiVersion: v1
kind: Secret
metadata:
  name: cluster-prod-1
  namespace: argocd
  labels:
    argocd.argoproj.io/secret-type: cluster
stringData:
  name: prod-1
  server: https://prod-cluster-1.example.com:6443
  config: |
    {
      "bearerToken": "<service-account->",
      "tlsClientConfig": {
        "insecure": false,
        "caData": "<base64-ca-cert>"
      }
    }

2.6 核心概念关系图

下图展示了四个核心概念之间的逻辑关系与数据流向：

2.7 多集群部署中的概念映射

在容量规划驱动的多集群场景中，这四个概念会形成以下映射关系：