Flux

Ce guide connecte Flux CD — le kit d’outils GitOps pour Kubernetes — à RustFS via l’API Bucket du source-controller. Vous allez amorcer un compartiment (bucket) RustFS avec des manifestes Kubernetes, enregistrer ce compartiment comme source Flux Bucket avec le fournisseur generic, et laisser une Kustomization appliquer tout ce qu’il contient. Le flux a été validé avec flux v2.9.5 (source-controller) sur k3s v1.36.4+k3s1 face à rustfs/rustfs-x86-musl:v2.3.1.

Vous avez besoin d’un cluster Kubernetes avec Flux installé (flux install) et du client rc. Ce déploiement est destiné aux tests d’intégration locaux, pas à la production.

Schéma d’architectureCopy Anchor Link

Le source-controller répertorie et télécharge les objets du compartiment via l’API S3, les emballe dans un artefact, et le kustomize-controller applique les manifestes de cet artefact. RustFS sert de source de vérité du cluster, consommée par tirage (pull).

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - 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

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

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

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

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 suspend source bucket rustfs-demo --namespace=flux-system
flux delete kustomization rustfs-demo --namespace=flux-system

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

DépannageCopy Anchor Link

invalid 'rustfs-creds' secret data: required fields 'accesskey' and 'secretkey'Copy Anchor Link

Les clés du secret sont en minuscules. Recréez le secret avec accesskey et secretkey comme noms de clés littéraux.

La réconciliation ne passe jamais à l’état prêtCopy Anchor Link

Vérifiez que le point de terminaison est joignable depuis l’intérieur du cluster — les pods ne peuvent pas utiliser localhost, donc pointez la source vers l’adresse IP de l’hôte ou la passerelle du pont Docker (souvent 172.17.0.1) qui publie le port RustFS. --insecure est requis pour le HTTP non chiffré.

AuthenticationFailed malgré des identifiants validesCopy Anchor Link

Vérifiez que le secret se trouve dans le même espace de noms que la source Bucket et que les clés ne comportent ni espace final ni guillemets.

Étapes suivantesCopy Anchor Link

• Consultez les notes de compatibilité S3 avant d’adopter d’autres types de sources.
• Créez des identifiants de production dédiés avec la gestion des clés d’accès.
• Suivez la documentation des sources Bucket de Flux pour combiner les sources Bucket avec les releases Helm et l’automatisation d’images.