## 前言

单个应用部署只是起步。本篇解决两个规模化问题：如何管理几十上百个应用（App-of-Apps），以及如何用一个 ArgoCD 管理多个 K8s 集群。

---

## 一、App-of-Apps 模式

### 解决什么问题

```
当有50个应用时:
  → 要创建50个 Application CRD
  → 手动管理太累
  → 能不能用一个 Application 管理其他 Application？

App-of-Apps:
  → 一个父 Application 管理多个子 Application
  → Git 仓库中维护所有 Application 的定义
  → 父 Application 同步后，子 Application 自动创建
```

### 仓库结构

```
deploy-repo/
├── apps/                      # App-of-Apps 入口
│   └── app-of-apps.yaml       # 父 Application 定义
├── applications/               # 各应用的 Application 定义
│   ├── myapp.yaml
│   ├── user-service.yaml
│   ├── order-service.yaml
│   └── payment-service.yaml
└── services/                   # 实际部署清单
    ├── myapp/
    ├── user-service/
    ├── order-service/
    └── payment-service/
```

### 父 Application（App-of-Apps）

```yaml
# apps/app-of-apps.yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: app-of-apps
  namespace: argocd
spec:
  source:
    repoURL: https://github.com/myorg/deploy-repo.git
    targetRevision: main
    path: applications        # 这个目录下有多个 Application YAML
  destination:
    server: https://kubernetes.default.svc
    namespace: argocd          # 子 Application 也部署在 argocd 命名空间
  syncPolicy:
    automated:
      prune: true              # Git 中删掉某个 Application，集群中也删掉
      selfHeal: true
```

### 子 Application 示例

```yaml
# applications/myapp.yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: myapp
  namespace: argocd
spec:
  project: team-alpha
  source:
    repoURL: https://github.com/myorg/deploy-repo.git
    targetRevision: main
    path: services/myapp/overlays/prod
  destination:
    server: https://kubernetes.default.svc
    namespace: myapp-prod
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
```

### 工作流程

```
1. 在 Git 仓库 applications/ 目录下新增 application.yaml
2. git push
3. ArgoCD 检测到 app-of-apps（父 Application）有变化
4. 同步：在 argocd 命名空间创建新的 Application CRD
5. 新 Application 自动开始管理对应服务
6. 子 Application 从 services/ 目录读取部署清单
7. 同步到对应命名空间

整个流程完全自动化，无需手动创建 Application
```

> **培训要点**：App-of-Apps 是 ArgoCD 管理大规模应用的经典模式。但也有缺点——层级嵌套后调试复杂。新版本推荐用 ApplicationSet 替代 App-of-Apps。

---

## 二、ApplicationSet 替代 App-of-Apps

### Git 目录生成器

```yaml
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: all-services
  namespace: argocd
spec:
  generators:
    - git:
        repoURL: https://github.com/myorg/deploy-repo.git
        revision: main
        directories:
          - path: services/*
            # 自动扫描 services/ 下的所有子目录
            # 每个子目录生成一个 Application
  template:
    metadata:
      name: '{{path.basename}}'    # 用目录名作为 Application 名
    spec:
      project: default
      source:
        repoURL: https://github.com/myorg/deploy-repo.git
        targetRevision: main
        path: '{{path}}'           # 用目录路径作为 source path
      destination:
        server: https://kubernetes.default.svc
        namespace: '{{path.basename}}'
      syncPolicy:
        automated:
          prune: true
          selfHeal: true
        syncOptions:
          - CreateNamespace=true
```

### 集群生成器（多集群）

```yaml
spec:
  generators:
    - clusters:
        selector:
          matchLabels:
            env: production    # 只选择标记为 production 的集群
  template:
    metadata:
      name: '{{name}}-myapp'   # 用集群名作为前缀
    spec:
      source:
        repoURL: https://github.com/myorg/deploy-repo.git
        path: overlays/prod
      destination:
        server: '{{server}}'   # 部署到匹配的集群
        namespace: myapp-prod
```

---

## 三、多集群部署

### 注册外部集群

```bash
# 方式1：用 ArgoCD CLI 注册
argocd cluster add prod-cluster \
  --server prod-cluster.mycompany.com:6443 \
  --name prod-cluster \
  --label env=production \
  --label region=cn-north

# 方式2：手动配置
argocd cluster add https://prod-cluster:6443 \
  --name prod-cluster \
  --service-account argocd-manager \
  --upsert
```

### 集群标签管理

```bash
# 给集群打标签（用于 ApplicationSet 选择器）
argocd cluster set prod-cluster \
  --label env=production \
  --label region=cn-north \
  --label tier=critical

# 查看所有集群
argocd cluster list
# SERVER                          NAME         LABELS
# https://k8s-api:6443            in-cluster   env=local
# https://prod-cluster:6443       prod-cluster env=production,region=cn-north
# https://dr-cluster:6443          dr-cluster   env=dr,region=cn-south
```

### Application 部署到外部集群

```yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: myapp-prod
  namespace: argocd
spec:
  source:
    repoURL: https://github.com/myorg/deploy-repo.git
    path: overlays/prod
  destination:
    server: https://prod-cluster:6443  # 外部集群地址
    # 或用集群名
    # name: prod-cluster
    namespace: myapp-prod
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
```

### 多集群 ApplicationSet

