ODFの前提条件

ローカルNVMEストレージを備えたベアメタルワーカーノード

ローカルのNVMEディスクを含む、 d のサフィックスを持つフレーバーを使用する。

ワーカー・ノードの要件

ODFは、高可用性とデータの冗長性のために、少なくとも3つのワーカーノードを必要とします。

ゾーン構成

• OpenShift 仮想化の導入 ： VM ワークロードのストレージレイテンシーを最小化するために、シングルゾー ンクラスターを推奨します。 マルチゾーン展開により高可用性は向上するが、クロスゾーンストレージレプリケーションは VM のパフォーマンスに影響を与える可能性がある。
• 一般的なODFの展開 ：高可用性とディザスタリカバリのために、少なくとも3つのゾーンを推奨します。

コンソールからのODFのインストール

1. IBM Cloud アカウントログインし、クラスタに移動します。

2. クラスターナビゲーションでアドオンをクリックします。

3. 「 OpenShift Data Foundation 」カードで、「 インストール 」をクリックします。

4. Local Storage オプションを選択する。

   リモートブロックボリュームアタッチメントは、VPCベアメタルノードではサポートされていません。

5. 以下の調査方法の中から1つを選んでください：

   自動検出（推奨）

   ベアメタルワーカーノードで利用可能なディスクを自動的に検出し使用するには、 自動検出を選択します。

   マニュアルディスク仕様

   ディスクを手動で指定したい場合は、以下の手順に従ってください：

   1. 各ワーカーノードにログインして、利用可能なディスクを特定する。

      oc debug node/<node-name>
      

   2. ホスト・バイナリーを許可します。

      chroot /host
      

   3. 使用可能なデバイスをリストアップします。

      lsblk
      

   4. 各ディスクのby-idを見つける。

      ls -l /dev/disk/by-id/
      

   5. OSD pod disk IDs パラメータにディスクIDを追加する。

6. 必要に応じて追加のパラメータを設定する：

   • リソースプロファイル ：ワークロードに応じて、 balanced または performance を選択してください
   • 暗号化 ：必要に応じて Hyper Protect Crypto Services で暗号化を有効にする
   • OSDディスクの数 ：ワーカーノードあたりのディスク数を指定します

7. インストールをクリックしてODFを配置します。

ODFパラメータの詳細については、 OpenShift Data Foundationパラメータリファレンスを 参照してください。

CLI からの ODF のインストール

1. 利用可能なアドオンオプションを確認してください。

   ibmcloud oc cluster addon options --addon openshift-data-foundation --version 4.20.0
   

2. ディスクの自動検出と仮想化をサポートする OpenShift Data Foundation アドオンを有効にする。

   ibmcloud oc cluster addon enable openshift-data-foundation \
     -c <cluster-name> \
     --version 4.20.0 \
     --param "odfDeploy=true" \
     --param "osdStorageClassName=localblock" \
     --param "autoDiscoverDevices=true" \
     --param "resourceProfile=performance" \
     --param "setDefaultStorageClassForVirtualization=true"
   

3. アドオンが「Ready」状態になっていることを確認してください。

   oc get storagecluster -n openshift-storage
   

   出力例:

   NAME                 AGE   PHASE   EXTERNAL   CREATED AT             VERSION
   ocs-storagecluster   53m   Ready              2025-03-10T12:20:52Z   4.20.0
   

ODFのインストールを確認する

1. ストレージクラスタのステータスを確認する。

   oc get storagecluster -n openshift-storage
   

2. ストレージクラスが利用可能であることを確認する。

   oc get storageclass | grep ocs
   

3. ODFポッドが起動していることを確認する。

   oc get pods -n openshift-storage
   

ODFのデプロイの詳細については、 OpenShift Data FoundationをVPCクラスタにデプロイするを 参照してください。

VPCの前提条件 File Storage

• サポートされているあらゆるベアメタル環境
• VPC インフラストラクチャー

手順 1: VPC のデフォルトの Block Storage を無効にする

1. VPC Block CSI ドライバーの ConfigMap を編集します。

   oc edit cm addon-vpc-block-csi-driver-configmap -n kube-system
   

