## 前言

上一篇跑通了第一个应用部署，但 ArgoCD 背后发生了什么？Application、Project、Repo Server 这些概念分别是什么？本篇深入 ArgoCD 的核心概念和架构原理，帮你从"会用"升级到"理解"。

---

## 一、ArgoCD 架构总览

```
┌──────────────────────────────────────────────────────────────┐
│                        ArgoCD 架构                            │
│                                                              │
│  ┌─────────────┐  ┌──────────────┐  ┌───────────────────┐   │
│  │ API Server  │  │ Repo Server  │  │ Application       │   │
│  │ (认证/UI)   │  │ (Git操作)    │  │ Controller        │   │
│  │ 端口: 8080  │  │ 端口: 8081   │  │ (协调循环)         │   │
│  └──────┬──────┘  └──────┬───────┘  └────────┬──────────┘   │
│         │                │                    │              │
│  ┌──────┴──────┐  ┌──────┴───────┐  ┌────────┴──────────┐   │
│  │ Dex Server  │  │ Redis Cache  │  │ ApplicationSet     │   │
│  │ (SSO/OIDC)  │  │ (状态缓存)    │  │ Controller          │   │
│  └─────────────┘  └──────────────┘  └────────────────────┘   │
│                                                              │
│  ┌──────────────────────────────────────────────────────┐   │
│  │                    Notifications                     │   │
│  │  (Slack/钉钉/企微/Email/Webhook)                       │   │
│  └──────────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────┘
        ↓ 管理
┌──────────────────────────────────────────────────────────────┐
│                    K8s 集群                                   │
│  Application 1    Application 2    Application 3            │
│  (dev namespace)  (test namespace)  (prod namespace)        │
└──────────────────────────────────────────────────────────────┘
```

### 各组件职责

| 组件 | 职责 | 端口 |
|------|------|------|
| API Server | 对外接口（gRPC/REST），UI 后端，认证授权 | 8080 |
| Repo Server | 克隆 Git 仓库，生成 manifests（Helm/Kustomize 渲染） | 8081 |
| Application Controller | 协调循环：比较 Git 和集群状态，执行同步 | - |
| ApplicationSet Controller | 批量生成 Application（多集群/多环境） | - |
| Redis | 缓存 Git 仓库内容和应用状态 | 6379 |
| Dex Server | SSO/OIDC 认证（对接 LDAP/Google/GitHub） | 5556 |

---

## 二、Application：最核心的资源

### Application CRD 结构

```yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: myapp-prod          # Application 名称
  namespace: argocd          # 必须在 argocd 命名空间
  finalizers:
    - resources-finalizer.argocd.argoproj.io  # 删除时清理关联资源
spec:
  # === 源配置（从哪里读配置）===
  source:
    repoURL: https://github.com/myorg/myapp-deploy.git
    targetRevision: main     # 跟踪哪个分支/Tag
    path: overlays/prod       # 仓库中的路径
    
    # 如果用 Helm
    # chart: myapp           # Chart 名称
    # helm:
    #   values: |
    #     replicas: 3
    #     image:
    #       tag: v2.0.0
    
    # 如果用 Kustomize（自动检测，不需要额外配置）
    # 只要路径下有 kustomization.yaml 即可
  
  # === 目标配置（部署到哪里）===
  destination:
    server: https://kubernetes.default.svc  # 本集群
    # server: https://prod-cluster:6443     # 外部集群
    namespace: myapp-prod                   # 目标命名空间
  
  # === 同步策略 ===
  syncPolicy:
    automated:
      prune: true             # 自动删除 Git 中不存在的资源
      selfHeal: true          # 自动修复漂移
    syncOptions:
      - CreateNamespace=true  # 自动创建命名空间
      - PrunePropagationPolicy=foreground  # 删除策略
    
    # 资源钩子
    # syncHooks 在同步前后执行
    retry:
      limit: 3                # 失败重试3次
      backoff:
        duration: 5s          # 初始等待
        factor: 2             # 退避因子
        maxDuration: 30s      # 最大等待
  
  # === 健康检查 ===
  # ArgoCD 内置了常见资源的健康检查逻辑
  # 可以自定义
  
  # === 忽略资源差异 ===
  ignoreDifferences:
    - group: apps
      kind: Deployment
      jsonPointers:
        - /spec/replicas     # 忽略副本数差异（HPA 自动调整时有用）
  
  # === 同步约束 ===
  # 同步前等待某些资源就绪
  # syncConstraints:
```

