容器与云原生 / 系统课时

建立 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:

yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - deployment.yaml
  - service.yaml
commonLabels:
  app.kubernetes.io/part-of: checkout

deploy/overlays/prod/kustomization.yaml 片段示例,依赖上面的 base:

yaml
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 对象。

bash
kubectl kustomize deploy/overlays/prod > /tmp/checkout-prod.yaml
kubectl apply --dry-run=client -f /tmp/checkout-prod.yaml

预期输出

text
deployment.apps/checkout configured (dry run)
service/checkout configured (dry run)

如果资源名称与示例不同,输出中的对象名会相应变化;关键是 dry-run 不出现 schema、路径或 patch 错误。

让 Argo CD 接管目标环境

Argo CD 的 Application 把三个核心信息固定下来:从哪个 Git 仓库读取、读取哪个目录、同步到哪个集群与命名空间。生产环境建议显式开启 prune 和 selfHeal,让删除资源和手工漂移都能回到 Git 声明状态。

Git 提交驱动 Argo CD 自动同步 Kubernetes 的发布链路

创建 argocd-application.yaml。将 <REPO_URL> 替换为 Argo CD 已有权限读取的 Git 仓库地址。

yaml
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 已接管。

bash
kubectl apply -f argocd-application.yaml
kubectl get application checkout-prod -n argocd

预期输出

text
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 与工作负载是否都收敛。

bash
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"}'

预期输出

text
Synced Healthy
registry.example.com/shop/checkout:1.4.3

如果镜像仍是旧版本,先确认新的 Git 提交已经推到 targetRevision 指向的分支,再检查 Application 的 source.path 是否正好指向生产 overlay。

把手工漂移变成可检测事件

selfHeal: true 的价值是阻止“线上临时改一下”长期变成隐形配置。测试环境中可以临时修改副本数,然后观察 Argo CD 把它恢复为 Git 声明的 3 个副本。

bash
kubectl scale deployment checkout -n shop --replicas=5
kubectl get deployment checkout -n shop -o jsonpath='{.spec.replicas}{"\n"}'

预期输出

text
deployment.apps/checkout scaled
5

随后等待 Argo CD 完成下一次协调,再次查询。

bash
kubectl get deployment checkout -n shop -o jsonpath='{.spec.replicas}{"\n"}'

预期输出

text
3

实际恢复时间取决于 Argo CD 的刷新与协调节奏。生产环境不应把这种手工修改当作正常发布手段;正确流程是修改 Git、通过评审、由 Argo CD 同步。这样版本、审批记录、期望状态和回滚依据都集中在同一条可审计链路中。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立 GitOps 发布流程

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

登录哪都通