Rook-Ceph解説 3：rook-ceph・rook-ceph-cluster 1.21.1チャートのvaluesを読む

ステータス：ドラフト（2026-10-29）、チャート原文基準、実測なし。 値はいずれもRook v1.21.1 タグが指すコミット 09d2f0d8d883b70b30de796c4390371be725ff3b の deploy/charts/rook-ceph/values.yaml と deploy/charts/rook-ceph-cluster/values.yaml から 直接読み取ったもので、表の行番号はそのファイルの行です。リソースの合計と容量はvaluesとCephドキュメントのデフォルト値で 計算した値であり、計測したものではありません。 TT Lab実習クラスター（VM 3台、各VMに空きディスク17GiB）で実際に起動したポッドと容量は第4編で確認します。 作成規則：実測データを基本とし、計測できなかったものは「未計測」、原文から見つからなかったものは「未確認」と表示します。

目次

• 1. チャートは3つあり、順番がある
• 2. rook-ceph（operatorチャート）の重要な値
• 3. rook-ceph-clusterの外側の値
• 4. cephClusterSpec：CephClusterそのもの
  • リソース要求（resources）
• 5. ブロックプール、ファイルシステム、オブジェクトストレージのデフォルト値
  • cephBlockPools：ceph-blockpoolとStorageClass ceph-block
  • cephFileSystems：ceph-filesystemとStorageClass ceph-filesystem
  • cephObjectStores：ceph-objectstoreとStorageClass ceph-bucket
• 6. デフォルトのまま使うと危険な箇所
• 7. 実習クラスターでメモリとCPUを削減する場合
  • 容量計算
• 8. まとめ
• 参考

1. チャートは3つあり、順番がある

Rookドキュメント（Helm Charts Overview）では、 v1.21のチャートを3つ紹介しています。一般に「rook-cephとrook-ceph-clusterの2つをデプロイすればよい」と知られていますが、v1.20からその中間に1つ追加されました。

2番目を漏らすとPVCがバインドされません。 アップグレードドキュメントには、このチャートがないとサービスアカウントが存在しないためCSIドライバーが失敗状態になると記載されており、 operatorチャートドキュメントのインストール手順も「operatorチャート → CSIドライバーチャート → クラスター」の順序となっています （Ceph Operator Helm Chart, Rook Upgrades). ceph-csi-drivers はデフォルト値だけでインストールするとドライバーが失敗するため、Rookリポジトリの deploy/charts/ceph-csi-drivers/values.yamlを 必ず一緒に適用するようドキュメントで強調されています。そのファイルでドライバー名が rook-ceph.rbd.csi.ceph.com のようにoperatorのネームスペースに合わせられます。

helm repo add rook-release https://charts.rook.io/release
helm install --create-namespace -n rook-ceph rook-ceph rook-release/rook-ceph -f operator-values.yaml

helm repo add ceph-csi-operator https://ceph.github.io/ceph-csi-operator
helm install -n rook-ceph ceph-csi-drivers ceph-csi-operator/ceph-csi-drivers \
  -f https://raw.githubusercontent.com/rook/rook/v1.21.1/deploy/charts/ceph-csi-drivers/values.yaml

helm install -n rook-ceph rook-ceph-cluster rook-release/rook-ceph-cluster \
  --set operatorNamespace=rook-ceph -f cluster-values.yaml

コマンドはドキュメントの例をそのまま転載したものです。クラスターチャートのドキュメントでは、values全体をコピーせず 変更する値のみを含んだファイルを作成するよう推奨しています。 ちなみにタグの Chart.yaml には両方のチャートに version: 0.0.1 が記載されており、デプロイされるチャートのバージョンはリリースプロセスで付与されるものと 思われます（未確認）。v1.21以降、OCIチャートのタグには v が付きません。

2. rook-ceph（operatorチャート）の重要な値

ファイル全体が245行と短いです （values.yaml).

CSIの設定の大部分はこのチャートから移行しました。 以前はこのチャートの csi 配下でプロビジョナーのレプリカ数、kubeletのパス、ドライバーごとのリソースなどの 値を指定していましたが、アップグレードドキュメントでは、現在そのような値は ceph-csi-drivers チャートの設定で探すよう案内されています。このチャートに残っている csi は、サブチャートをインストールするかどうかとイメージの上書き、ServiceMonitor程度です。ceph-csi-operatorサブチャート自体の設定はvaluesの ceph-csi-operator セクション（L86）に記述します。

