如何通过GitOps为自建服务器集群自动更新应用镜像?

发布人:A5数据发布时间:2026-11-16 13:59阅读量:29

自建服务器集群可以通过 GitOps 自动更新应用镜像:镜像仓库负责提供可选版本,集群内的控制器定期检查新标签,符合策略的版本被写回 Git,随后由部署控制器把 Git 中的期望状态应用到集群。这样,镜像更新有记录、可审核,也能通过恢复 Git 中的配置回到已知版本。

这里以 Flux 为例。核心不是定时执行一条 kubectl set image 命令,而是把“发现版本、选择版本、修改配置、部署并确认状态”拆成职责明确的环节。更新频率、版本范围、Git 写入权限和集群健康检查共同决定自动化的边界。

更新链路由哪些组件协作

Flux 的镜像自动化通常包含两类控制器:镜像相关控制器负责发现和提交更新,常规的源与部署控制器负责读取 Git 并应用配置。一次更新大致经历以下状态变化:

更新链路由哪些组件协作配图

  1. ImageRepository 定期读取容器镜像仓库中的标签。
  2. ImagePolicy 按版本规则从标签中选出符合条件的版本。
  3. ImageUpdateAutomation 将选中版本写入仓库配置,并提交到指定分支。
  4. GitRepository 检查 Git 仓库的新提交。
  5. Kustomization 将新配置应用到集群,并按配置等待工作负载达到期望状态。
组件职责需要重点核对的设置
ImageRepository扫描镜像仓库中的标签镜像地址、扫描间隔、私有仓库凭据
ImagePolicy按规则挑选可用标签版本范围、标签格式、预发布版本是否允许
ImageUpdateAutomation将所选标签写回 Git更新目录、提交身份、推送分支
GitRepository获取 Git 配置源仓库地址、分支、读取凭据
Kustomization将配置应用到集群同步目录、清理策略、健康检查

这些组件不要求部署在同一台服务器上,但通常由集群内的 Flux 控制器统一管理。控制器需要能访问 Git 服务和镜像仓库;若集群网络不能直接访问这些服务,还需要先解决相应的网络连通性和凭据配置。

围绕自建集群的节点与应用负载,A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地的物理服务器租用,涵盖多种 CPU、内存与 SSD/NVMe 配置,并提供不同地区和套餐的网络线路选择。这些计算、存储与网络资源可用于部署集群节点和业务服务,为 GitOps 控制器连接代码仓库、镜像仓库及集群工作负载提供基础设施选择。

先确定仓库布局与更新边界

示例假定 Flux 已安装,Git 仓库和容器镜像仓库均可访问,应用配置位于同一 Git 仓库。目录可以按环境拆分,避免测试环境和生产环境共享同一条自动更新路径:

clusters/
  prod/
    apps/
      api-deployment.yaml
      kustomization.yaml
  staging/
    apps/
      api-deployment.yaml
      kustomization.yaml

生产目录只应包含生产环境的清单。若生产环境必须经过审核,可以让自动化把更新提交到单独分支,再由代码评审流程合并;若允许受控的机器人账号直接更新主分支,则应限制该账号只能修改预期目录,并保留提交审计记录。分支保护规则可能禁止机器人直接推送,部署前需要确认 Git 服务端的权限设置与更新方式相符。

还要区分“发现新标签”和“批准部署”。自动化策略若允许选择某个范围内的最新版本,符合规则的标签就可能被直接部署。生产环境若需要先在测试环境验证,可把测试与生产配置分开:新版本先进入测试环境,验证通过后再通过审核提交或发布流程提升到生产环境。

先确定仓库布局与更新边界配图

配置镜像扫描与版本策略

下面的资源使用 Flux 镜像自动化 API v1beta2。实际应用前,先检查集群已安装的 CRD 是否支持该版本:

kubectl api-resources | grep -E 'imagerepositories|imagepolicies|imageupdateautomations'

为私有镜像仓库配置读取凭据后,在 flux-system 命名空间创建 ImageRepository 和 ImagePolicy。凭据应通过集群的密钥管理流程提供,不要把用户名、密码或访问令牌直接写进 Git 明文清单。

apiVersion: image.toolkit.fluxcd.io/v1beta2
kind: ImageRepository
meta
  name: api
  namespace: flux-system
spec:
  image: registry.example.com/team/api
  interval: 5m
  secretRef:
    name: registry-read
---
apiVersion: image.toolkit.fluxcd.io/v1beta2
kind: ImagePolicy
meta
  name: api
  namespace: flux-system
spec:
  imageRepositoryRef:
    name: api
  policy:
    semver:
      range: ">=1.4.0 <2.0.0"

range 表示只接受 1.4.0 及以上、2.0.0 以下的语义化版本。若镜像标签包含 v 前缀或其他非标准格式,应先确认仓库标签能否被当前策略解析;不能解析的标签不会因为“看起来更新”就自动满足语义化版本规则。生产环境通常也应明确是否接纳预发布版本,并避免使用会被重复覆盖的 latest 等可变标签。

interval 控制扫描频率,不代表在整点或某个指定时间执行。较短间隔能更快发现新版本,但会增加对镜像仓库的查询;实际取值应结合仓库规模、发布频率和运维窗口确定。若只允许在维护窗口更新,单靠缩短或延长扫描间隔不能实现严格的定时发布,需要额外的审批或发布流程来控制版本何时进入生产配置。

在清单中标记可自动更新的镜像

自动化只应修改明确授权的字段。在 Deployment 的镜像行添加策略标记,告诉 Flux 应使用哪一个 ImagePolicy:

apiVersion: apps/v1
kind: Deployment
meta
  name: api
  namespace: production
