2. ArgoCD 架构深度解析：核心组件及其职责

ArgoCD 遵循 Kubernetes Operator + GitOps 控制器 模式，由三个核心组件构成：API Server、Repo Server 和 Application Controller。理解这三个组件的职责与协作关系，是进行集群排障、优化同步窗口以及设计 AppSet 查询策略的基础。

2.1 核心组件职责与交互流程

下图展示了 ArgoCD 三个核心组件之间的数据流与协作关系。当用户通过 CLI/UI 触发同步时，请求首先到达 API Server，随后由 Repo Server 拉取 Git 仓库中的期望清单，最终由 Application Controller 将清单应用到目标集群。

2.2 组件职责详解

2.3 组件间通信与数据流

三个组件通过 gRPC 和 Redis（可选）进行通信。在排障时，需要关注以下关键数据流路径：

1. 用户请求路径： CLI/UI → API Server（认证） → Repo Server（拉取 Git） → Application Controller（执行同步）
2. 状态监控路径： Application Controller → Kubernetes API（实时状态） → 与 Repo Server 提供的期望状态对比
3. 缓存刷新路径： Repo Server → Git 仓库（定时/Webhook 触发） → 更新本地缓存 → 通知 Application Controller

2.4 组件配置与排障关键参数

以下表格列出了每个组件在排障时最常调整的配置参数：

2.5 组件日志与监控

在排障过程中，快速定位组件日志是关键步骤。以下是各组件日志的获取方式与常见错误模式：

# 查看 API Server 日志（关注认证与 RBAC 错误）
kubectl logs -n argocd deployment/argocd-server --tail=100 | grep -E "error|denied|unauthorized"

# 查看 Repo Server 日志（关注 Git 拉取与渲染错误）
kubectl logs -n argocd deployment/argocd-repo-server --tail=100 | grep -E "failed to|timeout|cache miss"

# 查看 Application Controller 日志（关注同步差异与健康检查）
kubectl logs -n argocd deployment/argocd-application-controller --tail=100 | grep -E "sync failed|health degraded|comparison error"

2.6 组件高可用与扩展性

在生产环境中，ArgoCD 的三个核心组件均支持水平扩展。以下表格总结了各组件的高可用部署建议：