Kubernetes インストール（Helm）

クイックインストールCopy Anchor Link

専用の名前空間へインストールし、独自の認証情報と実際の使用量に見合うデータサイズを設定します。

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

Pod の起動を確認します。

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

デプロイモードを選ぶCopy Anchor Link

チャートは、mode の値で選ぶ 2 つのモードに対応しています。

• スタンドアロンはシングルノード・シングルディスクに相当し、ノードをまたぐイレイジャーコーディングの冗長性はありません。開発、テスト、または基盤のストレージ自身が耐久性を提供する小規模な構成に使います。既存の PVC は mode.standalone.existingClaim.dataClaim / mode.standalone.existingClaim.logsClaim で再利用できます。
• 分散はマルチノード・マルチディスクと同様に動作し、オブジェクトは Pod と PVC にまたがってイレイジャーコーディングされます。replicaCount は Pod 数（>= 2）、drivesPerNode は Pod あたりのデータ PVC 数（>= 1）を指定し、合計ドライブ数は replicaCount * drivesPerNode になります。drivesPerNode を未設定（null）にすると、replicaCount が 4 のときは Pod あたりのデータ PVC を 4 つ（合計 16 ドライブ）、それ以外の replicaCount（たとえば Pod 16 台に PVC を 1 つずつ割り当てる replicaCount: 16）では Pod あたりのデータ PVC を 1 つと推定します。別の構成にするには replicaCount と drivesPerNode の両方を明示します（たとえば 8 ドライブにする場合は replicaCount: 4 と drivesPerNode: 2）。

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

ストレージ容量の設定Copy Anchor Link

PVC のサイズは storageclass ブロックで指定します。

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

config.rustfs.obs_log_directory を "" に設定すると、ログ用 PVC とマウントが完全に無効になります。PVC のカスタムアノテーションは storageclass.pvcAnnotations.data / storageclass.pvcAnnotations.logs に指定します。

ヘルスプローブCopy Anchor Link

チャートは、サーバーのヘルスエンドポイントに合わせ、S3 ポート（9000）の HTTP プローブを標準で含みます。

• Liveness（生存確認）: GET /health（livenessProbe.httpGet.path）。初期遅延は 30 秒、間隔は 5 秒です
• Readiness（準備完了）: GET /health/ready（readinessProbe.httpGet.path）。初期遅延は 10 秒、間隔は 5 秒です

Pod が Service のエンドポイントに追加されるのは、/health/ready が 200 を返したあとだけです。分散モードでは、この応答にストレージのクォーラムが満たされている必要があります。しきい値とタイミングは livenessProbe.* と readinessProbe.* の値で調整できます。

本番向けの強化Copy Anchor Link

PodDisruptionBudgetCopy Anchor Link

デフォルトでは無効です。有効にすると、自発的な退避（ノードのドレインやクラスターのアップグレード）で同時に停止する Pod は 1 つまでになります。

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

アンチアフィニティとトポロジースプレッドCopy Anchor Link

affinity.podAntiAffinity.enabled のデフォルトは true で、topologyKey: kubernetes.io/hostname により Pod を別々のノードへ分散します。ゾーン単位で分散するには topologySpreadConstraints.enabled を有効にし、topologySpreadConstraints.constraints に制約エントリをそのまま指定します（分散モードの StatefulSet に適用されます）。

Pod 間の mTLS（cert-manager）Copy Anchor Link

mtls.enabled=true にすると、Pod 間のトラフィックが暗号化されます。チャートは、CA、サーバー証明書、クライアント証明書用に、cert-manager の Issuer と Certificate リソースを生成します。既に運用している Issuer を使う場合は、mtls.existingIssuerRef.enabled=true とともに name、kind（Issuer または ClusterIssuer）、group を指定します。

Ingress と Gateway APICopy Anchor Link

Ingress はデフォルトで有効です（ingress.enabled=true）。ingress.className: nginx が設定されています。コントローラーが Traefik の場合は traefik にします。チャートは、コントローラーに対応するセッション固定のアノテーションを適用します。ドメインは ingress.hosts[0].host で設定します（デフォルトは example.rustfs.com）。HTTPS では ingress.tls.enabled を有効にし、--set-file ingress.tls.crt=./tls.crt --set-file ingress.tls.key=./tls.key で証明書を渡すか、既存の Secret を指定するか（ingress.tls.existingSecret）、cert-manager に発行させます（ingress.tls.certManager.enabled=true）。

チャートには、アルファ版の Gateway API サポートもあります（gatewayApi.enabled=true と ingress.enabled=false を併用し、Gateway クラスは Traefik）。Gateway と HTTPRoute リソースを生成します。

RustFS へアクセスするCopy Anchor Link

Ingress を使わない場合は、Service をポートフォワードします。

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

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

インストール時に設定したアクセスキーとシークレットキーで Console にログインします。Ingress を有効にしている場合は、設定したホストを使います（kubectl -n rustfs get ing で確認します）。Service のデフォルトは ClusterIP です。service.type は NodePort（S3 は service.endpoint.nodePort: 32000、Console は service.console.nodePort: 32001）または LoadBalancer に切り替えられます。

ストレージプールでスケールアウトするCopy Anchor Link

分散モードでは、チャートは複数のストレージプールを実行できます。各プールは独立した StatefulSet であり、それらのドライブがまとまって 1 つのクラスターを構成します。これは、ストレージプールの拡張で説明するストレージプールの追加を、チャート上で行う操作に相当します。

既存のデプロイを拡張するには、プールを有効にし、現在の構成をプール 0 として残したうえで、新しい容量を追記します。

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

その後、helm upgrade で適用します。各エントリでは replicaCount（>= 2）と storageclass ブロックの一方または両方を設定できます。省略したフィールドはトップレベルの値を継承します。トップレベルの drivesPerNode を明示すると、そのドライブ数はすべてのプールに適用されます。drivesPerNode を未設定（null）にすると、チャートは各プールの replicaCount からドライブ数を推定します（replicaCount が 4 のときは Pod あたり 4 ドライブ、それ以外は Pod あたり 1 ドライブ）。追加のプールは <fullname>-pool<N> という名前の StatefulSet として生成されます。すべてのプールは、ヘッドレス Service、メインの Service、設定、認証情報を共有します。

ロールアウト中に想定される動作は、チャートのドキュメントでは次のとおりです。

• 再起動を想定します。 すべてのプールですべての Pod が名前解決できるようになるまで、Pod は再起動します。解決できないピアがあるとサーバーは起動を拒否するため、クラスターが収束するまでにクラッシュループが数回発生することがあります。これは問題ありません。
• その後にリバランスします。 クラスターが収束したら、rc admin rebalance start <alias> を実行して、既存のオブジェクトを新しいプールへ分散します。
• PodDisruptionBudget はすべてのプールに適用されます。デフォルトの pdb.maxUnavailable: 1 では、クラスター全体で同時に退避できる Pod は最大 1 つです。

アンインストールCopy Anchor Link

helm uninstall rustfs -n rustfs