Kubernetes-Installation (Helm)

SchnellinstallationCopy Anchor Link

Installieren Sie in einen eigenen Namespace und setzen Sie eigene Zugangsdaten sowie eine realistische Datengröße:

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

Beobachten Sie, wie die Pods starten:

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

Bereitstellungsmodus wählenCopy Anchor Link

Das Chart unterstützt zwei Modi, die Sie über die mode-Values auswählen:

• Standalone entspricht einem einzelnen Knoten mit einer Festplatte: Es gibt keine Erasure-Coding-Redundanz über Knoten hinweg. Verwenden Sie diesen Modus für Entwicklung, Tests oder kleine Umgebungen, in denen der zugrunde liegende Speicher selbst für Dauerhaftigkeit sorgt. Vorhandene PVCs lassen sich über mode.standalone.existingClaim.dataClaim und mode.standalone.existingClaim.logsClaim wiederverwenden.
• Verteilt verhält sich wie mehrere Knoten, mehrere Festplatten: Objekte werden per Erasure Coding über Pods und PVCs verteilt. replicaCount legt die Anzahl der Pods fest (>= 2) und drivesPerNode die Anzahl der Daten-PVCs pro Pod (>= 1). Daraus ergeben sich insgesamt replicaCount * drivesPerNode Laufwerke. Wenn drivesPerNode nicht gesetzt ist (null), leitet das Chart 4 Daten-PVCs pro Pod ab, wenn replicaCount den Wert 4 hat (insgesamt 16 Laufwerke), und 1 Daten-PVC pro Pod für jeden anderen Wert von replicaCount (etwa replicaCount: 16 für 16 Pods mit je einem PVC). Setzen Sie replicaCount und drivesPerNode ausdrücklich (zum Beispiel replicaCount: 4 und drivesPerNode: 2 für 8 Laufwerke), um einen anderen Aufbau zu wählen.

# 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>

Speicher dimensionierenCopy Anchor Link

Die PVC-Größen stammen aus dem Block storageclass:

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

Wenn Sie config.rustfs.obs_log_directory auf "" setzen, werden die Protokoll-PVCs zusammen mit den zugehörigen Einhängungen deaktiviert. Eigene PVC-Annotationen tragen Sie unter storageclass.pvcAnnotations.data und storageclass.pvcAnnotations.logs ein.

IntegritätsprüfungenCopy Anchor Link

Das Chart erzeugt standardmäßig HTTP-Probes auf dem S3-Port (9000), passend zu den Integritätsendpunkten des Servers:

• Liveness: GET /health (livenessProbe.httpGet.path), anfängliche Verzögerung 30s, Intervall 5s
• Readiness (Bereitschaft): GET /health/ready (readinessProbe.httpGet.path), anfängliche Verzögerung 10s, Intervall 5s

Ein Pod wird den Service-Endpunkten erst hinzugefügt, nachdem /health/ready den Status 200 zurückgibt. Im verteilten Modus setzt das voraus, dass das Speicher-Quorum erreicht ist. Schwellenwerte und Zeitintervalle lassen sich über die Values livenessProbe.* und readinessProbe.* anpassen.

Härtung für den ProduktivbetriebCopy Anchor Link

Pod Disruption BudgetCopy Anchor Link

Standardmäßig deaktiviert. Aktivieren Sie es, damit freiwillige Evictions (Node-Drains, Cluster-Upgrades) nie mehr als einen Pod gleichzeitig entfernen:

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

Anti-Affinität und Topology SpreadCopy Anchor Link

affinity.podAntiAffinity.enabled ist standardmäßig true mit topologyKey: kubernetes.io/hostname und verteilt Pods auf unterschiedliche Nodes. Für eine Verteilung auf Zonenebene aktivieren Sie topologySpreadConstraints.enabled und tragen die Constraint-Einträge unverarbeitet unter topologySpreadConstraints.constraints ein. Sie gelten für das verteilte StatefulSet.

mTLS zwischen Pods (cert-manager)Copy Anchor Link

Setzen Sie mtls.enabled=true, um den Verkehr zwischen Pods zu verschlüsseln. Das Chart erzeugt cert-manager-Ressourcen vom Typ Issuer und Certificate für eine CA sowie für Server- und Client-Zertifikate. Um einen Issuer zu verwenden, den Sie bereits betreiben, setzen Sie mtls.existingIssuerRef.enabled=true zusammen mit name, kind (Issuer oder ClusterIssuer) und group.