```yaml
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: myapp-multi-cluster
  namespace: argocd
spec:
  generators:
    # 矩阵生成器：环境 × 集群
    - matrix:
        generators:
          # 环境列表
          - list:
              elements:
                - env: dev
                  path: overlays/dev
                - env: staging
                  path: overlays/staging
                - env: prod
                  path: overlays/prod
          # 集群列表
          - clusters:
              selector:
                matchLabels:
                  argocd.argoproj.io/secret-type: cluster
  template:
    metadata:
      name: 'myapp-{{env}}-{{name}}'
    spec:
      project: default
      source:
        repoURL: https://github.com/myorg/deploy-repo.git
        path: '{{path}}'
      destination:
        server: '{{server}}'
        namespace: 'myapp-{{env}}'
      syncPolicy:
        automated:
          prune: true
          selfHeal: true
```

> **培训要点**：矩阵生成器（matrix）可以组合两个维度——环境 × 集群。3个环境 × 3个集群 = 9个 Application 自动生成。新增环境或集群时只需在列表中加一行。

---

## 四、环境隔离策略

### 策略一：分支对应环境

```
Git 仓库分支策略:
  main     → 生产环境
  staging  → 预发环境
  develop  → 测试环境

Application 配置:
  myapp-dev:
    targetRevision: develop
    path: overlays/dev
  
  myapp-staging:
    targetRevision: staging
    path: overlays/staging
  
  myapp-prod:
    targetRevision: main
    path: overlays/prod
```

### 策略二：目录对应环境（推荐）

```
Git 仓库目录策略:
  main 分支:
    overlays/
      dev/
        kustomization.yaml
        patch.yaml
      staging/
        kustomization.yaml
        patch.yaml
      prod/
        kustomization.yaml
        patch.yaml

Application 配置:
  myapp-dev:
    targetRevision: main
    path: overlays/dev
  → 所有环境在同一分支，用目录区分
```

> **踩坑提示**：目录策略比分支策略更好——因为所有环境配置在同一分支中，可以一次性看到所有环境的差异，PR 审查更方便。分支策略容易遗漏某个环境的更新。

### 策略三：仓库分离

```
仓库分离策略:
  deploy-dev/     → 测试环境专用仓库
  deploy-prod/    → 生产环境专用仓库
  
  好处: 仓库权限隔离，开发团队只能改 dev 仓库
  坏处: 多仓库维护成本高
```

---

## 五、大规模应用管理的最佳实践

### 1. 用 ApplicationSet 替代手动创建

```
不要：
  手动创建 50 个 Application YAML 文件

要：
  用 ApplicationSet + Git 目录生成器，一个模板自动扫描生成
```

### 2. 用 Kustomize 管理环境差异

```
services/myapp/
├── base/                 # 所有环境共享的配置
│   ├── deployment.yaml
│   ├── service.yaml
│   └── kustomization.yaml
└── overlays/
    ├── dev/
    │   ├── kustomization.yaml
    │   └── patch.yaml     # dev 专用覆盖
    ├── staging/
    │   ├── kustomization.yaml
    │   └── patch.yaml
    └── prod/
        ├── kustomization.yaml
        └── patch.yaml
```

### 3. 用 Project 做权限隔离

```
AppProject:
  team-alpha → 只能部署到 team-alpha-* 命名空间
  team-beta  → 只能部署到 team-beta-* 命名空间
  platform   → 可部署到 kube-system 和基础设施命名空间
```

### 4. 合理设置同步窗口

```yaml
# AppProject 中的同步窗口
syncWindows:
  - kind: allow
    schedule: '0 9 * * 1-5'    # 工作日9点允许
    duration: 12h              # 持续12小时
    applications:
      - 'myapp-prod'          # 只限制生产应用
    manualSync: true           # 允许手动同步（紧急情况）
```

---

## 六、本篇要点回顾

1. App-of-Apps：一个父 Application 管理多个子 Application，适合旧版本
2. ApplicationSet：用生成器自动创建 Application，替代 App-of-Apps
3. Git 目录生成器：自动扫描 Git 目录，每个目录生成一个 Application
4. 多集群：用 `argocd cluster add` 注册外部集群，用标签选择器匹配
5. 矩阵生成器：环境 × 集群，N × M = N*M 个 Application 自动生成
6. 环境隔离：目录策略 > 分支策略 > 仓库分离

**下一篇预告**：《同步策略：自动同步、手动同步与同步钩子》——深入 ArgoCD 的同步机制，学习如何精确控制何时同步、如何同步。

单个应用部署只是起步。本篇解决两个规模化问题：如何管理几十上百个应用（App-of-Apps），以及如何用一个 ArgoCD 管理多个 K8s 集群。

【GitOps·ArgoCD篇】应用管理：App-of-Apps 模式与多集群部署

研发部经理

云计算

运维

开发工具

本内容解析ArgoCD规模化应用管理，涵盖App-of-Apps模式、ApplicationSet替代方案及多集群部署。重点介绍Git目录生成器自动扫描服务目录、集群标签选择器实现跨环境部署，以及矩阵生成器组合环境×集群维度。同时对比分支、目录、仓库三种环境隔离策略，推荐目录策略。提供大规模应用管理最佳实践，包括Kustomize环境差异管理、Project权限隔离及同步窗口配置。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

本内容解析ArgoCD规模化应用管理，涵盖App-of-Apps模式、ApplicationSet替代方案及多集群部署。重点介绍Git目录生成器自动扫描服务目录、集群标签选择器实现跨环境部署，以及矩阵生成器组合环境×集群维度。同时对比分支、目录、仓库三种环境隔离策略，推荐目录策略。提供大规模应用管理最佳实践，包括Kus...

【GitOps·ArgoCD篇】应用管理：App-of-Apps 模式与多集群部署-腾讯云开发者社区-腾讯云

【GitOps·ArgoCD篇】应用管理：App-of-Apps 模式与多集群部署

【GitOps·ArgoCD篇】应用管理：App-of-Apps 模式与多集群部署

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