本文作者:icy

Golang-Flux:GitOps 的先行者

icy 昨天 23 抢沙发
Golang-Flux:GitOps 的先行者摘要: Flux:GitOps 的先行者 项目地址:https://github.com/fluxcd/flux 引言 在云原生时代之前,应用的部署往往依赖人工登录服务器、执行脚本、手动修...

Golang-Flux:GitOps 的先行者

Flux:GitOps 的先行者

项目地址:https://github.com/fluxcd/flux

引言

在云原生时代之前,应用的部署往往依赖人工登录服务器、执行脚本、手动修改配置。这种模式不仅容易出错,而且难以审计。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 的核心循环表达得很清晰。

核心同步循环

Plain text
   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 通过注解声明自己是否要被自动管理:

YAML
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 到集群

Bash
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) 生成部署密钥

Bash
fluxctl identity --k8s-fwd-ns flux

把输出的公钥加到 Git 仓库的 Deploy Keys(若需 write-back,勾选 write 权限)。

3) 触发同步

Bash
fluxctl sync --k8s-fwd-ns flux

4) 查看受管 workload 与镜像

Bash
fluxctl list-workloads --k8s-fwd-ns flux
fluxctl list-images --k8s-fwd-ns flux

5) 手动/策略升级

Bash
# 手动把一个 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

flux_20261110184057.zip
类型:压缩文件|已下载:0|下载方式:免费下载
立即下载
文章版权及转载声明

作者:icy本文地址:https://zelig.cn/golang/1500.html发布于 昨天
文章转载或复制请以超链接形式并注明出处软角落-SoftNook

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏

阅读
分享

发表评论

快捷回复:

评论列表 (暂无评论,23人围观)参与讨论

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