2. IsStorageClassDefault を falseに設定します。

   data:
     IsStorageClassDefault: "false"
   

3. エディターを保存して終了します。

ステップ 2: VPC ファイル CSI ドライバーをインストールする

ステップ3：デフォルトのストレージクラスを設定する

1. 使用可能なストレージ・クラスをリストします。

   oc get storageclass | grep vpc-file
   

2. ワークロードに応じて、適切なストレージクラスを選択してください：

   • ibmc-vpc-file-1000-iops: 中程度のワークロード向け（40 GB ～ 2000 IOPS）
   • ibmc-vpc-file-6000-iops: より高い負荷（100 GB ～ 6000 IOPS）の場合
   • ibmc-vpc-file-metro-1000-iops: マルチゾーン展開の場合

3. VPCファイルのCSIドライバー構成マップを編集します。

   oc edit cm addon-vpc-file-csi-driver-configmap -n kube-system
   

4. 「 SET_DEFAULT_STORAGE_CLASS 」フィールドに、選択したストレージクラスを設定してください。

   data:
     SET_DEFAULT_STORAGE_CLASS: "ibmc-vpc-file-metro-1000-iops"
   

5. エディターを保存して終了します。

6. 変更が反映されるまで、数分お待ちください。

7. デフォルトのストレージクラスを確認してください。

   oc get storageclass | grep "(default)"
   

ステップ 4: VPC のストレージプロファイルを設定する File Storage

OpenShift Virtualization Operator をインストールした後、Container Disk Importer (CDI) は VPC File Storage のプロパティを自動的に認識しないため、VPC File Storage 用のストレージプロファイルを設定する必要があります。

この手順は、 OpenShift Virtualization Operator のインストール後に実行する必要があります。

for sp in $(oc get storageprofile.cdi.kubevirt.io -o json | jq -r '.items[] | select(.status.provisioner == "vpc.file.csi.ibm.io") | .metadata.name'); do
  oc patch storageprofile.cdi.kubevirt.io "$sp" --type=merge -p '{
    "spec": {
      "claimPropertySets": [
        {
          "accessModes": ["ReadWriteMany"],
          "volumeMode": "Filesystem"
        }
      ]
    }
  }'
done

VPC上の File Storage のインストールを確認する

1. VPC File CSI ドライバーのポッドが実行中であることを確認してください。

   oc get pods -n kube-system | grep vpc-file
   

2. デフォルトのストレージクラスが正しく設定されていることを確認してください。

   oc get storageclass | grep "(default)"
   

3. テスト用のPVCを作成して、ストレージのプロビジョニングをテストします。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-pvc
   spec:
     accessModes:
     - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
   

4. PVCが結合していることを確認してください。

   oc get pvc test-pvc
   

5. テスト用PVCを削除してください。

   oc delete pvc test-pvc
   

ODFのインストールに失敗

ODFのインストールに失敗した場合は、以下を確認してください：

• ベアメタルノードにローカルNVMEストレージがあることを確認する
• 少なくとも3つのワーカーノードがあることを確認してください
• ディスクがアンマウントされ、フォーマットされていないことを確認する
• ODFオペレーターのログを確認する： oc logs -n openshift-storage -l app=ocs-operator

VPC（ File Storage ）のPVCは保留中のままです

PVCが保留状態のままの場合：

• VPC File CSI ドライバー・アドオンがインストールされており、正常に動作していることを確認してください
• デフォルトのストレージクラスが正しく設定されているか確認してください
• ストレージプロファイルがRWXアクセスモードで設定されていることを確認してください
• CSIドライバーのログを確認する： oc logs -n kube-system -l app=ibm-vpc-file-csi-controller

ストレージプロファイルが更新されていません

ストレージプロファイルに正しい設定が表示されていない場合は：

• 「 OpenShift Virtualization Operator」がインストールされていることを確認してください
• ストレージプロファイルが自動的に作成されるまでお待ちください
• 提供されているコマンドを使用して、ストレージプロファイルを手動で修正する
• プロビジョナー名が一致していることを確認してください vpc.file.csi.ibm.io