CI/CD / 系统课时

创建应用同步规则

创建应用同步规则

本课使用 Argo CD 的 Application 资源定义 Git 配置从哪里读取、部署到哪个集群与命名空间,以及是否自动同步、自愈和清理废弃资源。完成后,你可以用一份声明式规则持续驱动应用状态。

学习目标

  • 定义仓库地址、版本和目录组成的配置来源。
  • 指定目标集群、目标命名空间与自动同步策略。
  • 正确使用 prune、selfHeal 和 allowEmpty 控制清理与漂移修复风险。

把同步规则拆成四个部分

一个 Application 可以先按四个问题理解:source 回答“期望状态从哪里来”,destination 回答“资源写到哪里”,syncPolicy.automated 回答“是否自动把差异收敛”,syncOptions 则补充创建命名空间等同步行为。

规则区域 关键字段 作用
配置来源 repoURL、targetRevision、path 锁定仓库、分支或版本与目录
部署目标 server、namespace 指定目标集群和命名空间
自动同步 prune、selfHeal 清理已移除资源并修复手工漂移
安全边界 allowEmpty、CreateNamespace 防止空源误清理,并控制命名空间创建

Argo CD Application 同步规则与收敛流程

定义 Application 清单

下面清单假设 Argo CD 已安装在 argocd 命名空间,仓库凭据也已配置。将 <REPO_URL> 替换为真实仓库地址,并确保仓库中存在 environments/prod 目录。

yaml
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=true

server: https://kubernetes.default.svc 表示部署到 Argo CD 当前所在的 Kubernetes 集群。若目标是外部集群,应先把该集群注册到 Argo CD,再把 server 改成注册后的目标地址。

应用规则并等待首次同步

将清单保存为 application.yaml 后创建 Application。自动同步开启后,控制器会立即尝试读取 Git 并收敛目标资源。

bash
kubectl apply -f application.yaml >/dev/null
kubectl -n argocd get application demo-api -o name

预期输出

text
application.argoproj.io/demo-api

仓库、目录和权限都正确时,可以等待同步状态变成 Synced,再查看健康状态。

bash
kubectl -n argocd wait application/demo-api --for=jsonpath='{.status.sync.status}'=Synced --timeout=180s >/dev/null
kubectl -n argocd get application demo-api

预期输出

text
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 或长期无法计算状态则更应检查仓库访问、目录、版本和资源解析错误。

bash
kubectl -n argocd get application demo-api

预期输出

text
NAME       SYNC STATUS   HEALTH STATUS
demo-api   <VALUE>       <VALUE>

实际值可能不同。排查顺序建议固定为:先核对 <REPO_URL>、targetRevision 和 path 是否存在,再确认仓库凭据能读取对应版本,最后检查控制器对 gitops-demo 及相关集群级资源是否有权限。同步规则一旦稳定,后续发布只需要修改 Git 中的期望状态,控制器会持续把集群收敛到该声明。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建应用同步规则

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

登录哪都通