容器与云原生 / 系统课时

使用 Argo CD 持续部署

使用 Argo CD 持续部署

这一课把一个可运行的 GitOps 闭环搭起来:安装 Argo CD,用 Application 监听 Git 仓库,开启自动同步与漂移修复,并通过健康状态和 Git 回退完成部署验收。

学习目标

  • 在 Kubernetes 集群中安装 Argo CD,并确认控制面就绪。
  • 用 Application 配置自动同步、资源清理、健康判定和漂移修复。
  • 通过 Git 回退恢复旧版本,并验证集群重新收敛到期望状态。

部署 Argo CD

实验环境需要已有可用的 kubectl 和集群管理员权限。下面使用官方 stable 安装清单;生产环境应固定到经过验证的具体版本,避免安装内容随分支变化。

bash
kubectl create namespace argocd --dry-run=client -o yaml | kubectl apply -f - >/dev/null
kubectl apply -n argocd --server-side --force-conflicts   -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml >/dev/null
kubectl -n argocd rollout status deployment/argocd-server

预期输出:

text
deployment "argocd-server" successfully rolled out

这个结果只说明 API Server Deployment 已完成滚动发布。继续创建 Application 前,还应确认 argocd-application-controller、argocd-repo-server 等核心工作负载处于 Running 或 Ready 状态。

创建持续部署应用

Application 把三个事实绑定在一起:期望状态来自哪个 Git 路径、部署到哪个集群和命名空间、发现差异后怎样同步。下面用公开 guestbook 仓库做可复现实验。

yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: guestbook-cd
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/argoproj/argocd-example-apps.git
    targetRevision: HEAD
    path: guestbook
  destination:
    server: https://kubernetes.default.svc
    namespace: default
  syncPolicy:
    automated:
      enabled: true
      prune: true
      selfHeal: true
      allowEmpty: false

把内容保存为 application.yaml 后执行:

bash
kubectl apply -f application.yaml
kubectl -n argocd wait application/guestbook-cd   --for=jsonpath='{.status.health.status}'=Healthy --timeout=180s
kubectl -n argocd get application guestbook-cd   -o custom-columns=SYNC:.status.sync.status,HEALTH:.status.health.status --no-headers

预期输出:

text
application.argoproj.io/guestbook-cd created
application.argoproj.io/guestbook-cd condition met
Synced   Healthy

prune: true 会删除 Git 中已经移除、但仍由该 Application 管理的资源;selfHeal: true 则会把集群中的手工改动重新拉回 Git 所定义的状态。只有当 Git 确实是该应用的唯一期望状态来源时,才应开启这两个选项。

Argo CD 从 Git 到集群的同步、健康反馈、漂移修复与回退闭环

让健康状态真正有意义

Argo CD 能直接判断 Deployment、StatefulSet、Service 等常见资源的健康状态,但业务是否真的可接流量,仍应由 Kubernetes 探针表达。下面是 Deployment 容器配置的片段示例,依赖你自己的工作负载上下文。

yaml
readinessProbe:
  httpGet:
    path: /ready
    port: 8080
  initialDelaySeconds: 3
  periodSeconds: 5
  failureThreshold: 3

这段配置本身不会产生控制台输出。生效后可用 kubectl describe pod <ID> 检查 Readiness 探针,用 Application 的 status.health.status 观察 Argo CD 是否把应用判定为 Healthy。若使用自定义 CRD 且 Argo CD 没有内置健康规则,再考虑为该资源增加自定义健康检查。

验证漂移修复

现在故意把 guestbook-ui 的副本数从 Git 中定义的 1 改成 3。selfHeal 开启后,Argo CD 会检测 live state 与 Git 不一致,并把副本数恢复为 1。

bash
kubectl -n default scale deployment/guestbook-ui --replicas=3
until [ "$(kubectl -n default get deployment guestbook-ui -o jsonpath='{.spec.replicas}')" = "1" ]; do
  sleep 2
done
kubectl -n default get deployment guestbook-ui -o jsonpath='{.spec.replicas}'
echo

预期输出:

text
deployment.apps/guestbook-ui scaled
1

如果循环长时间不结束,先看 Application 是否为 OutOfSync,再检查 application-controller 日志、仓库连接和目标集群权限。不要通过反复手改 live 资源“顶住” GitOps 控制器,那只会制造持续漂移。

用 Git 完成可追溯回退

持续部署的回退目标不是“临时把集群切到旧状态”,而是把期望状态本身恢复到已知可用版本。对自己的配置仓库执行 git revert,会生成一个新的回退提交;Argo CD 随后按正常同步流程部署它,审计链仍然完整。

bash
git revert --no-edit <ID> >/dev/null
git push origin main >/dev/null
echo "rollback commit pushed"

预期输出:

text
rollback commit pushed

其中 <ID> 是要撤销的 Git 提交 ID,实际值按你的仓库历史替换。回退后再次检查 Application 应回到 Synced 和 Healthy;若新旧版本涉及不可逆数据库变更,则必须先按数据库回退方案处理,不能只依赖 Kubernetes 清单回滚。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Argo CD 持续部署

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

登录哪都通