### Application 状态说明

```bash
argocd app get myapp-prod
# 输出示例:
# Name:               myapp-prod
# Project:            default
# Server:             https://kubernetes.default.svc
# Namespace:          myapp-prod
# URL:                https://argocd.mycompany.com/applications/myapp-prod
# Repo:               https://github.com/myorg/myapp-deploy.git
# Target:             main
# Path:               overlays/prod
# SyncWindow:         Sync Allowed
# Sync Policy:        Automated (Prune, Self-Heal)
# Sync Status:        Synced (OK)
# Health Status:      Healthy
```

| 状态 | 含义 |
|------|------|
| Sync Status: Synced | 集群状态与 Git 仓库一致 |
| Sync Status: OutOfSync | 有差异，等待同步 |
| Sync Status: Syncing | 正在同步中 |
| Health Status: Healthy | 所有资源健康 |
| Health Status: Progressing | 正在滚动更新 |
| Health Status: Degraded | 有资源不健康 |
| Health Status: Suspended | 资源被暂停 |

---

## 三、Project：多租户隔离

### Project 的作用

```
Project 用于:
  1. 限制 Application 可以部署到哪里（集群+命名空间）
  2. 限制可以使用的 Git 仓库
  3. 限制可以部署的资源类型
  4. RBAC 权限控制
  5. 环境隔离（开发组只能部署到 dev 命名空间）
```

### 创建 Project

```yaml
apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
  name: team-alpha
  namespace: argocd
spec:
  # 允许的源仓库
  sourceRepos:
    - https://github.com/myorg/*
    - https://github.com/partner/*
  
  # 允许的目标集群和命名空间
  destinations:
    - server: https://kubernetes.default.svc
      namespace: team-alpha-*    # 通配符匹配
  
  # 允许部署的资源类型
  clusterResourceWhitelist:
    - group: ''
      kind: Namespace
    - group: ''
      kind: PersistentVolume
  
  namespaceResourceWhitelist:
    - group: '*'
      kind: '*'
  
  # 禁止的资源类型
  namespaceResourceBlacklist:
    - group: ''
      kind: ResourceQuota      # 禁止创建 ResourceQuota
    - group: ''
      kind: LimitRange
  
  # 角色定义（用于 RBAC）
  roles:
    - name: developer
      description: Team Alpha developers
      policies:
        - p, proj:team-alpha:developer, applications, *, team-alpha/*, allow
      groups:
        - myorg:team-alpha-developers   # 对接 SSO Group
  
  # 同步窗口（限制部署时间）
  syncWindows:
    - kind: allow
      schedule: '* * * * 0-4,6'    # 周日-周四+周六允许
      duration: 24h
      applications:
        - '*'
      manualSync: true              # 允许手动同步
```

### Project RBAC

```bash
 # argocd-rbac-cm ConfigMap
apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-rbac-cm
  namespace: argocd
data:
  policy.default: ""     # 默认拒绝
  policy.csv: |
    # 全局管理员
    p, role:admin, applications, *, */*, allow
    
    # team-alpha 的开发者可以管理自己的应用
    p, proj:team-alpha:developer, applications, *, team-alpha/*, allow
    
    # 只读用户
    p, role:viewer, applications, get, */*, allow
    p, role:viewer, clusters, get, *, allow
    p, role:viewer, repositories, get, *, allow
```

> **培训要点**：Project 是 ArgoCD 多租户的核心。没有 Project，所有人都能部署到任何地方——这在生产环境中是不可接受的。每个团队至少有一个 Project，限制其可操作范围。

---

## 四、Repo Server：Git 操作引擎

### 工作原理

```
Application Controller 说: "我需要 myapp-deploy 仓库 main 分支的 overlays/prod 路径下的 manifests"
        ↓
Repo Server:
  1. 检查 Redis 缓存 → 有缓存？直接返回
  2. 没缓存 → 克隆/拉取 Git 仓库
  3. 如果是 Helm → 运行 helm template
  4. 如果是 Kustomize → 运行 kustomize build
  5. 渲染出完整的 K8s manifests
  6. 缓存到 Redis
  7. 返回给 Application Controller
        ↓
Application Controller:
  1. 拿到 Git 中的期望状态（manifests）
  2. 从集群中读取实际状态
  3. 比较差异
  4. 如有差异，执行同步
```

