CI/CD / 系统课时
看懂 Application 的关键字段
看懂 Application 的关键字段
Argo CD 的 Application 不是一组零散参数,而是一份应用期望状态声明:从哪个 Git 仓库取什么版本、读取哪段配置、部署到哪个集群和命名空间,以及受哪个 Project 约束。看懂这些字段后,才能准确判断 Argo CD 会同步什么、同步到哪里。
学习目标
- 理解
source、destination、project在 Application 中分别承担什么职责 - 看懂
repoURL、path、targetRevision如何共同定位期望状态 - 能从一份 Application 清单判断 Argo CD 的配置来源和部署目标
Application 描述的三组关系
一份 Application 最核心的是三个问题:期望状态从哪里来、要部署到哪里、允许在什么边界内运行。spec.source 描述配置来源,spec.destination 描述部署目标,spec.project 把 Application 关联到 AppProject 的治理边界。

可以把它理解成一条声明链:Application 根据 repoURL 找到仓库,通过 targetRevision 选择 Git revision,再由 path 定位仓库中的应用目录;渲染出的资源随后被同步到 destination 指定的位置,同时整个操作必须符合 project 对来源和目标的约束。
从一份最小清单读字段
下面是一份使用 Git 目录作为配置来源的 Application。它假定 Argo CD 已经能够访问该仓库,并且仓库中的 apps/myapp 包含可被 Argo CD 识别的 Kubernetes 配置。
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: myapp
namespace: argocd
spec:
project: default
source:
repoURL: https://github.com/example/platform-config.git
targetRevision: main
path: apps/myapp
destination:
server: https://kubernetes.default.svc
namespace: myapp这是配置文件示例,不会产生固定控制台输出。应用该清单后,可通过 kubectl 验证 Application 是否已被 Kubernetes API 接受:
kubectl apply -f application.yaml
kubectl -n argocd get application myapp -o name预期输出
application.argoproj.io/myapp这只能证明 Application 对象已经创建,不代表应用已经同步成功或健康。同步状态还取决于仓库访问、清单渲染、Project 权限以及目标集群等条件。
source 如何定位期望状态
source 不是单独一个地址,而是一组共同确定输入的字段。repoURL 指向 Git 仓库;targetRevision 指定要跟踪的 revision,可以是分支、标签或提交;path 指向仓库内包含应用配置的目录。
例如 repoURL 不变而 targetRevision 从 main 改为某个发布分支,Argo CD 读取的版本就会改变;revision 不变而修改 path,则会读取仓库中的另一套配置。因此排查“为什么部署了错误内容”时,应把这三个字段放在一起检查。
当来源是 Helm Chart 时,source 还可以包含 Helm 相关配置,例如 Values 文件。此时 Git 中的 Chart、revision、路径与 Values 会共同决定最终渲染结果,但 source 的职责仍然没有改变:描述 Argo CD 应从哪里得到期望状态。
destination 决定资源去哪里
destination.server 指定目标 Kubernetes API Server,destination.namespace 指定目标命名空间。示例中的 https://kubernetes.default.svc 通常表示 Argo CD 所在的集群,也就是常见的集群内目标。
需要注意,Application 自身位于 argocd 命名空间,并不意味着业务资源也部署到 argocd。metadata.namespace 是 Application CR 所在位置,而 spec.destination.namespace 才描述业务资源的目标命名空间。混淆两者是阅读 Application 时很常见的错误。
目标命名空间是否能够自动创建还取决于同步配置;仅填写一个不存在的 destination.namespace,不能据此假定命名空间一定会被创建。
project 是治理边界
spec.project 引用 Argo CD 的 AppProject。Project 可以约束 Application 能使用哪些源仓库、部署到哪些目标集群和命名空间,以及允许管理哪些资源类型。因此它不是用于整理页面的普通分类标签。
当仓库地址和目标集群看起来都正确,但 Application 仍因权限策略无法使用某个 source 或 destination 时,应继续检查对应 AppProject 的规则。default Project 只是一个具体的 Project 名称,并不意味着可以忽略治理约束。
读一份 Application 时,可以始终沿着“source 定位期望状态 → destination 确定落点 → project 检查允许边界”的顺序检查。这样即使后续加入 Helm 参数、自动同步或多来源配置,也能先抓住 Application 最稳定的职责划分。