3. rook-ceph-clusterの外側の値

ここからは844行のクラスターチャートです （values.yaml). cephClusterSpec の外側にある値から見ていきます。

4. cephClusterSpec：CephClusterそのもの

cephClusterSpec はCephCluster CRの spec にそのまま挿入されます。クラスターチャートのドキュメントには、このデフォルト値は「あくまで例であり、お使いのクラスターに 適している可能性は低い」と記載されています。

リソース要求（resources）

cephClusterSpec.resources（L340）のデフォルト値です。Rookのドキュメントでは「低すぎると警告が表示されるだけでそのまま起動する」とされており、その基準となる推奨 最低値も記載されています（CephCluster CRD）。 ソースコードを見ると、このチェックは 上限（limit） を基準としており、上限が要求を下回る場合はエラーとみなされます （spec.go#L486-L520).

OSD のメモリを少なく設定すると、Rook が Ceph の osd_memory_target を同じ値に合わせるとドキュメントに記載されています。第 1 編で見たように、この値の Ceph デフォルトは 4Gi であるため、チャートのデフォルト値（4Gi）は Ceph のデフォルトと同じになります。MDS および RGW のリソースはここではなく、それぞれのセクションにあります（第 5 節）。

5. ブロックプール、ファイルシステム、オブジェクトストアのデフォルト値

クラスターチャートはデフォルトで 3 種類を 1 つずつ 作成し、それぞれに StorageClass をアタッチします。この StorageClass は operator ではなくチャートのテンプレートが作成します（第 2 編第 9 節）。

cephBlockPools: ceph-blockpool と StorageClass ceph-block

テンプレート（cephblockpool.yaml）が provisioner: <operatorNamespace>.rbd.csi.ceph.com と pool·clusterID（クラスター名前空間）を付加します。

cephFileSystems: ceph-filesystem と StorageClass ceph-filesystem

CephFilesystem の preserveFilesystemOnDelete はチャートに存在しないため、CRD デフォルト値 false が使用されます。CR を削除するとファイルシステムも一緒に削除されるという意味です（CephFilesystem CRD).

cephObjectStores: ceph-objectstore と StorageClass ceph-bucket

マルチサイト（realm・zonegroup・zone）、オブジェクトストアユーザー、EC ブロックプールは values 内にコメントとしてのみ記載されており、デフォルトでは作成されません（L743 以降）。

6. デフォルトのまま使用すると危険な箇所

警告 1. useAllNodes: true + useAllDevices: true（L418、L419）。 すべてのノードの使用可能なすべてのデバイスが OSD となり、フォーマットされます。第 2 編で見たように、マウントされているか、ファイルシステムや OSD の署名があるデバイスはスキップされますが、 署名の全くない空のディスクは確認なしに使用されます。 他の用途のために適当に接続したディスクや、まだフォーマットしていないディスクがその対象となります。CephCluster のドキュメントには、 useAllDevices 「デバイスを消去する危険性のない非常に制御された環境でなければ推奨しない」と記載されており、運用環境では useAllNodes: false を用いてノードを明示することが推奨されます。最低限、 deviceFilter（例：検証用 VM の空ディスク名に一致する正規表現）やノードごとの devices を記載してください。

警告 2. ceph-block の isDefault: true（L531）。 インストールした瞬間に、 ceph-block が Kubernetes 全体のデフォルト StorageClass になります。すでに別のデフォルト StorageClass が存在する場合、デフォルトが 2 つになり、Kubernetes はこのとき storageClassName の指定がない PVC に対して 最も最近作成された デフォルト StorageClass を使用します（Kubernetes: Default StorageClass）。既存のアプリの新しい PVC が意図せず Ceph へルーティングされることになります。既存のクラスターに導入する場合は false のままにしてください。

警告 3. オブジェクトストアデータプールの EC 2+1（L674）。 Ceph のドキュメントでは M=1 プロファイルについて「本番データには強く推奨しない」と記載されています。メンテナンス中にデータにアクセスできなくなり、障害が重なるとデータが失われます。また、K+M=3 であるため、 host の障害ドメインにおいてホストが正確に 3 台以上必要であり、推奨通りに min_size を K+1=3 に設定すると、ホストが 1 台ダウンしただけでもそのプールは書き込みを停止します（実際の min_size の値は第 4 編で確認、未実測）。本番環境であれば、レプリケーション 3 または K=4、M=2 を検討してください。

