Installation Kubernetes (Helm)

Installation rapideCopy Anchor Link

Installez le chart dans un espace de noms dédié, en définissant vos propres identifiants et une taille de données réaliste :

helm install rustfs . \
  --namespace rustfs --create-namespace \
  --set secret.rustfs.access_key=<your-access-key> \
  --set secret.rustfs.secret_key=<your-secret-key> \
  --set storageclass.dataStorageSize=100Gi \
  --set storageclass.logStorageSize=1Gi

Observez le démarrage des pods :

kubectl -n rustfs get pods -w

NAME       READY   STATUS    RESTARTS   AGE
rustfs-0   1/1     Running   0          2m27s
rustfs-1   1/1     Running   0          2m27s
rustfs-2   1/1     Running   0          2m27s
rustfs-3   1/1     Running   0          2m27s

Choisir un mode de déploiementCopy Anchor Link

Le chart prend en charge deux modes, sélectionnés par les valeurs mode :

• Autonome correspond au mode un nœud, un seul disque : aucune redondance par codage d’effacement entre les nœuds. Utilisez-le pour le développement, les tests ou les petits déploiements dans lesquels le stockage sous-jacent assure sa propre durabilité. Il peut réutiliser des PVC existants via mode.standalone.existingClaim.dataClaim / mode.standalone.existingClaim.logsClaim.
• Distribué se comporte comme plusieurs nœuds, plusieurs disques : les objets sont répartis par codage d’effacement entre les pods et les PVC. replicaCount définit le nombre de pods (>= 2) et drivesPerNode définit le nombre de PVC de données par pod (>= 1), soit replicaCount * drivesPerNode disques au total. Lorsque drivesPerNode n’est pas défini (null), le chart déduit 4 PVC de données par pod lorsque replicaCount vaut 4 (16 disques au total) et 1 PVC de données par pod pour toute autre valeur de replicaCount (par exemple, replicaCount: 16 pour 16 pods avec 1 PVC chacun). Définissez explicitement à la fois replicaCount et drivesPerNode (par exemple, replicaCount: 4 et drivesPerNode: 2 pour 8 disques) afin de choisir une autre disposition.

# Standalone mode
helm install rustfs . -n rustfs --create-namespace \
  --set mode.standalone.enabled=true \
  --set mode.distributed.enabled=false \
  --set secret.rustfs.access_key=<your-access-key> \
  --set secret.rustfs.secret_key=<your-secret-key>

Dimensionnement du stockageCopy Anchor Link

Les tailles de PVC proviennent du bloc storageclass :

storageclass:
  name: local-path        # your StorageClass
  dataStorageSize: 256Mi  # per data PVC
  logStorageSize: 256Mi   # per logs PVC

Définir config.rustfs.obs_log_directory sur "" désactive entièrement les PVC de journaux et leurs montages. Les annotations de PVC personnalisées se placent sous storageclass.pvcAnnotations.data / storageclass.pvcAnnotations.logs.

Sondes d’intégritéCopy Anchor Link

Le chart génère par défaut des sondes HTTP sur le port S3 (9000), alignées sur les points de terminaison d’intégrité du serveur :

• Vivacité : GET /health (livenessProbe.httpGet.path), délai initial de 30 s, période de 5 s
• État de préparation : GET /health/ready (readinessProbe.httpGet.path), délai initial de 10 s, période de 5 s

Un pod n’est ajouté aux points de terminaison du Service qu’une fois que /health/ready renvoie 200, ce qui, en mode distribué, exige que le quorum de stockage soit atteint. Les seuils et les temporisations se règlent au moyen des valeurs livenessProbe.* et readinessProbe.*.

Durcissement pour la productionCopy Anchor Link

Budget de perturbation des podsCopy Anchor Link

Désactivé par défaut. Activez-le afin que les évictions volontaires (drainage de nœuds, mises à niveau du cluster) ne mettent jamais hors service plus d’un pod à la fois :

--set pdb.create=true    # pdb.maxUnavailable defaults to 1

Anti-affinité et répartition topologiqueCopy Anchor Link

affinity.podAntiAffinity.enabled vaut true par défaut, avec topologyKey: kubernetes.io/hostname, ce qui répartit les pods sur des nœuds distincts. Pour une répartition au niveau des zones, activez topologySpreadConstraints.enabled et fournissez des entrées de contrainte brutes sous topologySpreadConstraints.constraints (appliquées au StatefulSet distribué).

