CI/CD / 系统课时
完成 Helm 与 Argo CD 综合发布
完成 Helm 与 Argo CD 综合发布
这一节把 Helm Chart、环境 Values、ApplicationSet 和 Argo CD 同步串成一条完整 GitOps 发布链路。最终目标不是完成一次手工部署,而是得到一套以 Git 为期望状态来源、可验证、可回滚并能继续扩展环境的发布方案。
学习目标
- 组织可复用的 Helm Chart 与环境差异配置
- 使用 ApplicationSet 为多个环境生成 Argo CD Application
- 完成提交、同步、验证和基于 Git 的回滚闭环
组织 GitOps 仓库
综合发布首先要把“应用模板”和“环境期望状态”分开。下面采用单仓库示例:charts/demo-api 保存 Helm Chart,environments 保存环境 Values,argocd 保存 ApplicationSet。

推荐的最小目录关系如下:
<PATH>/
charts/
demo-api/
Chart.yaml
values.yaml
templates/
deployment.yaml
service.yaml
environments/
dev.yaml
prod.yaml
argocd/
applicationset.yamlChart 负责表达所有环境共享的 Kubernetes 结构,环境文件只保存真正存在差异的值。这样升级镜像、调整副本数或修改资源限制时,不需要复制整套清单。
编写可复用的 Chart
下面给出核心 Deployment 的片段示例。它依赖 Chart 中已经存在的 values.yaml,其中定义 replicaCount、image.repository、image.tag 和 service.port。
apiVersion: apps/v1
kind: Deployment
metadata:
name: {{ .Release.Name }}
spec:
replicas: {{ .Values.replicaCount }}
selector:
matchLabels:
app: {{ .Release.Name }}
template:
metadata:
labels:
app: {{ .Release.Name }}
spec:
containers:
- name: demo-api
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
ports:
- containerPort: {{ .Values.service.port }}环境差异放进独立 Values。例如生产环境可以固定经过验证的镜像版本并增加副本数:
replicaCount: 3
image:
repository: registry.example.com/demo-api
tag: "1.4.2"
service:
port: 8080配置文件本身不产生固定控制台输出。提交前应先执行 Helm 渲染检查,确认模板与生产 Values 能组合成合法清单:
helm template demo-api ./charts/demo-api -f ./environments/prod.yaml预期结果:命令成功输出渲染后的 Kubernetes YAML,其中 Deployment 的副本数为 3,镜像为 registry.example.com/demo-api:1.4.2。完整输出会随 Chart 中的资源变化,因此不应依赖固定行数。
用 ApplicationSet 生成环境应用
当 dev、prod 使用同一 Chart,只在 Values、Namespace 等维度变化时,可以让 ApplicationSet 根据环境列表生成 Application。以下为可直接提交的最小示例,仓库地址需要替换为实际 Git 仓库地址。
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
name: demo-api
namespace: argocd
spec:
generators:
- list:
elements:
- env: dev
namespace: demo-api-dev
- env: prod
namespace: demo-api-prod
template:
metadata:
name: "demo-api-{{env}}"
spec:
project: default
source:
repoURL: https://git.example.com/platform/gitops.git
targetRevision: main
path: charts/demo-api
helm:
valueFiles:
- ../../environments/{{env}}.yaml
destination:
server: https://kubernetes.default.svc
namespace: "{{namespace}}"
syncPolicy:
automated:
prune: true
selfHeal: true
syncOptions:
- CreateNamespace=trueprune: true 允许 Argo CD 删除 Git 中已经移除的受管资源,selfHeal: true 会尝试纠正集群中的手工漂移。开启前应确认团队已经接受“Git 是期望状态来源”的协作规则,否则手工修改可能很快被覆盖。
应用配置后可以检查生成结果:
kubectl apply -f ./argocd/applicationset.yaml
kubectl -n argocd get applications预期输出类似下面的结构,实际同步与健康状态取决于仓库访问、目标集群和工作负载状态:
NAME SYNC STATUS HEALTH STATUS
demo-api-dev <STATUS> <STATUS>
demo-api-prod <STATUS> <STATUS>其中 <STATUS> 是动态值。配置正确且同步完成后,通常应观察到期望应用进入 Synced,工作负载健康后进入 Healthy。
完成发布与验收
一次发布应从 Git 变更开始。例如把 prod.yaml 中的镜像标签更新为新版本,完成代码评审后合并。Argo CD 检测到目标 revision 的期望状态变化,再渲染 Chart 并同步集群。
不要只以 Application 显示 Synced 作为发布成功依据。Synced 说明集群资源与 Git 期望状态一致,而业务是否真正可用还需要工作负载和接口验证。
kubectl -n demo-api-prod rollout status deployment/demo-api
kubectl -n demo-api-prod get pods预期输出的资源名称和 Pod 名称可能不同;部署成功时,第一条命令应确认 rollout 完成,Pod 应最终进入就绪状态:
deployment "demo-api" successfully rolled out
NAME READY STATUS RESTARTS AGE
<POD-NAME> 1/1 Running 0 <TIME>随后还应通过实际入口执行健康检查或关键业务请求。只有 Git 同步、工作负载就绪和业务验证都通过,才应把这次变更视为完成发布。
用 Git 完成回滚
GitOps 场景下,优先回滚期望状态,而不是直接在集群里修改 Deployment。假设最近一次提交引入错误,可以创建一个反向提交:
git revert <ID>
git push origin main预期输出会因提交信息和远端仓库不同而变化,成功时本地会生成新的 revert 提交,随后 push 更新远端 main:
[main <ID>] Revert "<COMMIT-MESSAGE>"
<REMOTE-PUSH-RESULT><ID> 和远端 push 信息都是动态值。Argo CD 发现 Git 中期望状态恢复后,会按照同步策略把集群重新收敛到旧版本。回滚后仍需重复 rollout、Pod 和业务验证,不能因为 Git 已经 revert 就直接判定故障解除。
这套流程的关键边界是:Chart 定义可复用结构,Values 表达环境差异,ApplicationSet 批量生成环境应用,Argo CD 负责持续收敛,而发布与回滚都通过 Git 留下可审查记录。做到这一点后,新增环境通常只需要增加对应 Values 和生成器参数,而不必复制整套 Kubernetes 配置。