搭建 Flux GitOps 持续交付

适用场景

希望集群状态由 Git 持续对账，支持 Kustomize、Helm、镜像自动更新和多集群。Flux 比 Argo CD 更偏“控制器组合”，适合平台团队做 GitOps 基础设施。

前置条件

• Kubernetes 集群和 flux CLI。
• Git 仓库和访问凭据（Deploy Key 或 Token）。
• 明确 GitOps 仓库结构：clusters、apps、infra。
• 镜像仓库和自动更新策略。

步骤

1. 安装 Flux CLI 并检查：

flux --version
flux check --pre

2. Bootstrap 仓库：

export GITHUB_TOKEN=***
flux bootstrap github \
  --owner=example \
  --repository=gitops \
  --branch=main \
  --path=clusters/prod \
  --personal

3. 创建 GitRepository 和 Kustomization：

flux create source git apps \
  --url=https://github.com/example/apps.git \
  --branch=main \
  --interval=1m

flux create kustomization apps \
  --source=GitRepository/apps \
  --path=./apps/prod \
  --prune=true \
  --interval=5m

4. 部署 HelmRelease：

flux create helmrelease nginx \
  --source=HelmRepository/bitnami \
  --chart=nginx \
  --chart-version=18.0.0 \
  --namespace=demo \
  --interval=10m

5. 配置镜像自动更新：

flux create image repository app \
  --image=registry.example.com/app \
  --interval=5m

flux create image policy app \
  --image-ref=app \
  --select-semver='>=1.0.0'

flux create image update flux-system \
  --git-repo-ref=flux-system \
  --checkout-branch=main \
  --push-branch=main \
  --author-name=flux \
  --author-email=flux@example.com \
  --interval=10m

验证

• flux get all 显示所有资源 Ready=True。
• 修改 Git 中的镜像 tag，集群自动更新。
• flux reconcile 能立即触发对账。
• 镜像自动更新提交了新的 Git commit。
• 删除 Git 中的资源后，prune 清理集群对象。

回滚

• 在 Git 中 revert 提交，等待 Flux 对账。
• flux suspend 暂停自动对账，手工处理。
• 保留旧 HelmRelease 版本和镜像 tag。
• 升级 Flux 前备份 CRD 和 GitOps 仓库。

常见坑

• Bootstrap 的 token 权限不足，无法创建仓库或写入。
• path 写错，Flux 找不到 Kustomization。
• HelmRelease 的 chart 版本不存在或仓库索引过期。
• 镜像自动更新提交冲突，需要人工 rebase。
• prune=true 会删除 Git 中移除的资源，首次开启前确认范围。
• 多集群共享同一个 Git 仓库，路径和变量没有隔离。
• 没有配置通知，Flux 对账失败无人知晓。

相关命令

• flux — bootstrap、创建资源、对账和排查
• kubectl — 查看 Flux 控制器和资源
• helm — 检查 chart 版本
• git — 查看自动更新提交