警告 4. 削除すると消えてしまうもの。 StorageClass 3 つの reclaimPolicy がいずれも Delete であるため、PVC を削除するとデータも削除されます。ファイルシステムは preserveFilesystemOnDelete がデフォルトで false であるため、CR を削除するとファイルシステムも削除されます。逆にオブジェクトストアは preservePoolsOnDelete: true となるため、プールは残ります。3 つのデフォルトがそれぞれ異なる点に留意してください。

警告 5. crds.enabled（operator チャート L21）。 初回インストール時に設定した値を後から false に変更すると、クラスターが破壊される可能性があるとコメントで警告されています。同様のコメントは、CRD が削除された場合に備えて災害復旧ドキュメントの「削除後の CRD 復旧」セクションを指し示しています。この値はインストール時に一度決定したら変更しないでください。

警告 6. requireMsgr2: true と keyType: aes（L231、L176）。 msgr2 にはカーネル 5.11 以降が必要であり、アップグレードドキュメントでは、より古いカーネルの場合は requireMsgr2: false で無効化するよう案内しています。 keyType: aes は、ノードのカーネルが 7.0 未満である場合に必要であるとコメントに記載されています。ノードのカーネルバージョンから確認してください。 mon.allowMultiplePerNode（L184）と requireSafeReplicaSize: false（プール CRD、size 1 を許可）は、テスト環境以外では有効にしないでください。

7. 検証用クラスターでメモリと CPU を削減する場合

TT Lab の検証用クラスターは、VM 3 台に空きディスクが 1 つずつ（17GiB）接続された構成です。デフォルト値でインストールした場合、Ceph ポッドが リクエストするリソースを values から計算すると以下のようになります。個数は、ノードセット、ディスクセット、デフォルトのプール・ファイルシステム・オブジェクトストアがそれぞれ 1 つずつであると仮定しています。

CSI ポッド（ctrlplugin・nodeplugin）と ceph-csi-operator のリクエストは該当チャートのデフォルト値であるため含めていません（未確認）。ポッドが Pending で停止する場合は、まずこの合計値を VM の CPU およびメモリと比較してみてください。実際にスケジュールされた値は第 4 編で確認します。

削減する際に変更する値です。以下は 提案であり、この組み合わせで起動した実績はありません（未実測）。

cephClusterSpec:
  mgr:
    count: 1                # mgr 하나와 사이드카 둘이 빠진다
  dashboard:
    enabled: false
  crashCollector:
    disable: true           # cluster-test.yaml 도 끈다
  logCollector:
    enabled: false          # 데몬마다 붙는 로그 사이드카가 빠진다
  resources:
    mon:
      requests: {cpu: 250m, memory: 512Mi}
      limits: {memory: 1Gi}       # 권장 최소 1024MB 와 같다
    mgr:
      requests: {cpu: 250m, memory: 512Mi}
      limits: {memory: 512Mi}     # 권장 최소 512MB
    osd:
      requests: {cpu: 500m, memory: 2Gi}
      limits: {memory: 2Gi}       # 권장 최소 2048MB, osd_memory_target 도 2Gi 가 된다
cephFileSystems:
  - name: ceph-filesystem
    spec:
      metadataServer:
        activeCount: 1
        activeStandby: false
        resources:
          requests: {cpu: 250m, memory: 1Gi}
          limits: {memory: 1Gi}   # 권장 4096MB 보다 낮아 operator 가 경고를 찍는다
cephObjectStores:
  - name: ceph-objectstore
    spec:
      gateway:
        instances: 1
        resources:
          requests: {cpu: 250m, memory: 512Mi}
          limits: {memory: 1Gi}

リスト値（cephFileSystems, cephObjectStores）は Helm が丸ごと置き換えるため、実際のファイルにはデフォルト値の残りのフィールド（プール、StorageClass）を一緒に記述する必要があります。上記の断片では変更するフィールドのみを表示するために省略しています。RWX ボリュームや S3 が不要な場合は cephFileSystems: [], cephObjectStores: [] で完全に除外することが最も大きな削減になります。 activeStandby: false はスタンバイ MDS をコールドスタンバイに変更するだけで、MDS の数（2）はそのままです（第 2 編第 2 節）。

上記組み合わせのリクエスト合計を同様の方法で計算すると、メモリは約 10.8Gi（osd 6Gi、mds 2Gi、mon 1.5Gi、mgr 512Mi、rgw 512Mi、exporter 150Mi、operator 128Mi）、CPU は約 3.6 コアです。その代わり、OSD のメモリ目標が 4Gi から 2Gi に減少し、BlueStore キャッシュが小さくなり（パフォーマンスへの影響は未実測）、MDS は Rook の推奨値を下回ります。パフォーマンスへの影響は、測定終了後に別途執筆するパフォーマンス編で取り上げます。

