多集群管理

Hub-Spoke 架构

ArgoCD 的多集群管理采用 Hub-Spoke（中心辐射）架构：ArgoCD 安装在一个专用的"管理集群"（Hub），向外辐射管理多个"工作集群"（Spoke）。Hub 集群不运行业务应用，只运行 ArgoCD 控制面。

Hub-Spoke 多集群架构

                    ┌──────────────────────────────┐
                    │      Hub 集群（管理面）       │
                    │                              │
                    │  ┌────────────────────────┐   │
                    │  │   ArgoCD Control Plane │   │
                    │  │   API Server           │   │
                    │  │   Repo Server          │   │
                    │  │   App Controller       │   │
                    │  └────────────────────────┘   │
                    └──────────────┬───────────────┘
             ┌───────────────┼───────────────┐
             ↓               ↓               ↓
┌────────────────┐  ┌────────────────┐  ┌────────────────┐
│   Dev 集群     │  │ Staging 集群  │  │  Prod 集群    │
│ 业务应用       │  │ 业务应用       │  │ 业务应用       │
│ (Spoke)        │  │ (Spoke)        │  │ (Spoke)        │
└────────────────┘  └────────────────┘  └────────────────┘

注册外部集群

方式一：argocd CLI（推荐）

# 确保 kubeconfig 中有目标集群的 context
kubectl config get-contexts

# 注册 dev 集群
argocd cluster add my-dev-cluster-context \
  --name dev-cluster \
  --label environment=dev \
  --label region=cn-hangzhou

# 注册 prod 集群
argocd cluster add my-prod-cluster-context \
  --name prod-cluster \
  --label environment=production \
  --label region=cn-hangzhou

# 查看所有已注册集群
argocd cluster list

SERVER                                    NAME          VERSION  STATUS
https://kubernetes.default.svc            in-cluster    1.29     Successful
https://dev-cluster.example.com:6443      dev-cluster   1.29     Successful
https://prod-cluster.example.com:6443     prod-cluster  1.30     Successful

注册过程发生了什么

argocd cluster add 执行时，会在目标集群中创建一个 ServiceAccount（argocd-manager），并绑定 ClusterAdmin 权限（或自定义权限），然后将该 ServiceAccount 的 token 存储到 Hub 集群的 Secret 中（argocd namespace），供 Application Controller 使用。

# ArgoCD 自动创建的集群凭证 Secret（自动管理，不需要手动创建）
apiVersion: v1
kind: Secret
metadata:
  name: prod-cluster-creds
  namespace: argocd
  labels:
    argocd.argoproj.io/secret-type: cluster   # 必须有此 label
    environment: production                  # 自定义标签（用于 Cluster Generator）
stringData:
  name: prod-cluster
  server: https://prod-cluster.example.com:6443
  config: |
    {
      "bearerToken": "<service-account-token>",
      "tlsClientConfig": {
        "caData": "<base64-ca-cert>"
      }
    }

集群标签选择器

给集群打标签后，ApplicationSet 的 Cluster Generator 可以按标签筛选目标集群：

# 只部署到生产集群
generators:
- clusters:
    selector:
      matchLabels:
        environment: production

# 部署到杭州区所有集群
generators:
- clusters:
    selector:
      matchLabels:
        region: cn-hangzhou

# 使用 matchExpressions 更灵活的筛选
generators:
- clusters:
    selector:
      matchExpressions:
      - key: environment
        operator: In
        values: [staging, production]

实战：两集群（dev/prod）统一管理

完整示例：用一个 ApplicationSet 同时管理 dev 和 prod 两个集群的应用部署，通过集群标签路由不同配置：

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: my-app-multi-cluster
  namespace: argocd
spec:
  goTemplate: true
  generators:
  - clusters:
      selector:
        matchExpressions:
        - key: environment
          operator: In
          values: [dev, production]
  template:
    metadata:
      name: 'my-app-{{.metadata.labels.environment}}'
    spec:
      project: default
      source:
        repoURL: https://github.com/my-org/config
        targetRevision: main
        path: 'apps/my-app/overlays/{{.metadata.labels.environment}}'
      destination:
        server: '{{.server}}'      # 集群 Server URL（由 Generator 注入）
        namespace: my-app
      syncPolicy:
        automated:
          prune: true
          selfHeal: true
        syncOptions:
        - CreateNamespace=true

灾备：主备集群自动切换

使用 ArgoCD + ApplicationSet 实现基本的主备灾备切换：