Ingress und Gateway APICopy Anchor Link

Ingress ist standardmäßig aktiviert (ingress.enabled=true) mit ingress.className: nginx. Setzen Sie den Wert auf traefik, wenn das Ihr Controller ist. Das Chart setzt dann die passenden Annotations für Session-Stickiness. Legen Sie Ihre Domain über ingress.hosts[0].host fest (Standard example.rustfs.com). Aktivieren Sie für HTTPS ingress.tls.enabled und übergeben Sie das Zertifikat entweder mit --set-file ingress.tls.crt=./tls.crt --set-file ingress.tls.key=./tls.key, verweisen Sie auf ein vorhandenes Secret (ingress.tls.existingSecret) oder lassen Sie cert-manager eines ausstellen (ingress.tls.certManager.enabled=true).

Das Chart unterstützt außerdem die Gateway API im Alpha-Status (gatewayApi.enabled=true zusammen mit ingress.enabled=false, Traefik-Gateway-Klasse) und erzeugt die Ressourcen Gateway und HTTPRoute.

Auf RustFS zugreifenCopy Anchor Link

Ohne Ingress leiten Sie den Service per Port-Forward weiter:

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

• S3-API: http://localhost:9000
• Console (Weboberfläche): http://localhost:9001

Melden Sie sich an der Console mit dem Zugriffsschlüssel und dem geheimen Zugriffsschlüssel an, die Sie bei der Installation gesetzt haben. Wenn Ingress aktiviert ist, verwenden Sie stattdessen den konfigurierten Host (prüfen Sie das mit kubectl -n rustfs get ing). Der Service ist standardmäßig ClusterIP. Über service.type können Sie auf NodePort wechseln (S3 über service.endpoint.nodePort: 32000, Console über service.console.nodePort: 32001) oder auf LoadBalancer.

Mit Speicherpools skalierenCopy Anchor Link

Im verteilten Modus kann das Chart mehrere Speicherpools betreiben: unabhängige StatefulSets, deren Laufwerke zusammen einen Cluster bilden. Das entspricht auf Chart-Ebene dem Hinzufügen eines Speicherpools, wie unter Speicherpool-Erweiterung beschrieben.

Um eine bestehende Bereitstellung zu erweitern, aktivieren Sie Pools und beschreiben Sie das aktuelle Layout als Pool 0 plus die neue Kapazität:

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

Wenden Sie die Änderung anschließend mit helm upgrade an. Jeder Eintrag kann replicaCount (>= 2), einen Block storageclass oder beides setzen. Ausgelassene Felder erben die Werte der obersten Ebene. Wenn drivesPerNode auf oberster Ebene ausdrücklich gesetzt ist, gilt diese Laufwerkszahl für jeden Pool. Wenn drivesPerNode nicht gesetzt ist (null), leitet das Chart die Laufwerkszahl pro Pool aus dem replicaCount dieses Pools ab (4 Laufwerke pro Pod, wenn replicaCount den Wert 4 hat, sonst 1 Laufwerk pro Pod). Weitere Pools werden als StatefulSets <fullname>-pool<N> erzeugt. Alle Pools teilen sich den Headless Service, den Haupt-Service, die Konfiguration und die Zugangsdaten.

Was während des Rollouts zu erwarten ist, laut Dokumentation des Charts:

• Rechnen Sie mit Neustarts. Pods starten neu, bis jeder Pod in jedem Pool auflösbar ist. Der Server startet nicht, wenn Peer-Adressen nicht aufgelöst werden können. Erwarten Sie daher einige Crash-Loops, bevor der Cluster konvergiert. Das ist unbedenklich.
• Führen Sie anschließend ein Rebalancing aus. Nachdem der Cluster konvergiert ist, führen Sie rc admin rebalance start <alias> aus, um vorhandene Objekte auf den neuen Pool zu verteilen.
• Das PodDisruptionBudget umfasst alle Pools. Mit dem Standard pdb.maxUnavailable: 1 darf höchstens ein Pod des gesamten Clusters gleichzeitig entfernt werden.

DeinstallationCopy Anchor Link

helm uninstall rustfs -n rustfs