Flux:GitOps 的先行者
引言
在云原生时代之前,应用的部署往往依赖人工登录服务器、执行脚本、手动修改配置。这种模式不仅容易出错,而且难以审计。Flux 的出现,正是为了把”部署”这件事变成声明式的、可自动收敛的、可审计的——也就是今天我们熟知的 GitOps。
fluxcd/flux 是 Flux 家族的第一代项目(也是 Weaveworks 发起的原版)。它让”Git 仓库成为集群状态的唯一事实来源”这一理念真正落地。理解它,是理解整个 GitOps 生态的起点。
一、Flux 解决什么问题?
传统的 CI/CD 流水线是 push 模式:流水线拿到镜像,然后主动去集群执行 kubectl apply 或 helm install。
这种做法有几处痛点:
- 集群凭证外泄风险:CI 系统必须持有目标集群的高权限 kubeconfig。
- 状态漂移无人知:有人手动
kubectl edit改了东西,集群就和 Git 不一致了,没人发现。 - 回滚靠记忆:出了问题,靠人回忆”上次改了什么”。
Flux 换成 pull 模式:
- Flux 运行在集群内部,主动去”拉”Git 仓库。
- Git 是唯一事实来源(Single Source of Truth)。
- 集群状态一旦偏离 Git,Flux 自动发现并收敛回去。
- 回滚 =
git revert,审计 =git log。
二、架构核心
原版 Flux 由两个主要组件构成:
1. flux-agent(daemon)
常驻在集群里的守护进程,职责是:
- 监控镜像仓库:定期查询镜像仓库,发现新 tag。
- 同步 Git:监听 Git 仓库(可以是轮询,也可以通过 webhook 触发)。
- 应用清单:把 Git 里的 YAML 应用到集群。
- 自动升级:如果配置了
fluxcd.io/automated注解,会发现新镜像后自动更新清单并提交回 Git(或直接改集群对象)。
2. fluxctl(命令行工具)
与 agent 交互的 CLI:
fluxctl list-workloads:列出所有被管理的 workload。fluxctl list-images:查看可用的镜像 tag。fluxctl sync:手动触发一次 Git 同步。fluxctl release:手动触发一次镜像升级。fluxctl policy:设置自动化策略。
这种 “一个常驻 agent + 一个操控 CLI” 的设计非常朴素,却把 GitOps 的核心循环表达得很清晰。
核心同步循环
Git Repo ──(clone/pull)──► flux-agent ──(apply)──► Kubernetes
▲ │
│ │ 监听镜像仓库
└────(可选: 自动提交)────────┘
▼
Image Registry
agent 里有一个 cluster 对象(管理集群状态)和一个 registry 客户端(管理镜像)。当镜像更新策略被触发时,agent 会修改本地清单、应用到集群,并(在 write-back 模式下)把改动 commit 回 Git。
三、关键概念
1. Manifest(清单)
Flux 读取 Git 仓库里的 Kubernetes YAML。一条 workload 通过注解声明自己是否要被自动管理:
apiVersion: apps/v1
kind: Deployment
metadata:
name: podinfo
annotations:
fluxcd.io/automated: "true"
fluxcd.io/tag.podinfo: semver:~1.0
spec:
template:
spec:
containers:
- name: podinfo
image: quay.io/stefanprodan/podinfo:1.2.1
这里的 fluxcd.io/automated 和 fluxcd.io/tag.<container> 就是 Flux 的”魔法注释”,用来声明自动更新策略。
2. 镜像更新策略(Policy)
Flux 支持非常细粒度的 tag 过滤策略:
| 策略 | 含义 |
|---|---|
semver:~1.0 |
匹配符合 semver 范围的最新版本 |
glob:1.0.* |
glob 通配匹配 |
regexp:^1\.0\..*$ |
正则匹配 |
semver:* |
任意 semver |
这套策略让”自动跟随某个版本线”变得自然——比如让小版本自动升级,大版本必须人工干预。
3. 两种工作模式
- Sync 模式:Git → 集群单向同步。
- Automated 模式:在 Sync 基础上,agent 还会把镜像更新写回 Git(write-back),形成完整闭环。这需要给 agent 配置一个有 push 权限的 deploy key。
四、快速上手(示例)
1) 部署 Flux 到集群
helm repo add fluxcd https://charts.fluxcd.io helm install flux fluxcd/flux \ --namespace flux \ --set git.url=git@github.com:your-org/your-config-repo \ --set git.path=clusters/production
2) 生成部署密钥
fluxctl identity --k8s-fwd-ns flux
把输出的公钥加到 Git 仓库的 Deploy Keys(若需 write-back,勾选 write 权限)。
3) 触发同步
fluxctl sync --k8s-fwd-ns flux
4) 查看受管 workload 与镜像
fluxctl list-workloads --k8s-fwd-ns flux fluxctl list-images --k8s-fwd-ns flux
5) 手动/策略升级
# 手动把一个 deployment 升到指定镜像 fluxctl release --k8s-fwd-ns flux \ --workload=default:deployment/podinfo \ --update-image=quay.io/stefanprodan/podinfo:1.3.0
配合 fluxcd.io/automated: "true",后续的新版本就会被自动跟随。
五、设计上的亮点与局限
亮点:
- 权限模型更安全:集群凭证不出集群,CI 无需持有 kubeconfig。
- 状态收敛:agent 持续对账,手动改动会被纠正(漂移检测)。
- Git 即审计日志:谁、何时、改了什么,一目了然。
- 镜像策略灵活:semver/glob/regexp 让”自动跟随”可控可预期。
局限(也是它被下一代取代的原因):
- 只管理镜像更新这一维度,YAML 组织方式较单一,缺少多租户、组合、依赖管理能力。
- 单 agent 架构,大规模集群下可扩展性受限。
- 注解驱动的策略表达力有限。
- 与 Helm、Kustomize 的深度集成能力不足。
六、从 Flux v1 到 Flux v2
原版 fluxcd/flux 后来演进为 Flux v2(现由 CNCF 托管的 fluxcd/flux2),架构上做了大重构:
- 基于控制器与 CRD:
GitRepository、Kustomization、HelmRelease、HelmRepository等资源各自实现 Reconcile 循环。 - 组合式:源码控制器 + Kustomize 控制器 + Helm 控制器解耦,通过 CRD 编排。
- 可扩展:每个控制器都能独立部署、独立扩展。
- 多租户友好:借助 namespace 隔离与 RBAC。
可以说,v1 证明了 GitOps 这条路走得通,v2 则把它工程化、产品化。
七、你是否还应该用 v1?
如果你的场景是:
- 已有一套基于原版 Flux 的存量系统,短期不打算迁移;
- 只需要”镜像自动更新 + Git 同步”这一核心能力;
- 希望架构尽量简单、组件尽量少。
那么 fluxcd/flux 仍然可用(但请注意它已进入维护/弃用状态,官方主推 v2)。
而对于新项目,强烈建议直接使用 Flux v2。不过,把 v1 吃透,对理解任何 GitOps 工具——包括 Argo CD、Flux v2——都会有巨大帮助,因为它们的灵魂是同一个:让集群向 Git 收敛。
结语
fluxcd/flux 不是最”新”的工具,但它是把 GitOps 从概念变成生产力的关键一步。它的设计极其克制:一个 agent、一个 CLI、一个同步循环、一套镜像策略,却完整覆盖了声明式部署、自动收敛、自动升级和可审计回滚。
读懂它,你读懂的不仅是一个项目,而是云原生部署范式的一次范式转移——从”我推你部署”,到”你自己对齐 Git”。
参考:https://github.com/fluxcd/flux




还没有评论,来说两句吧...