spec:
  replicas: 3
  selector:
    matchLabels:
      app: api
  template:
    meta
      labels:
        app: api
    spec:
      containers:
        - name: api
          image: registry.example.com/team/api:1.4.2 # {"$imagepolicy": "flux-system:api"}
          ports:
            - name: http
              containerPort: 8080

flux-system:api 指向 flux-system 命名空间下名为 api 的策略。自动化会依据策略选出的版本更新带有标记的镜像字段;未标记的镜像字段不应被视为本项自动更新的目标。若同一应用有多个容器,需逐一决定哪些容器允许自动更新,并为它们配置正确的策略标记。

将这份 Deployment 放入 ImageUpdateAutomation 的 update.path 所指向的目录。该目录应与实际清单路径对应,并尽量只包含允许自动修改的文件,便于审核差异和限制机器人权限。

将新版本写入 Git 并部署

先确保 Flux 已有读取配置仓库的 GitRepository。以下示例展示主分支配置源;仓库地址和读取凭据按实际环境填写,凭据应存放在对应命名空间的 Secret 中。

apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
meta
  name: cluster-config
  namespace: flux-system
spec:
  interval: 1m
  url: ssh://git@example.com/platform/cluster-config.git
  ref:
    branch: main
  secretRef:
    name: git-read

再创建镜像更新自动化资源。update.path 是仓库内的相对路径,git.push.secretRef 指向具有推送权限的凭据。读取仓库和推送仓库可以使用不同的身份,实际权限应尽量收窄到所需仓库和分支。

apiVersion: image.toolkit.fluxcd.io/v1beta2
kind: ImageUpdateAutomation
meta
  name: api-images
  namespace: flux-system
spec:
  interval: 10m
  sourceRef:
    kind: GitRepository
    name: cluster-config
  git:
    checkout:
      ref:
        branch: main
    commit:
      authorName: flux-bot
      authorEmail: flux-bot@example.com
      messageTemplate: "更新应用镜像"
    push:
      branch: main
  update:
    path: ./clusters/prod/apps
    strategy: Setters

示例把变更直接推送到 main。如果生产环境要求代码审核,可以将推送目标设为自动化分支,并由现有代码评审流程创建或处理合并请求;还要确认自动化分支的更新能被配置源和后续合并流程正确识别。不要因为希望全自动而给机器人不必要的仓库管理权限。

让部署控制器监听生产目录,并等待应用状态达到预期。prune: true 会删除已从该目录移除的受管资源;启用前要确认目录边界,避免误删不属于该应用的对象。

apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
meta
  name: prod-apps
  namespace: flux-system
spec:
  interval: 5m
  path: ./clusters/prod/apps
  prune: true
  sourceRef:
    kind: GitRepository
    name: cluster-config
  healthChecks:
    - apiVersion: apps/v1
      kind: Deployment
      name: api
      namespace: production
  timeout: 3m

镜像更新间隔和配置同步间隔是两个不同的节奏。例如镜像扫描设置为每 5 分钟一次,自动化写入 Git 后,配置源和部署资源还要各自完成同步。因而“发现新标签”不等于“应用已成功上线”,监控时应分别关注镜像策略、Git 提交和工作负载状态。

失败时如何暂停与回滚

自动化更新前应在持续集成流程中执行必要检查,例如镜像构建、单元测试、镜像扫描和部署清单校验。GitOps 负责让期望配置可追踪并持续协调,不会自动证明新镜像没有应用缺陷,也不等同于镜像安全审查。

出现发布问题时,先确认变更对应的 Git 提交和实际部署镜像,再决定恢复配置还是暂停后续更新:

失败时如何暂停与回滚配图

  • 若新镜像未达到健康检查条件,先检查 Deployment 事件、容器状态和应用日志,确认失败发生在拉取镜像、容器启动还是应用就绪阶段。
  • 若需恢复上一版本,可在配置仓库中回退引入问题镜像的提交,或提交恢复到已知版本的清单变更。Flux 会按仓库中的期望状态重新协调集群。
  • 若策略仍会再次选中问题版本,应先调整版本范围、排除该标签,或按发布流程暂停镜像自动更新,再恢复配置。否则即使回滚清单,自动化也可能再次写入同一个版本。
  • 若使用可变标签,Git 中恢复到相同标签并不保证镜像内容恢复。使用不可变版本标签,并保留上一版本镜像,回滚目标才更明确。

回退 Git 提交会改变仓库历史中的有效配置,但不一定能撤销数据库迁移等应用自身的数据变更。涉及数据结构变化时,应为迁移设计兼容策略和恢复方案;不要把镜像回滚等同于数据回滚。

检查自动化运行状态

可以先查看镜像资源、更新自动化和部署资源的状态:

kubectl get imagerepositories,imagepolicies,imageupdateautomations -A
kubectl get gitrepositories -n flux-system
kubectl get kustomizations.kustomize.toolkit.fluxcd.io -A
kubectl describe imagepolicy api -n flux-system

排查时将状态与 Git 提交对应起来:镜像仓库是否成功扫描、策略当前选择了哪个标签、自动化是否产生提交、配置源是否读到了该提交,以及 Deployment 是否拉取并运行了目标镜像。若扫描正常但没有新提交,检查标签是否符合策略以及清单是否包含正确标记;若 Git 已有更新但集群未变化,检查配置同步状态、清单路径和部署健康检查结果。

配置稳定后,还应定期核对三类边界:镜像策略允许的版本范围是否仍符合发布要求,Git 自动化账号的写入范围是否过宽,回滚版本和凭据恢复流程是否仍可用。这样,镜像更新才能从“自动发现新标签”延伸为可审核、可验证、可恢复的集群发布流程。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9835.html