Kubernetes 安装（Helm）

快速安装

安装到专用命名空间，并设置自己的凭证和实际的数据容量：

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

选择部署模式

该 chart 支持通过 mode 值选择两种模式：

• 单机模式对应单节点单磁盘：节点之间不提供纠删码冗余。适用于开发、测试或底层存储自身提供持久性的小型部署。它可以通过 mode.standalone.existingClaim.dataClaim / mode.standalone.existingClaim.logsClaim 复用现有 PVC。
• 分布式模式的行为类似多节点多磁盘：对象通过纠删码分布到各 Pod 和 PVC。replicaCount 必须为 4（每个 Pod 获得 4 个 PVC）或 16（每个 Pod 获得 1 个 PVC）；请根据集群能够将 Pod 分布到多少个节点来选择。

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

存储容量规划

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 下。

健康探针

chart 默认在 S3 端口（9000）上设置 HTTP 探针，与服务器的健康检查端点一致：

• 存活探针：GET /health（livenessProbe.httpGet.path），初始延迟 30s，周期 5s
• 就绪探针：GET /health/ready（readinessProbe.httpGet.path），初始延迟 10s，周期 5s

只有当 /health/ready 返回 200 后，Pod 才会添加到 Service 端点。在分布式模式下，这要求满足存储仲裁。可通过 livenessProbe.* 和 readinessProbe.* 值调整阈值和时间。

生产环境加固

Pod Disruption Budget

默认禁用。启用后，自愿中断（节点排空、集群升级）一次不会导致超过一个 Pod 停止：

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

反亲和性和拓扑分布

affinity.podAntiAffinity.enabled 默认为 true，并使用 topologyKey: kubernetes.io/hostname 将 Pod 分布到不同节点。对于可用区级分布，请启用 topologySpreadConstraints.enabled，并在 topologySpreadConstraints.constraints 下提供原始约束条目（应用于分布式 StatefulSet）。

Pod 间 mTLS（cert-manager）

设置 mtls.enabled=true 可加密 Pod 之间的流量；chart 会为 CA、服务器和客户端证书渲染 cert-manager Issuer/Certificate 资源。要使用已在运维的 issuer，请设置 mtls.existingIssuerRef.enabled=true，并提供其 name、kind（Issuer 或 ClusterIssuer）和 group。

Ingress 和 Gateway API

Ingress 默认启用（ingress.enabled=true），且 ingress.className: nginx；如果使用 Traefik 控制器，请将其设置为 traefik，chart 会为各控制器应用匹配的会话粘性注解。通过 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）。

该 chart 还提供 alpha 阶段的 Gateway API 支持（同时设置 gatewayApi.enabled=true 和 ingress.enabled=false，使用 Traefik gateway class），并渲染 Gateway 和 HTTPRoute 资源。

访问 RustFS

没有 ingress 时，对 Service 进行端口转发：

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

• S3 API：http://localhost:9000
• 控制台：http://localhost:9001

使用安装时设置的访问密钥和秘密密钥登录控制台。启用 ingress 后，改用配置的主机（运行 kubectl -n rustfs get ing 检查）。Service 默认为 ClusterIP；可将 service.type 切换为 NodePort（S3 使用 service.endpoint.nodePort: 32000，控制台使用 service.console.nodePort: 32001）或 LoadBalancer。

使用服务器池横向扩容

在分布式模式下，chart 可以运行多个服务器池，每个服务器池都是独立的 StatefulSet，其驱动器共同组成一个集群。这相当于在 chart 层添加存储池扩容中所述的服务器池。

要扩展现有部署，请启用存储池，并将当前布局描述为存储池 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 (4 or 16)
      storageclass:
        dataStorageSize: 10Gi

然后使用 helm upgrade 应用。每个条目可以设置 replicaCount（4 或 16）和/或 storageclass 区块；省略的字段继承顶层值。其他存储池渲染为 <fullname>-pool<N> StatefulSet；所有存储池共享无头 Service、主 Service、配置和凭证。

根据 chart 文档，滚动更新期间会出现以下情况：

• 崩溃/重启循环属于正常现象。 Pod 会不断重启，直到所有存储池的所有 Pod 都能解析。服务器拒绝在存在无法解析的对等节点时启动，因此集群收敛前可能出现几次崩溃循环。这不会造成损害。
• 之后重新平衡。 集群收敛后，运行 rc admin rebalance start <alias> 将现有对象分布到新存储池。
• PodDisruptionBudget 跨所有存储池生效：使用默认 pdb.maxUnavailable: 1 时，整个集群一次最多驱逐一个 Pod。

卸载

helm uninstall rustfs -n rustfs