容器与云原生 / 系统课时
建立 GitOps 发布流程
建立 GitOps 发布流程
本节把微服务发布改造成以 Git 为唯一期望状态来源的 GitOps 流程:Kustomize 管理环境差异,Argo CD 持续对比仓库与集群并自动同步生产命名空间。
学习目标
- 用 Kustomize 分离公共清单与生产环境差异
- 用 Argo CD Application 绑定仓库、路径与目标集群
- 配置自动同步、漂移修复和删除回收,并验证 Git 提交能驱动发布
组织声明式清单
GitOps 的关键不是“用 Git 存 YAML”,而是让 Git 中的声明成为集群期望状态。下面采用 base 与 overlays/prod 两层结构:base 保存可复用 Deployment 和 Service,生产 overlay 只覆盖副本数和镜像版本。
deploy/base/kustomization.yaml 片段示例,依赖同目录已经存在 deployment.yaml 与 service.yaml:
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- deployment.yaml
- service.yaml
commonLabels:
app.kubernetes.io/part-of: checkoutdeploy/overlays/prod/kustomization.yaml 片段示例,依赖上面的 base:
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ../../base
namespace: shop
images:
- name: checkout
newName: registry.example.com/shop/checkout
newTag: "1.4.2"
replicas:
- name: checkout
count: 3配置文件不会自己执行。先在提交前本地渲染,确保 Kustomize 能得到完整 Kubernetes 对象。
kubectl kustomize deploy/overlays/prod > /tmp/checkout-prod.yaml
kubectl apply --dry-run=client -f /tmp/checkout-prod.yaml预期输出
deployment.apps/checkout configured (dry run)
service/checkout configured (dry run)如果资源名称与示例不同,输出中的对象名会相应变化;关键是 dry-run 不出现 schema、路径或 patch 错误。
让 Argo CD 接管目标环境
Argo CD 的 Application 把三个核心信息固定下来:从哪个 Git 仓库读取、读取哪个目录、同步到哪个集群与命名空间。生产环境建议显式开启 prune 和 selfHeal,让删除资源和手工漂移都能回到 Git 声明状态。

创建 argocd-application.yaml。将 <REPO_URL> 替换为 Argo CD 已有权限读取的 Git 仓库地址。
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: checkout-prod
namespace: argocd
spec:
project: default
source:
repoURL: <REPO_URL>
targetRevision: main
path: deploy/overlays/prod
destination:
server: https://kubernetes.default.svc
namespace: shop
syncPolicy:
automated:
prune: true
selfHeal: true
syncOptions:
- CreateNamespace=true应用资源并确认 Argo CD 已接管。
kubectl apply -f argocd-application.yaml
kubectl get application checkout-prod -n argocd预期输出
application.argoproj.io/checkout-prod created
NAME SYNC STATUS HEALTH STATUS
checkout-prod Synced Healthy首次拉取仓库和创建工作负载需要短暂时间;如果刚创建时显示 OutOfSync 或 Progressing,应等待控制器完成一次协调后再判断。长期无法同步时,优先检查仓库凭据、path、目标命名空间权限和渲染错误。
用一次镜像升级验证 Git 驱动发布
验证 GitOps 不要直接执行 kubectl set image,否则会绕过期望状态来源。应修改生产 overlay 中的镜像标签,然后提交 Git。例如把 newTag 从 1.4.2 改为 1.4.3,完成评审后推送到 main。
提交后,Argo CD 会发现仓库期望状态与集群实际状态不一致,并在自动同步开启时更新 Deployment。可以用下面的命令检查 Argo CD 与工作负载是否都收敛。
kubectl get application checkout-prod -n argocd -o jsonpath='{.status.sync.status}{" "}{.status.health.status}{"\n"}'
kubectl get deployment checkout -n shop -o jsonpath='{.spec.template.spec.containers[0].image}{"\n"}'预期输出
Synced Healthy
registry.example.com/shop/checkout:1.4.3如果镜像仍是旧版本,先确认新的 Git 提交已经推到 targetRevision 指向的分支,再检查 Application 的 source.path 是否正好指向生产 overlay。
把手工漂移变成可检测事件
selfHeal: true 的价值是阻止“线上临时改一下”长期变成隐形配置。测试环境中可以临时修改副本数,然后观察 Argo CD 把它恢复为 Git 声明的 3 个副本。
kubectl scale deployment checkout -n shop --replicas=5
kubectl get deployment checkout -n shop -o jsonpath='{.spec.replicas}{"\n"}'预期输出
deployment.apps/checkout scaled
5随后等待 Argo CD 完成下一次协调,再次查询。
kubectl get deployment checkout -n shop -o jsonpath='{.spec.replicas}{"\n"}'预期输出
3实际恢复时间取决于 Argo CD 的刷新与协调节奏。生产环境不应把这种手工修改当作正常发布手段;正确流程是修改 Git、通过评审、由 Argo CD 同步。这样版本、审批记录、期望状态和回滚依据都集中在同一条可审计链路中。