### Repo Server 配置

```yaml
# 修改 ArgoCD ConfigMap 增加 Repo Server 配置
apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cmd-params-cm
  namespace: argocd
data:
  # Git 仓库轮询间隔（默认3分钟）
  repo.server.timeout: "60s"
  
  # 并发克隆数
  reposerver.parallelism.limit: "10"
```

### 私有仓库的已知主机配置

```yaml
# 对于 SSH 方式连接的仓库，需要配置 known_hosts
apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-ssh-known-hosts-cm
  namespace: argocd
data:
  ssh_known_hosts: |
    github.com ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI...
    gitlab.com ssh-rsa AAAAB3NzaC1yc2EAAA...
```

---

## 五、ApplicationSet：批量应用管理

### 为什么需要 ApplicationSet

```
传统方式（每个应用一个 Application）:
  Application: myapp-dev
  Application: myapp-test
  Application: myapp-staging
  Application: myapp-prod
  → 4个 Application，大量重复配置

ApplicationSet 方式（一个模板生成多个 Application）:
  ApplicationSet 模板:
    生成 4 个 Application: myapp-{dev,test,staging,prod}
    每个用不同的路径和命名空间
```

### ApplicationSet 示例

```yaml
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: myapp-multi-env
  namespace: argocd
spec:
  generators:
    # 列表生成器：为每个环境生成一个 Application
    - list:
        elements:
          - env: dev
            namespace: myapp-dev
            path: overlays/dev
          - env: test
            namespace: myapp-test
            path: overlays/test
          - env: staging
            namespace: myapp-staging
            path: overlays/staging
          - env: prod
            namespace: myapp-prod
            path: overlays/prod
  
  template:
    metadata:
      name: 'myapp-{{env}}'
    spec:
      project: default
      source:
        repoURL: https://github.com/myorg/myapp-deploy.git
        targetRevision: main
        path: '{{path}}'
      destination:
        server: https://kubernetes.default.svc
        namespace: '{{namespace}}'
      syncPolicy:
        automated:
          prune: true
          selfHeal: true
        syncOptions:
          - CreateNamespace=true
```

### Git 目录生成器

```yaml
spec:
  generators:
    # 自动扫描 Git 仓库中的目录，每个目录生成一个 Application
    - git:
        repoURL: https://github.com/myorg/monorepo-deploy.git
        revision: main
        directories:
          - path: apps/*
            # 会匹配 apps/service-a, apps/service-b 等
```

---

## 六、本篇要点回顾

1. ArgoCD 架构：API Server（认证UI）+ Repo Server（Git操作）+ Application Controller（协调）+ Redis（缓存）
2. Application 是核心 CRD：source（Git）→ destination（集群）→ syncPolicy（策略）
3. Sync Status（同步状态）和 Health Status（健康状态）是两个独立维度
4. AppProject 实现多租户：限制仓库、命名空间、资源类型、RBAC
5. ApplicationSet 批量生成 Application：列表生成器和 Git 目录生成器

**下一篇预告**：《应用管理：App-of-Apps 模式与多集群部署》——从单个应用扩展到多应用、多集群管理。

上一篇跑通了第一个应用部署，但 ArgoCD 背后发生了什么？Application、Project、Repo Server 这些概念分别是什么？本篇深入 ArgoCD 的核心概念和架构原理，帮你从"会用"升级到"理解"。

【GitOps·ArgoCD篇】核心概念：Application、Project与Repo Server详解

研发部经理

开发工具

运维

云计算

ArgoCD核心架构解析：API Server、RepoServer、Application Controller三组件协同工作，通过Application CRD实现Git到K8s的持续部署。深入讲解SyncStatus与HealthStatus双维度状态机制，AppProject多租户隔离策略，以及ApplicationSet批量管理多环境应用，帮助理解GitOps实践原理。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

ArgoCD核心架构解析：API Server、RepoServer、Application Controller三组件协同工作，通过Application CRD实现Git到K8s的持续部署。深入讲解SyncStatus与HealthStatus双维度状态机制，AppProject多租户隔离策略，以及Applicat...

【GitOps·ArgoCD篇】核心概念：Application、Project与Repo Server详解-腾讯云开发者社区-腾讯云

【GitOps·ArgoCD篇】核心概念：Application、Project与Repo Server详解

【GitOps·ArgoCD篇】核心概念：Application、Project与Repo Server详解

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