同じ方向性の公式の例として、Rook ストレージの deploy/examples/cluster-test.yamlがあります。リソースリクエストを全く設定せず、mon・mgr を 1 つずつにし、 osd_memory_target を 1GiB に、プールサイズを 1 にした構成です。ファイルの冒頭コメントでは「ノード 1 台で十分な小規模テストクラスター」として紹介されています。レプリカが 1 つであるためデータ保護はありません。

容量計算

ディスクセットの元容量は 51GiB です。Ceph は OSD の使用率が mon_osd_nearfull_ratio（0.85）を超えると警告を発し、 mon_osd_full_ratio（0.95）に達すると書き込みをブロックします（Monitor Config Reference).

すべてのプールが同じ元容量を分割して使用するため、2 つの行を単純に足し合わせることはできません。BlueStore と RocksDB の固定オーバーヘッド、PG が均等に分散されない度合いは除外しています（未実測）。実際に使用可能な量は第 4 編の ceph df で確認します。

8. まとめ

• チャートは 3 つであり、順序は rook-ceph → ceph-csi-drivers → rook-ceph-cluster です。真ん中を抜かすと CSI が失敗します。
• operator チャートは短く、ほとんどはデフォルトで十分です。確認すべきなのは crds.enabled, monitoring.enabled、OBC フィールドの許可程度です。
• クラスターチャートのデフォルト値は「サンプル」です。少なくとも storage（どのディスクを使用するか）、 isDefault、オブジェクトデータプールの EC プロファイル、リソースリクエストはご自身で決定してください。

T-ти（ティティ）の一言。 values.yaml は「デフォルトでこのように設定しておきますね」というお手紙です。しかし、このお手紙には「空きディスクはすべて使います」、「私がデフォルトの StorageClass になります」といった、なかなか大胆な文章が混ざっています。インストールボタンを押す前に、その数行だけは必ず読み返してください！

参考

values およびドキュメントはいずれも 2026-10-29 時点の指定コミットで閲覧しました。

• rook-ceph values.yaml: https://github.com/rook/rook/blob/09d2f0d8d883b70b30de796c4390371be725ff3b/deploy/charts/rook-ceph/values.yaml
• rook-ceph-cluster values.yaml: https://github.com/rook/rook/blob/09d2f0d8d883b70b30de796c4390371be725ff3b/deploy/charts/rook-ceph-cluster/values.yaml
• Rook が調整した ceph-csi-drivers values: https://github.com/rook/rook/blob/09d2f0d8d883b70b30de796c4390371be725ff3b/deploy/charts/ceph-csi-drivers/values.yaml
• Helm Charts Overview, Operator 차트, Cluster 차트, CSI 드라이버 차트 문서: https://github.com/rook/rook/tree/09d2f0d8d883b70b30de796c4390371be725ff3b/Documentation/Helm-Charts
• CephCluster CRD: https://github.com/rook/rook/blob/09d2f0d8d883b70b30de796c4390371be725ff3b/Documentation/CRDs/Cluster/ceph-cluster-crd.md
• CephBlockPool CRD: https://github.com/rook/rook/blob/09d2f0d8d883b70b30de796c4390371be725ff3b/Documentation/CRDs/Block-Storage/ceph-block-pool-crd.md
• CephFilesystem CRD: https://github.com/rook/rook/blob/09d2f0d8d883b70b30de796c4390371be725ff3b/Documentation/CRDs/Shared-Filesystem/ceph-filesystem-crd.md
• CephObjectStore CRD: https://github.com/rook/rook/blob/09d2f0d8d883b70b30de796c4390371be725ff3b/Documentation/CRDs/Object-Storage/ceph-object-store-crd.md
• cluster-test.yaml: https://github.com/rook/rook/blob/09d2f0d8d883b70b30de796c4390371be725ff3b/deploy/examples/cluster-test.yaml
• Ceph Erasure Code: https://docs.ceph.com/en/tentacle/rados/operations/erasure-code/
• Ceph Monitor Config Reference: https://docs.ceph.com/en/tentacle/rados/configuration/mon-config-ref/
• Kubernetes Storage Classes: https://kubernetes.io/docs/concepts/storage/storage-classes/