Flux

通过 Bucket source API，将 RustFS 作为 Flux CD 的 Kubernetes 清单来源。

本指南将 Kubernetes 的 GitOps 工具包 Flux CD 通过 source-controller 的 Bucket API 连接到 RustFS。你将向 RustFS 存储桶播种 Kubernetes 清单，把该桶注册为 generic provider 的 Flux Bucket source，并由 Kustomization 应用其中的全部内容。整个流程使用 flux v2.9.5（source-controller）在 k3s v1.36.4+k3s1 上对 rustfs/rustfs-x86-musl:v2.3.1 验证通过。

你需要一个已安装 Flux（flux install）的 Kubernetes 集群以及 rc 客户端。本部署用于本地集成测试，不适用于生产环境。

架构

source-controller 通过 S3 API 列举并下载桶内对象，打包为工件（artifact），kustomize-controller 再应用工件中的清单。RustFS 充当集群拉取式的事实来源。

播种存储桶

向桶内存放一个 Kustomize overlay，并替换全部连接占位符：

clusters/staging/kustomization.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - rustfs-demo-configmap.yaml

clusters/staging/rustfs-demo-configmap.yaml

apiVersion: v1
kind: ConfigMap
metadata:
  name: rustfs-flux-demo
  namespace: default
data:
  storage: rustfs
  source: s3-bucket

上传文件：

rc mb rustfs/flux-src
rc cp --recursive ./clusters rustfs/flux-src/
rc ls rustfs/flux-src/ -r

staging/kustomization.yaml
staging/rustfs-demo-configmap.yaml

创建凭证 secret

Flux 从与 source 同命名空间的 secret 中读取凭证，键名必须为小写：

kubectl -n flux-system create secret generic rustfs-creds \
  --from-literal=accesskey=<your-access-key> \
  --from-literal=secretkey=<your-secret-key>

字段名必须是 accesskey 和 secretkey——写成 accessKey 之类的大写形式会以 AuthenticationFailed 状态失败。

注册 Bucket source

使用 generic provider 创建 Bucket source：

flux create source bucket rustfs-demo \
  --bucket-name=flux-src \
  --endpoint=<your-rustfs-endpoint>:9000 \
  --insecure \
  --secret-ref=rustfs-creds \
  --provider=generic \
  --interval=30s \
  --namespace=flux-system

✔ Bucket source reconciliation completed

如果调和仍在进行，可用 flux get sources bucket 查看状态：

NAME        REVISION       SUSPENDED READY MESSAGE
rustfs-demo sha256:481816d1 False     True  stored artifact: revision 'sha256:481816d1'

generic provider 使用路径风格请求，配合 --insecure 走纯 HTTP，因此 endpoint 为裸 host:port。

应用清单

创建消费该工件的 Kustomization：

flux create kustomization rustfs-demo \
  --source=Bucket/rustfs-demo \
  --path="./staging" \
  --prune=true \
  --interval=30s \
  --namespace=flux-system

✔ applied revision sha256:481816d1

确认清单已落到集群：

kubectl -n default get configmap rustfs-flux-demo -o jsonpath="{.data}"

{"source":"s3-bucket","storage":"rustfs"}

停止或重置

保留桶内对象、挂起或删除 Flux 资源：

flux suspend source bucket rustfs-demo --namespace=flux-system
flux delete kustomization rustfs-demo --namespace=flux-system

删除桶内内容：

rc rm rustfs/flux-src/ --recursive --force

在启用更多 source 类型前，先阅读 S3 兼容性说明。
使用访问密钥管理创建专用的生产凭证。
按照 Flux Bucket source 文档将桶 source 与 Helm release、镜像自动化组合使用。

Flux

架构

播种存储桶

创建凭证 secret

注册 Bucket source

应用清单

停止或重置

故障排查

`invalid 'rustfs-creds' secret data: required fields 'accesskey' and 'secretkey'`

调和一直无法就绪

凭证有效仍报 `AuthenticationFailed`

下一步

本页目录