4. ArgoCD 架构与核心组件：API Server、Repo Server、Application Controller、Redis

ArgoCD 作为 GitOps 实践的核心引擎，采用微服务架构设计，由四个核心组件协同工作。理解这些组件的职责与交互方式，是构建可靠 GitOps 流水线的基础。本章将深入剖析每个组件的功能、通信机制以及它们在 Kubernetes 调度优化中的角色。

4.1 整体架构概览

ArgoCD 的架构遵循“控制平面”模式，所有组件均以 Kubernetes Pod 形式运行在集群中。下图展示了四个核心组件之间的数据流与依赖关系：

4.2 核心组件详解

4.2.1 API Server

API Server 是 ArgoCD 的“前门”，负责处理所有外部请求。它同时暴露 gRPC 和 REST API，支持 Web UI、CLI 以及 CI/CD 系统的集成。

4.2.2 Repo Server

Repo Server 是 ArgoCD 的“Git 引擎”，负责与 Git 仓库交互。它不直接对外暴露服务，而是通过 gRPC 被 API Server 和 Application Controller 调用。

• 仓库克隆与更新： 支持 SSH、HTTPS 认证，自动拉取最新代码；通过 git fetch 增量更新，避免全量克隆。
• Manifest 生成： 将 Helm Chart、Kustomize 配置、Jsonnet 模板等渲染为纯 Kubernetes YAML 清单。
• 缓存管理： 将生成的 Manifest 和 Git 元数据写入 Redis，减少重复计算。
• 安全隔离： 每个仓库连接在独立的 gRPC 流中处理，支持仓库级别的加密凭证存储。

# Repo Server 典型配置示例（argocd-cm ConfigMap 片段）
data:
  repositories: |
    - url: https://github.com/example/gitops-repo.git
      type: git
      passwordSecret:
        name: repo-credentials
        key: password
      insecure: false
      enableLfs: true  # 启用 Git LFS 支持

4.2.3 Application Controller

Application Controller 是 ArgoCD 的“大脑”，负责维持集群状态与 Git 仓库状态的一致性。它运行一个持续的状态循环，是 GitOps 自动化的核心执行者。

Application Controller 的关键特性包括：

• 多集群管理： 通过 cluster-secret 管理多个目标集群的 kubeconfig，支持跨集群同步。
• 资源钩子： 支持 PreSync、Sync、PostSync、SyncFail 等阶段的资源钩子，用于执行数据库迁移、预热缓存等操作。
• 自愈能力： 当集群状态被手动修改时，Controller 会自动检测偏差并触发同步（需启用 selfHeal 选项）。
• 调度优化： 支持 syncPolicy 中的 retry 和 backoff 策略，避免频繁同步导致集群 API Server 过载。

4.2.4 Redis

Redis 在 ArgoCD 中扮演“缓存与消息枢纽”的角色，虽然不直接参与 GitOps 逻辑，但却是保障性能的关键组件。

4.3 组件间通信与安全

ArgoCD 组件之间的通信采用严格的 TLS 加密和 RBAC 隔离：

• API Server ↔ Repo Server： 使用 mTLS 双向认证，Repo Server 只接受来自 API Server 的 gRPC 请求。
• Application Controller ↔ Repo Server： 同样使用 mTLS，Controller 通过 Repo Server 获取渲染后的 Manifest。
• 所有组件 ↔ Redis： 支持 Redis AUTH 密码认证，建议启用 TLS 加密传输。
• API Server 对外暴露： 通过 Ingress 或 LoadBalancer 暴露，支持 OIDC 代理和 Webhook 接收。

# 组件间 TLS 配置示例（argocd-secret）
data:
  server.secretkey: "your-256-bit-secret"  # API Server 签名密钥
  tls.crt: "base64-encoded-cert"
  tls.key: "base64-encoded-key"
  redis.password: "your-redis-password"

4.4 组件资源规划参考

根据生产环境经验，以下为中等规模集群（管理 200-500 个 Application）的组件资源建议：