2. Argo CD 核心概念回顾：Application、Project、Repository、Sync Policy、Health Status

在深入自助目录可靠性评审之前，必须统一团队对 Argo CD 核心概念的理解。本章将围绕五个关键抽象——Application、Project、Repository、Sync Policy 和 Health Status——展开，为后续的评审规则与自动化策略奠定基础。

2.1 核心概念关系总览

下图展示了 Argo CD 中五个核心概念之间的逻辑关系与数据流向：

2.2 Application（应用）

Application 是 Argo CD 中最核心的部署单元，它定义了一个 Kubernetes 资源集合的期望状态。每个 Application 包含以下关键字段：

2.3 Project（项目）

Project 是 Argo CD 中的逻辑分组与安全边界。它控制哪些用户可以访问哪些 Application、哪些目标集群和命名空间可用、以及允许从哪些仓库拉取配置。

Project 的核心配置项：

• sourceRepos：允许引用的 Git 仓库列表（白名单）
• destinations：允许部署的目标集群与命名空间
• roles：RBAC 角色与权限绑定
• orphanedResources：是否监控并告警孤儿资源
• namespaceResourceBlacklist/Whitelist：资源类型过滤

2.4 Repository（仓库）

Repository 是 Argo CD 连接 Git 仓库的凭证与配置对象。它支持公开仓库和私有仓库（通过 SSH 密钥、HTTPS 用户名密码或 GitHub App 认证）。

Repository 的常见配置方式：

apiVersion: v1
kind: Secret
metadata:
  name: repo-github-team-a
  namespace: argocd
  labels:
    argocd.argoproj.io/secret-type: repository
stringData:
  type: git
  url: https://github.com/team-a/gitops-config
  username: gitops-bot
  password: <personal-access->

2.5 Sync Policy（同步策略）

Sync Policy 决定了 Argo CD 如何将 Git 中的期望状态同步到目标集群。它分为两个层级：

2.6 Health Status（健康状态）

Argo CD 通过内置的健康检查机制评估每个资源及整个 Application 的运行状态。健康状态分为以下等级：

• Healthy：资源运行正常，符合预期
• Progressing：正在部署或更新中
• Degraded：部分资源异常，但未完全崩溃
• Suspended：资源被暂停（如 HPA 缩容到 0）
• Missing：资源在集群中不存在
• Unknown：无法获取健康信息

Argo CD 为 Kubernetes 内置资源（Deployment、Service、Ingress 等）提供了默认的健康检查逻辑，同时也支持通过 Lua 脚本自定义健康检查。

# 自定义健康检查示例：检查 Deployment 的可用副本数
health.lua = |
  hs = {}
  if obj.status.availableReplicas < obj.spec.replicas then
    hs.status = "Degraded"
    hs.message = "Available replicas less than desired"
  else
    hs.status = "Healthy"
  end
  return hs

2.7 概念对比速查表