CI/CD / 系统课时
创建应用同步规则
创建应用同步规则
本课使用 Argo CD 的 Application 资源定义 Git 配置从哪里读取、部署到哪个集群与命名空间,以及是否自动同步、自愈和清理废弃资源。完成后,你可以用一份声明式规则持续驱动应用状态。
学习目标
- 定义仓库地址、版本和目录组成的配置来源。
- 指定目标集群、目标命名空间与自动同步策略。
- 正确使用
prune、selfHeal和allowEmpty控制清理与漂移修复风险。
把同步规则拆成四个部分
一个 Application 可以先按四个问题理解:source 回答“期望状态从哪里来”,destination 回答“资源写到哪里”,syncPolicy.automated 回答“是否自动把差异收敛”,syncOptions 则补充创建命名空间等同步行为。
| 规则区域 | 关键字段 | 作用 |
|---|---|---|
| 配置来源 | repoURL、targetRevision、path |
锁定仓库、分支或版本与目录 |
| 部署目标 | server、namespace |
指定目标集群和命名空间 |
| 自动同步 | prune、selfHeal |
清理已移除资源并修复手工漂移 |
| 安全边界 | allowEmpty、CreateNamespace |
防止空源误清理,并控制命名空间创建 |

定义 Application 清单
下面清单假设 Argo CD 已安装在 argocd 命名空间,仓库凭据也已配置。将 <REPO_URL> 替换为真实仓库地址,并确保仓库中存在 environments/prod 目录。
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: demo-api
namespace: argocd
spec:
project: default
source:
repoURL: <REPO_URL>
targetRevision: main
path: environments/prod
destination:
server: https://kubernetes.default.svc
namespace: gitops-demo
syncPolicy:
automated:
prune: true
selfHeal: true
allowEmpty: false
syncOptions:
- CreateNamespace=trueserver: https://kubernetes.default.svc 表示部署到 Argo CD 当前所在的 Kubernetes 集群。若目标是外部集群,应先把该集群注册到 Argo CD,再把 server 改成注册后的目标地址。
应用规则并等待首次同步
将清单保存为 application.yaml 后创建 Application。自动同步开启后,控制器会立即尝试读取 Git 并收敛目标资源。
kubectl apply -f application.yaml >/dev/null
kubectl -n argocd get application demo-api -o name预期输出
application.argoproj.io/demo-api仓库、目录和权限都正确时,可以等待同步状态变成 Synced,再查看健康状态。
kubectl -n argocd wait application/demo-api --for=jsonpath='{.status.sync.status}'=Synced --timeout=180s >/dev/null
kubectl -n argocd get application demo-api预期输出
NAME SYNC STATUS HEALTH STATUS
demo-api Synced <VALUE><VALUE> 取决于仓库里的工作负载类型和就绪速度,常见稳定结果是 Healthy;如果资源仍在启动,也可能暂时显示 Progressing。
理解自动清理与自愈边界
prune: true 只会清理这个 Application 曾经管理、但已经从期望状态中移除的资源,不等于删除目标命名空间里的所有对象。selfHeal: true 会把集群中对受管资源的手工修改恢复成 Git 里的声明,因此生产环境应把 Git 变更流程当作主要修改入口。
allowEmpty: false 是重要安全门:当应用原本管理资源、但来源突然解析为空时,它可以阻止自动同步把应用清空。CreateNamespace=true 只解决目标命名空间不存在的问题,不会自动补齐命名空间受限部署所缺失的 RBAC 权限。
用同步状态定位首轮失败
如果 Application 没有进入 Synced,先直接查看自定义资源的状态列,不要只观察业务 Pod。OutOfSync 通常表示存在尚未收敛的差异,Unknown 或长期无法计算状态则更应检查仓库访问、目录、版本和资源解析错误。
kubectl -n argocd get application demo-api预期输出
NAME SYNC STATUS HEALTH STATUS
demo-api <VALUE> <VALUE>实际值可能不同。排查顺序建议固定为:先核对 <REPO_URL>、targetRevision 和 path 是否存在,再确认仓库凭据能读取对应版本,最后检查控制器对 gitops-demo 及相关集群级资源是否有权限。同步规则一旦稳定,后续发布只需要修改 Git 中的期望状态,控制器会持续把集群收敛到该声明。