容器与云原生 / 系统课时
使用 Argo CD 持续部署
使用 Argo CD 持续部署
这一课把一个可运行的 GitOps 闭环搭起来:安装 Argo CD,用 Application 监听 Git 仓库,开启自动同步与漂移修复,并通过健康状态和 Git 回退完成部署验收。
学习目标
- 在 Kubernetes 集群中安装 Argo CD,并确认控制面就绪。
- 用 Application 配置自动同步、资源清理、健康判定和漂移修复。
- 通过 Git 回退恢复旧版本,并验证集群重新收敛到期望状态。
部署 Argo CD
实验环境需要已有可用的 kubectl 和集群管理员权限。下面使用官方 stable 安装清单;生产环境应固定到经过验证的具体版本,避免安装内容随分支变化。
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预期输出:
deployment "argocd-server" successfully rolled out这个结果只说明 API Server Deployment 已完成滚动发布。继续创建 Application 前,还应确认 argocd-application-controller、argocd-repo-server 等核心工作负载处于 Running 或 Ready 状态。
创建持续部署应用
Application 把三个事实绑定在一起:期望状态来自哪个 Git 路径、部署到哪个集群和命名空间、发现差异后怎样同步。下面用公开 guestbook 仓库做可复现实验。
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 后执行:
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预期输出:
application.argoproj.io/guestbook-cd created
application.argoproj.io/guestbook-cd condition met
Synced Healthyprune: true 会删除 Git 中已经移除、但仍由该 Application 管理的资源;selfHeal: true 则会把集群中的手工改动重新拉回 Git 所定义的状态。只有当 Git 确实是该应用的唯一期望状态来源时,才应开启这两个选项。

让健康状态真正有意义
Argo CD 能直接判断 Deployment、StatefulSet、Service 等常见资源的健康状态,但业务是否真的可接流量,仍应由 Kubernetes 探针表达。下面是 Deployment 容器配置的片段示例,依赖你自己的工作负载上下文。
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。
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预期输出:
deployment.apps/guestbook-ui scaled
1如果循环长时间不结束,先看 Application 是否为 OutOfSync,再检查 application-controller 日志、仓库连接和目标集群权限。不要通过反复手改 live 资源“顶住” GitOps 控制器,那只会制造持续漂移。
用 Git 完成可追溯回退
持续部署的回退目标不是“临时把集群切到旧状态”,而是把期望状态本身恢复到已知可用版本。对自己的配置仓库执行 git revert,会生成一个新的回退提交;Argo CD 随后按正常同步流程部署它,审计链仍然完整。
git revert --no-edit <ID> >/dev/null
git push origin main >/dev/null
echo "rollback commit pushed"预期输出:
rollback commit pushed其中 <ID> 是要撤销的 Git 提交 ID,实际值按你的仓库历史替换。回退后再次检查 Application 应回到 Synced 和 Healthy;若新旧版本涉及不可逆数据库变更,则必须先按数据库回退方案处理,不能只依赖 Kubernetes 清单回滚。