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 的治理边界。

Argo CD Application 关键字段关系

可以把它理解成一条声明链:Application 根据 repoURL 找到仓库,通过 targetRevision 选择 Git revision,再由 path 定位仓库中的应用目录;渲染出的资源随后被同步到 destination 指定的位置,同时整个操作必须符合 project 对来源和目标的约束。

从一份最小清单读字段

下面是一份使用 Git 目录作为配置来源的 Application。它假定 Argo CD 已经能够访问该仓库,并且仓库中的 apps/myapp 包含可被 Argo CD 识别的 Kubernetes 配置。

yaml
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 接受:

bash
kubectl apply -f application.yaml
kubectl -n argocd get application myapp -o name

预期输出

text
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 最稳定的职责划分。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

看懂 Application 的关键字段

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通