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。

Helm 与 Argo CD GitOps 综合发布链路

推荐的最小目录关系如下:

text
<PATH>/
  charts/
    demo-api/
      Chart.yaml
      values.yaml
      templates/
        deployment.yaml
        service.yaml
  environments/
    dev.yaml
    prod.yaml
  argocd/
    applicationset.yaml

Chart 负责表达所有环境共享的 Kubernetes 结构,环境文件只保存真正存在差异的值。这样升级镜像、调整副本数或修改资源限制时,不需要复制整套清单。

编写可复用的 Chart

下面给出核心 Deployment 的片段示例。它依赖 Chart 中已经存在的 values.yaml,其中定义 replicaCount、image.repository、image.tag 和 service.port。

yaml
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。例如生产环境可以固定经过验证的镜像版本并增加副本数:

yaml
replicaCount: 3
image:
  repository: registry.example.com/demo-api
  tag: "1.4.2"
service:
  port: 8080

配置文件本身不产生固定控制台输出。提交前应先执行 Helm 渲染检查,确认模板与生产 Values 能组合成合法清单:

bash
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 仓库地址。

yaml
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=true

prune: true 允许 Argo CD 删除 Git 中已经移除的受管资源,selfHeal: true 会尝试纠正集群中的手工漂移。开启前应确认团队已经接受“Git 是期望状态来源”的协作规则,否则手工修改可能很快被覆盖。

应用配置后可以检查生成结果:

bash
kubectl apply -f ./argocd/applicationset.yaml
kubectl -n argocd get applications

预期输出类似下面的结构,实际同步与健康状态取决于仓库访问、目标集群和工作负载状态:

text
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 期望状态一致,而业务是否真正可用还需要工作负载和接口验证。

bash
kubectl -n demo-api-prod rollout status deployment/demo-api
kubectl -n demo-api-prod get pods

预期输出的资源名称和 Pod 名称可能不同;部署成功时,第一条命令应确认 rollout 完成,Pod 应最终进入就绪状态:

text
deployment "demo-api" successfully rolled out
NAME                     READY   STATUS    RESTARTS   AGE
<POD-NAME>               1/1     Running   0          <TIME>

随后还应通过实际入口执行健康检查或关键业务请求。只有 Git 同步、工作负载就绪和业务验证都通过,才应把这次变更视为完成发布。

用 Git 完成回滚

GitOps 场景下,优先回滚期望状态,而不是直接在集群里修改 Deployment。假设最近一次提交引入错误,可以创建一个反向提交:

bash
git revert <ID>
git push origin main

预期输出会因提交信息和远端仓库不同而变化,成功时本地会生成新的 revert 提交,随后 push 更新远端 main:

text
[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 配置。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成 Helm 与 Argo CD 综合发布

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

登录哪都通