mTLS entre pods (cert-manager)Copy Anchor Link

Définissez mtls.enabled=true pour chiffrer le trafic entre les pods ; le chart génère des ressources cert-manager Issuer/Certificate pour une autorité de certification, ainsi que des certificats serveur et client. Pour utiliser un émetteur que vous exploitez déjà, définissez mtls.existingIssuerRef.enabled=true avec son name, son kind (Issuer ou ClusterIssuer) et son group.

Ingress et Gateway APICopy Anchor Link

L’Ingress est activé par défaut (ingress.enabled=true) avec ingress.className: nginx ; définissez cette valeur sur traefik si c’est votre contrôleur — le chart applique, pour chacun, les annotations d’affinité de session correspondantes. Définissez votre domaine via ingress.hosts[0].host (par défaut example.rustfs.com). Pour HTTPS, activez ingress.tls.enabled, puis transmettez le certificat avec --set-file ingress.tls.crt=./tls.crt --set-file ingress.tls.key=./tls.key, pointez vers un secret existant (ingress.tls.existingSecret), ou laissez cert-manager en émettre un (ingress.tls.certManager.enabled=true).

Le chart prend également en charge, en version alpha, la Gateway API (gatewayApi.enabled=true conjointement avec ingress.enabled=false, classe de passerelle Traefik) et génère des ressources Gateway et HTTPRoute.

Accéder à RustFSCopy Anchor Link

Sans Ingress, redirigez les ports du Service :

kubectl -n rustfs port-forward svc/rustfs 9000:9000 9001:9001

• API S3 : http://localhost:9000
• Console : http://localhost:9001

Connectez-vous à la Console avec la clé d’accès et la clé secrète définies lors de l’installation. Lorsque l’Ingress est activé, utilisez plutôt l’hôte que vous avez configuré (vérifiez avec kubectl -n rustfs get ing). Le Service utilise ClusterIP par défaut ; service.type peut être basculé vers NodePort (S3 sur service.endpoint.nodePort: 32000, Console sur service.console.nodePort: 32001) ou LoadBalancer.

Monter en charge avec des pools de serveursCopy Anchor Link

En mode distribué, le chart peut exécuter plusieurs pools de serveurs — des StatefulSets indépendants dont les disques forment ensemble un seul cluster. Cela correspond, au niveau du chart, à l’ajout d’un pool de serveurs décrit dans Extension de pool.

Pour étendre un déploiement existant, activez les pools et décrivez la disposition actuelle comme le pool 0, plus la nouvelle capacité :

pools:
  enabled: true
  list:
    - {}                  # pool 0: inherits top-level values and keeps the
                          # existing StatefulSet/pod/PVC names and data
    - replicaCount: 4     # pool 1: new capacity (replicaCount >= 2)
      storageclass:
        dataStorageSize: 10Gi

Appliquez ensuite la configuration avec helm upgrade. Chaque entrée peut définir replicaCount (>= 2) et/ou un bloc storageclass ; les champs omis héritent des valeurs de premier niveau. Lorsque le drivesPerNode de premier niveau est défini explicitement, ce nombre de disques s’applique à chaque pool ; lorsque drivesPerNode n’est pas défini (null), le chart déduit le nombre de disques de chaque pool à partir du replicaCount de ce pool (4 disques par pod lorsque replicaCount vaut 4, ou 1 disque par pod sinon). Les pools supplémentaires sont générés comme des StatefulSets <fullname>-pool<N> ; tous les pools partagent le service headless, le service principal, la configuration et les identifiants.

À quoi vous attendre pendant le déploiement, d’après la documentation du chart :

• Prévoyez des redémarrages. Les pods redémarrent jusqu’à ce que chaque pod de chaque pool soit résolvable — le serveur refuse de démarrer tant que des pairs ne sont pas résolvables. Attendez-vous donc à quelques boucles de plantage avant la convergence du cluster. Ce comportement est sans gravité.
• Rééquilibrez ensuite. Une fois le cluster convergé, exécutez rc admin rebalance start <alias> pour répartir les objets existants sur le nouveau pool.
• Le PodDisruptionBudget couvre tous les pools : avec la valeur par défaut pdb.maxUnavailable: 1, au plus un pod de l’ensemble du cluster peut être évincé à la fois.

DésinstallerCopy Anchor Link

helm uninstall rustfs -n rustfs