从零搭建ArgoCD容器持续交付流水线：自动部署AI中转服务实战

很多运维新手听到“GitOps”和“ArgoCD”会觉得很复杂，其实核心思路很简单：把Kubernetes资源配置存放在Git仓库，ArgoCD负责同步集群状态与仓库一致。
本文以AI中转服务为例，带你一步步搭建一条完整的ArgoCD容器持续交付流水线，后续更新代码只需推送Git，ArgoCD自动完成部署。

你需要准备什么

• 一个运行中的Kubernetes集群（版本1.19+，可用minikube或云厂商托管集群）
• 一台能连集群的机器，安装好kubectl和Helm
• 一个Git仓库（GitHub/GitLab/Gitee均可），用来存放AI中转服务的YAML清单
• 已经将AI中转服务的镜像推送到容器镜像仓库（如Docker Hub或私有仓库）

如果你还没有AI中转服务的代码，可以用一个简单的Nginx代理服务代替，原理相同。

编写AI中转服务的K8s资源配置

在Git仓库中创建目录 ai-gateway，里面存放以下文件：

• deployment.yaml：定义Deployment，引用你的镜像。
• service.yaml：暴露服务端口。
• ingress.yaml（可选）：如果需要公网访问，配置Ingress。

关键示例（deployment.yaml）：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: ai-gateway
  labels:
    app: ai-gateway
spec:
  replicas: 2
  selector:
    matchLabels:
      app: ai-gateway
  template:
    metadata:
      labels:
        app: ai-gateway
    spec:
      containers:
      - name: ai-gateway
        image: your-registry/ai-gateway:latest
        ports:
        - containerPort: 8080
        livenessProbe:
          httpGet:
            path: /health
            port: 8080
          initialDelaySeconds: 10
          periodSeconds: 5

把文件提交到Git仓库。

在ArgoCD中创建应用并配置自动同步

安装ArgoCD（如果还没装）：

kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

等待Pod就绪：

kubectl wait --for=condition=Ready pods --all -n argocd

获取初始密码并登录UI（或使用CLI）：

kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

通过 argocd login 或Web UI登录后，点击“新建应用”，填写：

• 应用名称：ai-gateway
• 项目：default
• 同步策略：自动（可根据需求选手动）
• 仓库URL：你的Git仓库地址
• 路径：ai-gateway
• 目标集群：选择内嵌集群（https://kubernetes.default.svc）
• 命名空间：default（或自定义）

保存后，在应用详情中启用“自动同步”，并勾选“Prune Resources”和“Self Heal”。
这样当Git仓库有更新时，ArgoCD会自动同步，并清理未被Git管理的资源；
如果有人手动修改集群状态，ArgoCD也会自动回滚到Git定义的状态。

常见踩坑与解决方案

• 同步失败，提示“Permission denied”：检查ServiceAccount权限，可能需要为argocd-repo-server绑定适当的RBAC。
• 镜像拉取失败：确保集群节点有权限拉取镜像，私有仓库需配置imagePullSecrets。
• 自动同步未触发：确认ArgoCD Webhook配置（在Git仓库设置中添加ArgoCD的Webhook地址），或手动触发刷新。
• 健康检查显示OutOfSync：检查Git中的YAML是否与集群状态完全一致，有时Probe配置不一致也会导致。

验证流水线是否正常工作

修改Git仓库中deployment.yaml的镜像版本（比如改为v2），提交并推送。
ArgoCD会在几秒内检测到变更，自动执行同步，更新Deployment的镜像。
你可以用以下命令实时观察：

kubectl rollout status deployment/ai-gateway

或者在ArgoCD UI中看到同步状态变为“Synced”，Pod自动滚动更新。

这样你就成功搭建了ArgoCD容器持续交付AI中转服务的流水线。
后续只要保持“推送代码 → ArgoCD自动同步”的工作流，就能极大减少手动部署出错的可能。

如果你遇到其他问题，记得先查看ArgoCD的日志（argocd app logs ai-gateway）以及Pod的事件，通常能快速定位原因。