第11章 ストレージ


11.1. ストレージ設定の概要

デフォルトのストレージクラス、ストレージプロファイル、Containerized Data Importer (CDI)、データボリューム (DV)、および自動ブートソース更新を設定できます。

11.1.1. ストレージ

次のストレージ設定タスクは必須です。

デフォルトのストレージクラスを設定する
クラスターのデフォルトのストレージクラスを設定する必要があります。設定されていない場合、OpenShift Virtualization はブートソースイメージを自動的にインポートできません。ストレージクラスを明示的に指定していない DataVolume オブジェクト (DV) および PersistentVolumeClaim オブジェクト (PVC) は、デフォルトのストレージクラスを設定するまで Pending 状態のままになります。
ストレージプロファイルを設定する
ストレージプロバイダーが CDI によって認識されない場合は、ストレージプロファイルを設定する必要があります。ストレージプロファイルは、関連付けられたストレージクラスに基づいて推奨されるストレージ設定を提供します。

次のストレージ設定タスクはオプションです。

ファイルシステムのオーバーヘッドのために追加の PVC スペースを予約する
デフォルトでは、ファイルシステム PVC の 5.5% がオーバーヘッド用に予約されており、その分仮想マシンディスクに使用できるスペースが減少します。別のオーバーヘッド値を設定できます。
ホストパスプロビジョナーを使用してローカルストレージを設定する
ホストパスプロビジョナー (HPP) を使用して、仮想マシンのローカルストレージを設定できます。OpenShift Virtualization Operator をインストールすると、HPP Operator が自動的にインストールされます。
namespace 間でデータボリュームのクローンを作成するためのユーザー権限を設定する
RBAC ロールを設定して、ユーザーが namespace 間でデータボリュームのクローンを作成できるようにすることができます。

11.1.2. Containerized Data Importer

次の Containerized Data Importer (CDI) 設定タスクを実行できます。

namespace のリソース要求制限をオーバーライドする
CPU およびメモリーリソースの制限を受ける namespace に仮想マシンディスクをインポート、アップロード、およびクローン作成するように CDI を設定できます。
CDI スクラッチスペースを設定する
CDI では、仮想マシンイメージのインポートやアップロードなどの一部の操作を完了するためにスクラッチスペース (一時ストレージ) が必要です。このプロセスで、CDI は、宛先データボリューム (DV) をサポートする PVC のサイズと同じサイズのスクラッチ領域 PVC をプロビジョニングします。

11.1.3. データボリューム

次のデータボリューム設定タスクを実行できます。

データボリュームの事前割り当てを有効にする
CDI は、データボリュームの作成時の書き込みパフォーマンスを向上させるために、ディスク領域を事前に割り当てることができます。特定のデータボリュームの事前割り当てを有効にできます。
データボリュームのアノテーションを管理する
データボリュームアノテーションを使用して Pod の動作を管理できます。1 つ以上のアノテーションをデータボリュームに追加してから、作成されたインポーター Pod に伝播できます。

11.1.4. ブートソースの更新

次のブートソース更新設定タスクを実行できます。

ブートソースの自動更新を管理する
ブートソースにより、ユーザーは仮想マシン (VM) をよりアクセスしやすく効率的に作成できるようになります。ブートソースの自動更新が有効になっている場合、CDI はイメージをインポート、ポーリング、更新して、新しい仮想マシン用にクローンを作成できるようにします。デフォルトでは、CDI は Red Hat ブートソースを自動的に更新します。次に、カスタムブートソースの自動更新を有効にできます。

11.2. ストレージプロファイルの設定

ストレージプロファイルは、関連付けられたストレージクラスに基づいて推奨されるストレージ設定を提供し、各ストレージクラスに割り当てられます。

Containerized Data Importer (CDI) は、ストレージプロバイダーの機能を識別し、対話するように設定されている場合はストレージプロバイダーを認識します。

認識されたストレージタイプの場合、CDI は PVC の作成を最適化する値を提供します。ストレージプロファイルをカスタマイズして、ストレージクラスの自動設定を行うこともできます。CDI がストレージプロバイダーを認識しない場合は、ユーザーがストレージプロファイルを設定する必要があります。

重要

Red Hat OpenShift Data Foundation で OpenShift Virtualization を使用する場合は、仮想マシンディスクの作成時に RBD ブロックモードの永続ボリューム要求 (PVC) を指定します。RBD ブロックモードボリュームは、Ceph FS または RBD ファイルシステムモード PVC よりも効率が高く、優れたパフォーマンスを提供します。

RBD ブロックモードの PVC を指定するには、'ocs-storagecluster-ceph-rbd' ストレージクラスおよび VolumeMode: Block を使用します。

11.2.1. ストレージプロファイルのカスタマイズ

プロビジョナーのストレージクラスの StorageProfile オブジェクトを編集してデフォルトパラメーターを指定できます。これらのデフォルトパラメーターは、DataVolume オブジェクトで設定されていない場合にのみ永続ボリューム要求 (PVC) に適用されます。

ストレージクラスのパラメーターは変更できません。変更する必要がある場合は、ストレージクラスを削除して再作成します。その後、ストレージプロファイルに適用していたカスタマイズを再適用する必要があります。

ストレージプロファイルの空の status セクションは、ストレージプロビジョナーが Containerized Data Importer (CDI) によって認識されないことを示します。CDI で認識されないストレージプロビジョナーがある場合、ストレージプロファイルをカスタマイズする必要があります。この場合、管理者はストレージプロファイルに適切な値を設定し、割り当てが正常に実行されるようにします。

仮想マシンのスナップショットを作成する場合、ディスクのストレージクラスに複数の VolumeSnapshotClass が関連付けられていると、警告が表示されます。この場合、ボリュームスナップショットクラスを 1 つ指定する必要があります。それ以外の場合、複数のボリュームスナップショットクラスを持つディスクは、スナップショットリストから除外されます。

警告

データボリュームを作成し、YAML 属性を省略し、これらの属性がストレージプロファイルで定義されていない場合は、要求されたストレージは割り当てられず、基礎となる永続ボリューム要求 (PVC) は作成されません。

前提条件

  • OpenShift CLI (oc) がインストールされている。
  • 計画した設定がストレージクラスとそのプロバイダーでサポートされていることを確認してください。ストレージプロファイルに互換性のない設定を指定すると、ボリュームのプロビジョニングに失敗します。

手順

  1. ストレージプロファイルを編集します。この例では、プロビジョナーは CDI によって認識されません。

    $ oc edit storageprofile <storage_class>
  2. ストレージプロファイルに設定する accessModes および volumeMode の値を指定します。以下に例を示します。

    ストレージプロファイルの例

    apiVersion: cdi.kubevirt.io/v1beta1
    kind: StorageProfile
    metadata:
      name: <unknown_provisioner_class>
    # ...
    spec:
      claimPropertySets:
      - accessModes:
        - ReadWriteOnce
        volumeMode: Filesystem
    status:
      provisioner: <unknown_provisioner>
      storageClass: <unknown_provisioner_class>

    • spec.claimPropertySets.accessModes は、ボリュームをマウントする方法を定義します。たとえば、ReadWriteOnce などです。
    • spec.claimPropertySets.accessModes.volumeMode は、ボリュームがファイルシステムを使用するか、raw ブロックストレージを使用するかを定義します。たとえば、volumeMode などです。

11.2.1.1. Web コンソールを使用してボリュームスナップショットクラスを指定する

仮想マシンのスナップショットを作成する場合は、ボリュームスナップショットクラスを 1 つだけ指定する必要があります。ボリュームスナップショットクラスが複数存在するディスクは、スナップショットリストから除外されます。ディスクのストレージクラスに複数のボリュームスナップショットクラスが関連付けられている場合、警告が表示されます。

OpenShift Container Platform Web コンソールで、デフォルトのボリュームスナップショットクラスを指定できます。

手順

  1. Virtualization に重点を置いたビューから、Storage を選択します。
  2. VolumeSnapshotClasses をクリックします。
  3. リストからボリュームスナップショットクラスを選択します。
  4. Annotations の鉛筆アイコンをクリックします。
  5. 次の キー を入力します: snapshot.storage.kubernetes.io/is-default-class。
  6. 次の 値 を入力します: true。
  7. Save をクリックします。

11.2.1.2. CLI を使用してボリュームスナップショットクラスを指定する

仮想マシンのスナップショットを作成する場合は、ボリュームスナップショットクラスを 1 つだけ指定する必要があります。ボリュームスナップショットクラスが複数存在するディスクは、スナップショットリストから除外されます。ディスクのストレージクラスに複数のボリュームスナップショットクラスが関連付けられている場合、警告が表示されます。

使用するボリュームスナップショットクラスは、次のいずれかの方法で選択できます。

  • ストレージプロファイルの spec.snapshotClass を設定します。
  • デフォルトのボリュームスナップショットクラスを設定します。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  • 使用する VolumeSnapshotClass を設定します。以下に例を示します。

    apiVersion: cdi.kubevirt.io/v1beta1
    kind: StorageProfile
    metadata:
      name: ocs-storagecluster-ceph-rbd-virtualization
    spec:
      snapshotClass: ocs-storagecluster-rbdplugin-snapclass
  • または、次のコマンドを実行して、デフォルトのボリュームスナップショットクラスを設定します。

    # oc patch VolumeSnapshotClass ocs-storagecluster-cephfsplugin-snapclass --type=merge -p '{"metadata":{"annotations":{"snapshot.storage.kubernetes.io/is-default-class":"true"}}}'

11.2.1.3. 自動的に作成されたストレージプロファイルの表示

システムは、各ストレージクラスのストレージプロファイルを自動的に作成します。これらのストレージクラスのプロファイルは、oc コマンドを使用して表示できます。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. ストレージプロファイルのリストを表示するには、次のコマンドを実行します。

    $ oc get storageprofile
  2. 特定のストレージプロファイルの詳細を取得するには、次のコマンドを実行します。

    $ oc describe storageprofile <name>

    ストレージプロファイルの詳細の例:

    Name:         ocs-storagecluster-ceph-rbd-virtualization
    Namespace:
    Labels:       app=containerized-data-importer
                  app.kubernetes.io/component=storage
                  app.kubernetes.io/managed-by=cdi-controller
                  app.kubernetes.io/part-of=hyperconverged-cluster
                  app.kubernetes.io/version=4.17.2
                  cdi.kubevirt.io=
    Annotations:  <none>
    API Version:  cdi.kubevirt.io/v1beta1
    Kind:         StorageProfile
    Metadata:
      Creation Timestamp:  2023-11-13T07:58:02Z
      Generation:          2
      Owner References:
        API Version:           cdi.kubevirt.io/v1beta1
        Block Owner Deletion:  true
        Controller:            true
        Kind:                  CDI
        Name:                  cdi-kubevirt-hyperconverged
        UID:                   2d6f169a-382c-4caf-b614-a640f2ef8abb
      Resource Version:        4186799537
      UID:                     14aef804-6688-4f2e-986b-0297fd3aaa68
    Spec:
    Status:
      Claim Property Sets:
        accessModes:
          ReadWriteMany
        volumeMode:  Block
        accessModes:
          ReadWriteOnce
        volumeMode:  Block
        accessModes:
          ReadWriteOnce
        volumeMode:                   Filesystem
      Clone Strategy:                  csi-clone
      Data Import Cron Source Format:  snapshot
      Provisioner:                     openshift-storage.rbd.csi.ceph.com
      Snapshot Class:                  ocs-storagecluster-rbdplugin-snapclass
      Storage Class:                   ocs-storagecluster-ceph-rbd-virtualization
    Events:                            <none>
    status.claimPropertySets
    Claim Property Sets は、仮想マシンディスクのプロビジョニングに使用される PVC モードを記述する AccessMode/VolumeMode ペアの順序付きリストです。
    status.cloneStrategy
    Clone Strategy 行は、使用するクローンストラテジーを示します。
    status.dataImportCronSourceFormat
    Data Import Cron Source Format は、このストレージ上のゴールデンイメージが PVC として保存されるか、ボリュームスナップショットとして保存されるかを示します。

ストレージプロファイルを使用してストレージクラスのデフォルトクローン作成メソッドを設定して、クローンストラテジーを作成できます。これは、たとえば、ストレージベンダーが特定のクローン作成方法のみをサポートしている場合に役立ちます。また、リソースの使用の制限やパフォーマンスの最大化を実現する手法を選択することもできます。

クローン作成ストラテジーは、ストレージプロファイルの cloneStrategy 属性を以下の値のいずれかに設定して指定できます。

  • snapshot が設定されている場合、デフォルトでスナップショットが使用されます。Containerized Data Importer (CDI) がストレージプロバイダーを認識し、プロバイダーが Container Storage Interface (CSI) スナップショットをサポートする場合、CDI はスナップショットメソッドを使用します。このクローン作成ストラテジーは、一時的なボリュームスナップショットを使用してボリュームのクローンを作成します。
  • copy は、ソース Pod とターゲット Pod を使用して、ソースボリュームからターゲットボリュームにデータをコピーします。ホスト支援型でのクローン作成は、最も効率的な方法です。
  • csi-clone は、CSI クローン API を使用して、中間ボリュームスナップショットを使用せずに、既存のボリュームのクローンを効率的に作成します。ストレージプロファイルが定義されていない場合にデフォルトで使用される snapshot または copy とは異なり、CSI ボリュームのクローンは、プロビジョナーのストレージクラスの StorageProfile オブジェクトに指定した場合にだけ使用されます。
注記

YAML spec セクションのデフォルトの claimPropertySets を変更せずに、CLI を使用してクローン作成ストラテジーを設定できます。

手順

  1. クローンストラテジーを定義するには、StorageProfile オブジェクトを作成または編集します。spec セクションで、次の例に示すように、cloneStrategy フィールドを設定し、必要な claimPropertySets の値を定義します。

    apiVersion: cdi.kubevirt.io/v1beta1
    kind: StorageProfile
    metadata:
      name: <provisioner_class>
    # ...
    spec:
      claimPropertySets:
      - accessModes:
        - ReadWriteOnce
        volumeMode: Filesystem
      cloneStrategy: csi-clone
    status:
      provisioner: <provisioner>
      storageClass: <provisioner_class>
    • accessModes と volumeMode は、クレームのプロパティーを定義します。
    • cloneStrategy は、デフォルトのクローン作成方法を設定します。
  2. 設定を適用します。

    $ oc apply -f <storage_profile>.yaml

11.3. ブートソースの自動更新の管理

仮想マシンを作成するために使用されるブートソースの自動更新を管理できます。これには、Red Hat およびカスタムブートソースの更新動作の設定が含まれます。

11.3.1. すべてのシステム定義のブートソースの自動更新の管理

ブートソースの自動インポートと更新を無効にすると、リソースの使用量が削減される可能性があります。切断された環境では、ブートソースの自動更新を無効にすると、CDIDataImportCronOutdated アラートがログをいっぱいにするのを防ぎます。

すべてのシステム定義のブートソースの自動更新を無効にするには、enableCommonBootImageImport フィールドの値を false に設定します。自動更新を無効にすると、関連する DataImportCron オブジェクトは削除されますが、以前にインポートされたブートソースイメージは削除されません。この値を true に設定すると、自動更新が再びオンになります。

注記

カスタムブートソースは、この設定の影響を受けません。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  • HyperConverged カスタムリソース (CR) を編集して、自動ブートソース更新を有効または無効にします。

    • 自動ブートソース更新を無効にするには、HyperConverged CR の spec.enableCommonBootImageImport フィールド値を false に設定します。以下に例を示します。

      $ oc patch hyperconverged kubevirt-hyperconverged -n openshift-cnv \
        --type json -p '[{"op": "replace", "path": \
        "/spec/enableCommonBootImageImport", \
        "value": false}]'
    • 自動ブートソース更新を再度有効にするには、HyperConverged CR の spec.enableCommonBootImageImport フィールド値を true に設定します。以下に例を示します。

      $ oc patch hyperconverged kubevirt-hyperconverged -n openshift-cnv \
        --type json -p '[{"op": "replace", "path": \
        "/spec/enableCommonBootImageImport", \
        "value": true}]'

11.3.2. デフォルトおよび virt-default ストレージクラスの設定

ストレージクラスは、ワークロードに対して永続ストレージをプロビジョニングする方法を決定します。OpenShift Virtualization では、virt-default ストレージクラスがクラスターのデフォルトストレージクラスよりも優先され、仮想化ワークロード専用に使用されます。

virt-default またはクラスターのデフォルトとして一度に設定できるストレージクラスは 1 つだけです。複数のストレージクラスがデフォルトとしてマークされている場合、virt-default ストレージクラスがクラスターのデフォルトをオーバーライドします。一貫した動作を確保するには、仮想化ワークロードのデフォルトとして 1 つのストレージクラスのみを設定します。

重要

ブートソースは、デフォルトのストレージクラスを使用して作成されます。デフォルトのストレージクラスが変更されると、古いブートソースは新しいデフォルトのストレージクラスを使用して自動的に更新されます。クラスターにデフォルトのストレージクラスがない場合は、定義する必要があります。

ブートソースイメージがボリュームスナップショットとして保存され、クラスターのデフォルトと virt-default ストレージクラスの両方が設定解除されている場合、ボリュームスナップショットはクリーンアップされ、新しいデータボリュームが作成されます。ただし、新しく作成されたデータボリュームは、デフォルトのストレージクラスが設定されるまでインポートを開始しません。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. 現在の virt-default またはクラスターのデフォルトストレージクラスを false にパッチします。

    1. 次のコマンドを実行して、現在 virt-default としてマークされているすべてのストレージクラスを識別します。

      $ oc get sc -o json| jq '.items[].metadata|select(.annotations."storageclass.kubevirt.io/is-default-virt-class"=="true")|.name'
    2. 返されたストレージクラスごとに、次のコマンドを実行して virt-default アノテーションを削除します。

      $ oc patch storageclass <storage_class_name> -p '{"metadata": {"annotations": {"storageclass.kubevirt.io/is-default-virt-class": "false"}}}'
    3. 次のコマンドを実行して、現在クラスターのデフォルトとしてマークされているすべてのストレージクラスを識別します。

      $ oc get sc -o json| jq '.items[].metadata|select(.annotations."storageclass.kubernetes.io/is-default-class"=="true")|.name'
    4. 返されたストレージクラスごとに、次のコマンドを実行してクラスターのデフォルトアノテーションを削除します。

      $ oc patch storageclass <storage_class_name> -p '{"metadata": {"annotations": {"storageclass.kubernetes.io/is-default-class": "false"}}}'
  2. 新しいデフォルトのストレージクラスを設定します。

    1. 次のコマンドを実行して、virt-default ロールをストレージクラスに割り当てます。

      $ oc patch storageclass <storage_class_name> -p '{"metadata": {"annotations": {"storageclass.kubevirt.io/is-default-virt-class": "true"}}}'
    2. または、次のコマンドを実行して、クラスターのデフォルトロールをストレージクラスに割り当てます。

      $ oc patch storageclass <storage_class_name> -p '{"metadata": {"annotations": {"storageclass.kubernetes.io/is-default-class": "true"}}}'

11.3.3. ブートソースイメージのストレージクラスの設定

HyperConverged リソースで特定のストレージクラスを設定できます。

重要

安定した動作を確保し、不要な再インポートを回避するには、HyperConverged リソースの dataImportCronTemplates セクションで storageClassName を指定します。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. 以下のコマンドを実行して、デフォルトのエディターで HyperConverged CR を開きます。

    $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
  2. HyperConverged リソースの spec セクションに dataImportCronTemplate を追加し、storageClassName を設定します。

    apiVersion: hco.kubevirt.io/v1beta1
    kind: HyperConverged
    metadata:
      name: kubevirt-hyperconverged
    spec:
      dataImportCronTemplates:
      - metadata:
          name: rhel9-image-cron
        spec:
          template:
            spec:
              storage:
                storageClassName: <storage_class>
          schedule: "0 */12 * * *"
          managedDataSource: <data_source>
    # ...
    • spec.dataImportCronTemplates.spec.template.spec.storage.storageClassName は、ストレージクラスを指定します。
    • spec.dataImportCronTemplates.spec.schedule は、cron 形式でジョブのスケジュールを指定する必須フィールドです。
    • spec.dataImportCronTemplates.spec.managedDataSource は、使用するデータソースを指定する必須フィールドです。

      注記

      カスタムイメージが使用可能なブートソースとして検出されるためには、仮想マシンテンプレート内の spec.dataVolumeTemplates.spec.sourceRef.name パラメーターの値がこの値と一致する必要があります。

  3. HyperConverged Operator (HCO) と Scheduling、Scale、および Performance (SSP) リソースのリコンシリエーションが完了するまで待ちます。
  4. 次のコマンドを実行して、openshift-virtualization-os-images namespace から古くなった DataVolume および VolumeSnapshot オブジェクトを削除します。

    $ oc delete DataVolume,VolumeSnapshot -n openshift-virtualization-os-images --selector=cdi.kubevirt.io/dataImportCron
  5. すべての DataSource オブジェクトが "Ready - True" ステータスに達するまで待機します。データソースは、PersistentVolumeClaim (PVC) または VolumeSnapshot のいずれかを参照できます。予想されるソース形式を確認するには、次のコマンドを実行します。

    $ oc get storageprofile <storage_class_name> -o json | jq .status.dataImportCronSourceFormat

11.3.4. カスタムブートソースの自動更新を有効にする

OpenShift Virtualization は、デフォルトでシステム定義のブートソースを自動的に更新しますが、カスタムブートソースは自動的に更新しません。HyperConverged カスタムリソース (CR) を編集して、自動更新を手動で有効にする必要があります。

前提条件

  • クラスターにはデフォルトのストレージクラスがあります。
  • OpenShift CLI (oc) がインストールされている。

手順

  1. 以下のコマンドを実行して、デフォルトのエディターで HyperConverged CR を開きます。

    $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
  2. 適切なテンプレートおよびブートソースを dataImportCronTemplates セクションで追加して、HyperConverged CR を編集します。以下に例を示します。

    apiVersion: hco.kubevirt.io/v1beta1
    kind: HyperConverged
    metadata:
      name: kubevirt-hyperconverged
    spec:
      dataImportCronTemplates:
      - metadata:
          name: centos-stream9-image-cron
          annotations:
            cdi.kubevirt.io/storage.bind.immediate.requested: "true"
        spec:
          schedule: "0 */12 * * *"
          template:
            spec:
              source:
                registry:
                  url: docker://quay.io/containerdisks/centos-stream:9
              storage:
                resources:
                  requests:
                    storage: 30Gi
          garbageCollect: Outdated
          managedDataSource: centos-stream9
    • spec.dataImportCronTemplates.metadata.annotations は、volumeBindingMode が WaitForFirstConsumer に設定されているストレージクラスに必要なアノテーションを指定します。
    • spec.dataImportCronTemplates.spec.schedule は、cron 形式で指定されたジョブのスケジュールを指定します。
    • spec.dataImportCronTemplates.spec.template.spec.source.registry は、データボリュームを作成するために使用するレジストリーソースを指定します。node docker キャッシュに基づくデフォルトの node pullMethod ではなく、デフォルトの pod pullMethod を使用します。node docker キャッシュはレジストリーイメージが Container.Image で利用可能な場合に便利ですが、CDI インポーターはこれにアクセスすることは許可されていません。
    • spec.dataImportCronTemplates.spec.managedDataSource は、マネージドデータソースの名前を指定します。利用可能なブートソースとして検出するカスタムイメージの場合、イメージの managedDataSource の名前が、仮想マシンテンプレート YAML ファイルの spec.dataVolumeTemplates.spec.sourceRef.name にあるテンプレートの DataSource の名前に一致する必要があります。
  3. ファイルを保存します。

11.3.5. ボリュームスナップショットのブートソースを有効にする

オペレーティングシステムのベースイメージを格納するストレージクラスに関連付けられている StorageProfile でパラメーターを設定することで、ボリュームスナップショットのブートソースを有効にできます。

DataImportCron は、元々 PVC ソースのみを維持するように設計されていましたが、特定のストレージタイプでは VolumeSnapshot ソースの方が PVC ソースよりも拡張性に優れています。

注記

ストレージプロファイルでは、単一のスナップショットからクローンを作成する場合により適切に拡張できることが証明されているボリュームスナップショットを使用してください。

前提条件

  • オペレーティングシステムイメージを含むボリュームスナップショットにアクセスできる。
  • ストレージはスナップショットをサポートしている。
  • OpenShift CLI (oc) がインストールされている。

手順

  1. 次のコマンドを実行して、ブートソースのプロビジョニングに使用されるストレージクラスに対応するストレージプロファイルオブジェクトを開きます。

    $ oc edit storageprofile <storage_class>
  2. StorageProfile の dataImportCronSourceFormat 仕様を確認して、仮想マシンがデフォルトで PVC またはボリュームスナップショットを使用しているか確認します。
  3. 必要に応じて、dataImportCronSourceFormat 仕様を snapshot に更新して、ストレージプロファイルを編集します。

    ストレージプロファイルの例:

    apiVersion: cdi.kubevirt.io/v1beta1
    kind: StorageProfile
    metadata:
    # ...
    spec:
      dataImportCronSourceFormat: snapshot

検証

  1. ブートソースのプロビジョニングに使用されるストレージクラスに対応するストレージプロファイルオブジェクトを開きます。

    $ oc get storageprofile <storage_class>  -oyaml
  2. StorageProfile の dataImportCronSourceFormat 仕様が 'snapshot' に設定されていること、および DataImportCron が指す DataSource オブジェクトがボリュームスナップショットを参照していることを確認します。

これで、これらのブートソースを使用して仮想マシンを作成できるようになりました。

11.3.6. 単一ブートソースの自動更新を無効にする

HyperConverged カスタムリソース (CR) を編集することで、カスタムブートソースかシステム定義ブートソースかに関係なく、個々のブートソースの自動更新を無効にできます。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. 以下のコマンドを実行して、デフォルトのエディターで HyperConverged CR を開きます。

    $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
  2. spec.dataImportCronTemplates フィールドを編集して、個々のブートソースの自動更新を無効にします。

    カスタムブートソース
    • spec.dataImportCronTemplates フィールドからブートソースを削除します。カスタムブートソースの自動更新はデフォルトで無効になっています。
    システム定義のブートソース
    1. ブートソースを spec.dataImportCronTemplates に追加します。

      注記

      システム定義のブートソースの自動更新はデフォルトで有効になっていますが、これらのブートソースは追加しない限り CR にリストされません。

    2. dataimportcrontemplate.kubevirt.io/enable アノテーションの値を 'false' に設定します。

      以下に例を示します。

      apiVersion: hco.kubevirt.io/v1beta1
      kind: HyperConverged
      metadata:
        name: kubevirt-hyperconverged
      spec:
        dataImportCronTemplates:
        - metadata:
            annotations:
              dataimportcrontemplate.kubevirt.io/enable: 'false'
            name: rhel8-image-cron
      # ...
  3. ファイルを保存します。

11.3.7. ブートソースのステータスの確認

HyperConverged カスタムリソース (CR) を表示することで、ブートソースがシステム定義であるかカスタムであるかを判断できます。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. 次のコマンドを実行して、HyperConverged CR の内容を表示します。

    $ oc get hyperconverged kubevirt-hyperconverged -n openshift-cnv -o yaml

    出力例:

    apiVersion: hco.kubevirt.io/v1beta1
    kind: HyperConverged
    metadata:
      name: kubevirt-hyperconverged
    spec:
    # ...
    status:
    # ...
      dataImportCronTemplates:
      - metadata:
          annotations:
            cdi.kubevirt.io/storage.bind.immediate.requested: "true"
          name: centos-9-image-cron
        spec:
          garbageCollect: Outdated
          managedDataSource: centos-stream9
          schedule: 55 8/12 * * *
          template:
            metadata: {}
            spec:
              source:
                registry:
                  url: docker://quay.io/containerdisks/centos-stream:9
              storage:
                resources:
                  requests:
                    storage: 30Gi
            status: {}
        status:
          commonTemplate: true
    # ...
      - metadata:
          annotations:
            cdi.kubevirt.io/storage.bind.immediate.requested: "true"
          name: user-defined-dic
        spec:
          garbageCollect: Outdated
          managedDataSource: user-defined-centos-stream9
          schedule: 55 8/12 * * *
          template:
            metadata: {}
            spec:
              source:
                registry:
                  pullMethod: node
                  url: docker://quay.io/containerdisks/centos-stream:9
              storage:
                resources:
                  requests:
                    storage: 30Gi
            status: {}
        status: {}
    # ...
    • status.dataImportCronTemplates.status.commonTemplate は、システム定義のブートソースを指定します。
    • status.dataImportCronTemplates.status は、カスタムブートソースを指定します。
  2. status.dataImportCronTemplates.status フィールドを確認して、ブートソースのステータスを確認します。

    • フィールドに commonTemplate: true が含まれている場合、それはシステム定義のブートソースです。
    • status.dataImportCronTemplates.status フィールドの値が {} の場合、それはカスタムブートソースです。

11.4. ファイルシステムオーバーヘッドの PVC 領域の確保

spec.storage.volumeMode 属性を Filesystem に設定することで、仮想マシン (VM) 用の DataVolume カスタムリソース (CR) を作成する場合、OpenShift Virtualization はファイルシステムのオーバーヘッドを自動的に考慮します。

DataVolume CR の spec.pvc 属性を使用してストレージタイプを指定すると、OpenShift Virtualization はファイルシステムのオーバーヘッドを追加せず、要求されたサイズが Kubernetes に直接渡されます。

デフォルトのファイルシステムオーバーヘッド値は 6% です。たとえば、10 GiB のディスクを要求し、spec.storage.volumeMode 属性が FileSystem に設定されている場合、Kubernetes は約 10.6 GiB の PVC をプロビジョニングし、仮想マシンが 10 GiB の容量をすべて利用できるようにします。

表11.1 データボリュームのファイルシステムオーバーヘッドの例
要求された仮想ディスクサイズ計算されたオーバーヘッド (6%)プロビジョニング済み PVC 総容量

10 GiB

0.6 GiB

10.6 GiB

100 GiB

6 GiB

106 GiB

注記

HyperConverged CR を編集することで、デフォルトのファイルシステムオーバーヘッド値を変更できます。

11.4.1. デフォルトのファイルシステムオーバーヘッド値のオーバーライド

HCO オブジェクトの spec.filesystemOverhead 属性を編集することで、OpenShift Virtualization がファイルシステムオーバーヘッド用に予約する永続ボリューム要求 (PVC) 領域の量を変更します。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. 次のコマンドを実行して、HCO オブジェクトを編集用に開きます。

    $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
  2. spec.filesystemOverhead フィールドを編集して、選択した値でデータを設定します。

    # ...
    spec:
      filesystemOverhead:
        global: "<new_global_value>"
        storageClass:
          <storage_class_name>: "<new_value_for_this_storage_class>"
    • spec.filesystemOverhead.global は、値が設定されていないストレージクラスに使用されるデフォルトのファイルシステムのオーバーヘッド率を指定します。たとえば、global: "0.07" は、ファイルシステムのオーバーヘッド用に PVC の 7% を確保します。
    • spec.filesystemOverhead.storageClass は、指定されたストレージクラスのファイルシステムのオーバーヘッド率を指定します。たとえば、mystorageclass: "0.04" は、mystorageclass ストレージクラスの PVC のデフォルトオーバーヘッド値を 4% に変更します。
  3. エディターを保存して終了し、HCO オブジェクトを更新します。

検証

  • 次のいずれかのコマンドを実行して、CDIConfig ステータスを表示し、変更を確認します。

    CDIConfig への変更を全般的に確認するには、以下を実行します。

    $ oc get cdiconfig -o yaml

    上記の手順で行った CDIConfig への変更を表示するには、以下を実行します。

    $ oc get cdiconfig -o jsonpath='{.items..status.filesystemOverhead}'

11.5. ホストパスプロビジョナーを使用したローカルストレージの設定

ホストパスプロビジョナー (HPP) を使用して、仮想マシンのローカルストレージを設定できます。

OpenShift Virtualization Operator のインストール時に、Hostpath Provisioner Operator は自動的にインストールされます。HPP は、Hostpath Provisioner Operator によって作成される OpenShift Virtualization 用に設計されたローカルストレージプロビジョナーです。HPP を使用するには、基本ストレージプールを使用して HPP カスタムリソース (CR) を作成します。

11.5.1. 基本ストレージプールを使用したホストパスプロビジョナーの作成

storagePools スタンザを使用して HPP カスタムリソース (CR) を作成することにより、基本ストレージプールを使用してホストパスプロビジョナー (HPP) を設定します。ストレージプールは、CSI ドライバーが使用する名前とパスを指定します。

重要

オペレーティングシステムと同じパーティションにストレージプールを作成しないでください。そうしないと、オペレーティングシステムのパーティションがいっぱいになり、パフォーマンスに影響を与えたり、ノードが不安定になったり、使用できなくなったりする可能性があります。

前提条件

  • spec.storagePools.path で指定されたディレクトリーには、読み取り/書き込みアクセス権が必要です。
  • OpenShift CLI (oc) がインストールされている。

手順

  1. 次の例のように、storagePools スタンザを含む hpp_cr.yaml ファイルを作成します。

    apiVersion: hostpathprovisioner.kubevirt.io/v1beta1
    kind: HostPathProvisioner
    metadata:
      name: hostpath-provisioner
    spec:
      imagePullPolicy: IfNotPresent
      storagePools:
      - name: any_name
        path: "/var/myvolumes"
      workload:
        nodeSelector:
          kubernetes.io/os: linux
    • spec.storagePools.name は、使用するソースを識別するための名前を定義します。StorageClass.yaml の storagePools 名と同じである必要があります。
    • spec.storagePools.path は、このノードパスの下にあるストレージプールディレクトリーを定義します。パス /var/myvolumes の値が、各ワーカーノード上に存在するディレクトリーを指定していることを確認します。
  2. ファイルを保存して終了します。
  3. 次のコマンドを実行して HPP を作成します。

    $ oc create -f hpp_cr.yaml

11.5.1.1. ストレージクラスの作成について

ストレージクラスの作成時に、ストレージクラスに属する永続ボリューム (PV) の動的プロビジョニングに影響するパラメーターを設定します。StorageClass オブジェクトの作成後には、このオブジェクトのパラメーターを更新できません。

ホストパスプロビジョナー (HPP) を使用するには、storagePools スタンザで CSI ドライバーの関連付けられたストレージクラスを作成する必要があります。

注記

仮想マシンは、ローカル PV に基づくデータボリュームを使用します。ローカル PV は特定のノードにバインドされます。ディスクイメージは仮想マシンで使用するために準備されますが、ローカルストレージ PV がすでに固定されたノードに仮想マシンをスケジュールすることができない可能性があります。

この問題を解決するには、Kubernetes Pod スケジューラーを使用して、永続ボリューム要求 (PVC) を正しいノードの PV にバインドします。volumeBindingMode パラメーターが WaitForFirstConsumer に設定された StorageClass 値を使用することにより、PV のバインディングおよびプロビジョニングは、Pod が PVC を使用して作成されるまで遅延します。

11.5.1.2. storagePools スタンザを使用して CSI ドライバーのストレージクラスを作成します。

ホストパスプロビジョナー (HPP) を使用するには、コンテナーストレージインターフェイス (CSI) ドライバーに関連するストレージクラスを作成する必要があります。

注記

ストレージクラスの作成時に、ストレージクラスに属する永続ボリューム (PV) の動的プロビジョニングに影響するパラメーターを設定します。StorageClass オブジェクトの作成後には、このオブジェクトのパラメーターを更新できません。

手順

  1. storageclass_csi.yaml ファイルを作成して、ストレージクラスを定義します。

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: hostpath-csi
    provisioner: kubevirt.io.hostpath-provisioner
    reclaimPolicy: Delete
    volumeBindingMode: WaitForFirstConsumer
    parameters:
      storagePool: my-storage-pool
    • reclaimPolicy は、ユーザーが PVC を削除したときに、基礎となるストレージが削除されるか保持されるかを定義します。reclaimPolicy には、Delete および Retain の 2 つの値があります。値を指定しない場合、デフォルト値は Delete です。
    • volumeBindingMode は、PV 作成のタイミングを定義します。この例では、WaitForFirstConsumer 設定により、スケジューラーが特定のノードに Pod を割り当てるまで、PV の作成が遅延されます。

      注記

      仮想マシンは、特定のノード上に存在するローカル PV に基づいたデータボリュームを使用します。システムが仮想マシン用のディスクイメージを準備する際、スケジューラーはローカルストレージ PV を固定したノードに仮想マシンを配置しない場合があります。

      + この問題を解決するには、Kubernetes Pod スケジューラーを使用して、永続ボリューム要求 (PVC) を正しいノードの PV にバインドします。StorageClass の volumeBindingMode パラメーターを WaitForFirstConsumer に設定すると、PVC を使用する Pod が作成されるまで PV のバインディングとプロビジョニングが遅延されます。

    • parameters.storagePool は、HPP カスタムリソース (CR) で定義されているストレージプールの名前を定義します。
  2. ファイルを保存して終了します。
  3. 次のコマンドを実行して、StorageClass オブジェクトを作成します。

    $ oc create -f storageclass_csi.yaml

11.5.2. PVC テンプレートで作成されたストレージプールについて

単一の大きな永続ボリューム (PV) がある場合は、ホストパスプロビジョナー (HPP) カスタムリソース (CR) で PVC テンプレートを定義することにより、ストレージプールを作成できます。

PVC テンプレートで作成されたストレージプールには、複数の HPP ボリュームを含めることができます。PV を小さなボリュームに分割すると、データ割り当ての柔軟性が向上します。

PVC テンプレートは、PersistentVolumeClaim オブジェクトの spec スタンザに基づいています。

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: iso-pvc
spec:
  volumeMode: Block
  storageClassName: my-storage-class
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 5Gi

spec.volumeMode 値は、ブロックボリュームモードの PV の場合にのみ必要です。

HPP CR の pvcTemplate 仕様を使用してストレージプールを定義します。Operator は、HPP CSI ドライバーを含む各ノードの pvcTemplate 仕様から PVC を作成します。PVC テンプレートから作成される PVC は単一の大きな PV を消費するため、HPP は小規模な動的ボリュームを作成できます。

基本的なストレージプールを、PVC テンプレートから作成されたストレージプールと組み合わせることができます。

11.5.2.1. PVC テンプレートを使用したストレージプールの作成

ホストパスプロビジョナー (HPP) のカスタムリソース (CR) で永続ボリューム要求 (PVC) テンプレートを指定することで、複数の HPP ボリューム用のストレージプールを作成できます。

重要

オペレーティングシステムと同じパーティションにストレージプールを作成しないでください。そうしないと、オペレーティングシステムのパーティションがいっぱいになり、パフォーマンスに影響を与えたり、ノードが不安定になったり、使用できなくなったりする可能性があります。

前提条件

  • spec.storagePools.path で指定されたディレクトリーには、読み取り/書き込みアクセス権が必要です。
  • OpenShift CLI (oc) がインストールされている。

手順

  1. 次の例に従って、storagePools スタンザで PVC テンプレートを指定する HPP CR の hpp_pvc_template_pool.yaml ファイルを作成します。

    apiVersion: hostpathprovisioner.kubevirt.io/v1beta1
    kind: HostPathProvisioner
    metadata:
      name: hostpath-provisioner
    spec:
      imagePullPolicy: IfNotPresent
      storagePools:
      - name: my-storage-pool
        path: "/var/myvolumes"
        pvcTemplate:
          volumeMode: Block
          storageClassName: my-storage-class
          accessModes:
          - ReadWriteOnce
          resources:
            requests:
              storage: 5Gi
      workload:
        nodeSelector:
          kubernetes.io/os: linux
    • spec.storagePools は、基本ストレージプールと PVC テンプレートストレージプールの両方を含むことができる配列を定義します。
    • spec.storagePools.path は、このノードパスの下にあるストレージプールディレクトリーを定義します。
    • spec.storagePools.pvcTemplate.volumeMode はオプションのパラメーターで、プロビジョニングされたボリュームのフォーマットと一致する場合は Block または Filesystem のいずれかを指定できます。値が指定されていない場合、デフォルトは Filesystem です。volumeMode が Block の場合、Pod をマウントする前にブロックボリュームに XFS ファイルシステムが作成されます。
    • spec.storagePools.pvcTemplate.storageClassName は、storageClassName パラメーターが省略された場合、デフォルトのストレージクラスを使用して PVC を作成することを指定します。storageClassName を省略する場合、HPP ストレージクラスがデフォルトのストレージクラスではないことを確認してください。
    • spec.storagePools.pvcTemplate.resources.requests.storage は、静的または動的にプロビジョニングされたストレージのストレージ要求を定義します。要求されたストレージサイズが仮想的に分割する必要のあるボリュームに対して適切になるようにしてください。そうしないと、PVC を大規模な PV にバインドすることができません。ストレージクラスが動的にプロビジョニングされたストレージを使用する場合は、一般的なリクエストのサイズに一致する割り当てサイズを選択します。
  2. ファイルを保存して終了します。
  3. 次のコマンドを実行して、ストレージプールを使用して HPP を作成します。

    $ oc create -f hpp_pvc_template_pool.yaml

デフォルトでは、ユーザーは namespace 間でリソースをクローンすることはできません。クローン機能を有効にするには、cluster-admin ロールを持つユーザーが、必要な権限を付与するクラスターロールを作成し、バインドする必要があります。

ユーザーが仮想マシンのクローンを別の namespace に作成できるようにするには、cluster-admin ロールを持つユーザーが新規のクラスターロールを作成する必要があります。このクラスターロールをユーザーにバインドし、それらのユーザーが仮想マシンのクローンを宛先 namespace に対して作成できるようにします。

11.6.1. データボリュームのクローン作成のための RBAC リソースの作成

datavolumes リソースのすべてのアクションの権限を有効にする新しいクラスターロールを作成できます。

前提条件

  • OpenShift CLI (oc) がインストールされている。
  • クラスター管理者権限がある。
注記

ソース namespace とターゲット namespace の両方の管理者である非管理者ユーザーの場合は、必要に応じて ClusterRole の代わりに Role を作成できます。

手順

  1. ClusterRole マニフェストを作成します。

    apiVersion: rbac.authorization.k8s.io/v1
    kind: ClusterRole
    metadata:
      name: <datavolume_cloner>
    rules:
    - apiGroups: ["cdi.kubevirt.io"]
      resources: ["datavolumes/source"]
      verbs: ["*"]
    # ...

    各項目の説明:

    <datavolume_cloner>
    クラスターロールの一意の名前を指定します。
  2. クラスターにクラスターロールを作成します。

    $ oc create -f <datavolume_cloner.yaml>

    各項目の説明:

    <datavolume_cloner.yaml>
    前の手順で作成された ClusterRole マニフェストのファイル名を指定します。
  3. 移行元および宛先 namespace の両方に適用される RoleBinding マニフェストを作成し、直前の手順で作成したクラスターロールを参照します。

    apiVersion: rbac.authorization.k8s.io/v1
    kind: RoleBinding
    metadata:
      name: <allow_clone_to_user>
      namespace: <source_namespace>
    subjects:
    - kind: ServiceAccount
      name: default
      namespace: <destination_namespace>
    roleRef:
      kind: ClusterRole
      name: datavolume-cloner
      apiGroup: rbac.authorization.k8s.io
    • metadata.name は、ロールバインディングの一意の名前を指定します。
    • metadata.namespace は、ソースデータボリュームの namespace を指定します。
    • subjects.namespace は、データボリュームがクローンされる namespace を指定します。
    • roleRef.name は、前の手順で作成されたクラスターロールの名前を指定します。
  4. クラスターにロールバインディングを作成します。

    $ oc create -f <datavolume_cloner.yaml>

    各項目の説明:

    <datavolume_cloner.yaml>
    前の手順で作成された RoleBinding マニフェストのファイル名を指定します。

11.7. CPU およびメモリークォータをオーバーライドするための CDI の設定

Containerized Data Importer (CDI) を設定して、CPU およびメモリーリソースの制限が適用される namespace に仮想マシンディスクをインポートし、アップロードし、そのクローンを作成できるようになりました。

11.7.1. namespace の CPU およびメモリークォータについて

ResourceQuota オブジェクトで定義される リソースクォータ は、その namespace 内のリソースが消費できるコンピュートリソースの全体量を制限する制限を namespace に課します。

HyperConverged カスタムリソース (CR) は、Containerized Data Importer (CDI) のユーザー設定を定義します。CPU とメモリーの要求値と制限値は、デフォルト値の 0 に設定されています。これにより、コンピュートリソース要件を指定しない CDI によって作成される Pod にデフォルト値が付与され、クォータで制限される namespace での実行が許可されます。

11.7.2. CPU およびメモリーのデフォルトのオーバーライド

ユースケースに合わせて CPU とメモリーの requests および limits のデフォルト設定を変更するには、spec.resourceRequirements.storageWorkloads スタンザを HyperConverged カスタムリソース (CR) に追加します。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. 以下のコマンドを実行して、HyperConverged CR を編集します。

    $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
  2. spec.resourceRequirements.storageWorkloads スタンザを CR に追加し、ユースケースに基づいて値を設定します。以下に例を示します。

    apiVersion: hco.kubevirt.io/v1beta1
    kind: HyperConverged
    metadata:
      name: kubevirt-hyperconverged
    spec:
      resourceRequirements:
        storageWorkloads:
          limits:
            cpu: "500m"
            memory: "2Gi"
          requests:
            cpu: "250m"
            memory: "1Gi"
  3. エディターを保存して終了し、HyperConverged CR を更新します。

11.8. CDI のスクラッチ領域の用意

イメージのインポートと処理をサポートするには、Containerized Data Importer (CDI) のスクラッチ領域と必要なストレージクラスを設定して、CDI が仮想マシン (VM) イメージを一時的に保存および変換できるようにします。

11.8.1. スクラッチ領域について

Containerized Data Importer (CDI) では、仮想マシンイメージのインポートやアップロードなどの、一部の操作を実行するためにスクラッチ領域 (一時ストレージ) が必要になります。このプロセスで、CDI は、宛先データボリューム (DV) をサポートする PVC のサイズと同じサイズのスクラッチ領域 PVC をプロビジョニングします。

スクラッチ領域 PVC は操作の完了または中止後に削除されます。

HyperConverged カスタムリソースの spec.scratchSpaceStorageClass フィールドで、スクラッチ領域 PVC をバインドするために使用されるストレージクラスを定義できます。

定義されたストレージクラスがクラスターのストレージクラスに一致しない場合、クラスターに定義されたデフォルトのストレージクラスが使用されます。クラスターで定義されたデフォルトのストレージクラスがない場合、元の DV または PVC のプロビジョニングに使用されるストレージクラスが使用されます。

注記

CDI では、元のデータボリュームをサポートする PVC の種類を問わず、file ボリュームモードが設定されているスクラッチ領域が必要です。元の PVC が block ボリュームモードでサポートされる場合、file ボリュームモード PVC をプロビジョニングできるストレージクラスを定義する必要があります。

11.8.1.1. 手動プロビジョニング

ストレージクラスがない場合、CDI はイメージのサイズ要件に一致するプロジェクトの PVC を使用します。これらの要件に一致する PVC がない場合、CDI インポート Pod は適切な PVC が利用可能になるまで、またはタイムアウト機能が Pod を強制終了するまで Pending 状態になります。

11.8.2. スクラッチ領域を必要とする CDI 操作

仮想マシン (VM) イメージをインポートおよび処理するために、Containerized Data Importer (CDI) は、レジストリーのインポートやイメージのアップロードなどの特定の操作中に、一時的なストレージとしてスクラッチ領域を使用します。

タイプ理由

レジストリーのインポート

CDI はイメージをスクラッチ領域にダウンロードし、イメージファイルを見つけるためにレイヤーを抽出する必要があります。その後、raw ディスクに変換するためにイメージファイルが QEMU-IMG に渡されます。

イメージのアップロード

QEMU-IMG は STDIN の入力を受け入れません。代わりに、アップロードするイメージは、変換のために QEMU-IMG に渡される前にスクラッチ領域に保存されます。

アーカイブされたイメージの HTTP インポート

QEMU-IMG は、CDI がサポートするアーカイブ形式の処理方法を認識しません。イメージが QEMU-IMG に渡される前にアーカイブは解除され、スクラッチ領域に保存されます。

認証されたイメージの HTTP インポート

QEMU-IMG が認証を適切に処理しません。イメージが QEMU-IMG に渡される前にスクラッチ領域に保存され、認証されます。

カスタム証明書の HTTP インポート

QEMU-IMG は HTTPS エンドポイントのカスタム証明書を適切に処理しません。代わりに CDI は、ファイルを QEMU-IMG に渡す前にイメージをスクラッチ領域にダウンロードします。

11.8.3. ストレージクラスの定義

spec.scratchSpaceStorageClass フィールドを HyperConverged カスタムリソース (CR) に追加することにより、スクラッチ領域を割り当てる際に、Containerized Data Importer (CDI) が使用するストレージクラスを定義できます。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. 以下のコマンドを実行して、HyperConverged CR を編集します。

    $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
  2. spec.scratchSpaceStorageClass フィールドを CR に追加し、値をクラスターに存在するストレージクラスの名前に設定します。ストレージクラスを指定しない場合、CDI は設定されている永続ボリューム要求のストレージクラスを使用します。

    apiVersion: hco.kubevirt.io/v1beta1
    kind: HyperConverged
    metadata:
      name: kubevirt-hyperconverged
    spec:
      scratchSpaceStorageClass: "<storage_class>"
  3. デフォルトのエディターを保存して終了し、HyperConverged CR を更新します。

11.8.4. CDI がサポートする操作マトリックス

このマトリックスにはエンドポイントに対してコンテンツタイプのサポートされる CDI 操作が表示されます。これらの操作にはスクラッチ領域が必要です。

コンテンツタイプHTTPHTTPSHTTP 基本認証レジストリーアップロード

KubeVirt (QCOW2)

✓ QCOW2

✓ GZ*

✓ XZ*

✓ QCOW2**

✓ GZ*

✓ XZ*

✓ QCOW2

✓ GZ*

✓ XZ*

✓ QCOW2*

□ GZ

□ XZ

✓ QCOW2*

✓ GZ*

✓ XZ*

KubeVirt (raw)

✓ raw

✓ GZ

✓ XZ

✓ raw

✓ GZ

✓ XZ

✓ raw

✓ GZ

✓ XZ

✓ raw*

□ GZ

□ XZ

✓ raw*

✓ GZ*

✓ XZ*

✓

サポートされている操作

□

サポートされていない操作

*

スクラッチ領域が必要

**

カスタム認証局が必要な場合にスクラッチ領域が必要

11.9. データボリュームの事前割り当ての使用

Containerized Data Importer (CDI) は、データボリュームの作成時に書き込みパフォーマンスを向上させるために、ディスク領域を事前に割り当てることができます。特定のデータボリュームの事前割り当てを有効にできます。

11.9.1. 事前割り当てについて

Containerized Data Importer (CDI) は、データボリュームに QEMU 事前割り当てモードを使用し、書き込みパフォーマンスを向上できます。操作のインポートおよびアップロードには、事前割り当てモードを使用できます。また、空のデータボリュームを作成する際にも使用できます。

事前割り当てが有効化されている場合、CDI は基礎となるファイルシステムおよびデバイスタイプに応じて、より適切な事前割り当て方法を使用します。

fallocate
ファイルシステムがこれをサポートする場合、CDI は posix_fallocate 関数を使用して領域を事前に割り当てるためにオペレーティングシステムの fallocate 呼び出しを使用します。これは、ブロックを割り当て、それらを未初期化としてマークします。
full
fallocate モードを使用できない場合は、基礎となるストレージにデータを書き込むことで、full モードがイメージの領域を割り当てます。ストレージの場所によっては、空の割り当て領域がすべてゼロになる場合があります。

11.9.2. データボリュームの事前割り当ての有効化

データボリュームマニフェストに spec.preallocation フィールドを含めることにより、特定のデータボリュームの事前割り当てを有効にできます。Web コンソールで、または OpenShift CLI (oc) を使用して、事前割り当てモードを有効化することができます。

事前割り当てモードは、すべての CDI ソースタイプでサポートされます。ただし、クローン作成操作では事前割り当ては無視されます。

手順

  • データボリュームマニフェストの spec.preallocation フィールドを指定します。

    apiVersion: cdi.kubevirt.io/v1beta1
    kind: DataVolume
    metadata:
      name: preallocated-datavolume
    spec:
      source:
        registry:
          url: <image_url>
      storage:
        resources:
          requests:
            storage: 1Gi
      preallocation: true
    # ...

    各項目の説明:

    <image_url>
    レジストリー内のデータソースの URL を指定します。

11.10. データボリュームアノテーションの管理

データボリューム (DV) アノテーションを使用して Pod の動作を管理できます。1 つ以上のアノテーションをデータボリュームに追加してから、作成されたインポーター Pod に伝播できます。

11.10.1. 例: データボリュームアノテーション

データボリューム (DV) アノテーションを設定することで、インポーター Pod が使用するネットワークを制御できます。v1.multus-cni.io/default-network: bridge-network アノテーションにより、Pod は bridge-network という名前の multus ネットワークをデフォルトネットワークとして使用します。

インポーター Pod にクラスターからのデフォルトネットワークとセカンダリー multus ネットワークの両方を使用させる必要がある場合は、k8s.v1.cni.cncf.io/networks: <network_name> アノテーションを使用します。

Multus ネットワークアノテーションの例

apiVersion: cdi.kubevirt.io/v1beta1
kind: DataVolume
metadata:
  name: datavolume-example
  annotations:
    v1.multus-cni.io/default-network: bridge-network
# ...

v1.multus-cni.io/default-network アノテーションは、Multus ネットワーク名を指定します。

11.11. CSI パラダイムを使用した仮想マシンストレージについて

OpenShift Virtualization の仮想マシン (VM) は、PersistentVolume (PV) および PersistentVolumeClaim (PVC) パラダイムを使用してストレージを管理します。これにより、Container Storage Interface (CSI) とのシームレスな統合が実現します。

11.11.1. 仮想マシンの CSI ストレージの概要

OpenShift Virtualization は、Container Storage Interface (CSI) との統合により仮想マシン (VM) ストレージを管理します。

ストレージクラスは、パフォーマンス層やタイプなどのストレージ機能を定義します。PersistentVolumeClaims (PVC) はストレージリソースを要求します。このストレージリソースは PersistentVolumes (PV) にバインドされます。CSI ドライバーは、iSCSI、NFS、ファイバーチャネルなど、ベンダーのストレージバックエンドに Kubernetes を接続します。

重要

仮想マシンは、その PVC がすでに別の Pod によってマウントされている場合でも起動できます。この動作は Kubernetes の PVC アクセスセマンティクスに従ったものであり、複数のライターが同一ボリュームにアクセスした場合、データ破損を招く恐れがあります。

virt storage csi paradigm

11.12. OpenShift Virtualization と IBM Fusion Access for SAN の使用

OpenShift Virtualization で SAN 用の IBM Fusion Access を使用して、仮想マシンの SAN ベースのストレージを設定できます。

11.12.1. SAN 用の IBM Fusion Access

SAN 用の IBM Fusion Access は、既存のストレージエリアネットワーク(SAN)をクラスター化されたファイルシステムとして OpenShift Virtualization に提示します。ディスクアレイは直接接続ストレージとして表示されるため、エンタープライズブロックストレージで仮想マシンをバックアップできます。

IBM Fusion Access for SAN は、既存のストレージエリアネットワーク (SAN) インフラストラクチャーを利用して、OpenShift Virtualization のためのエンタープライズストレージを提供します。SAN は、ローカルエリアネットワーク (LAN) 経由では通常アクセスできないストレージデバイスの専用ネットワークです。

OpenShift Virtualization を IBM Fusion Access for SAN とともに使用するには、まず Fusion Access for SAN Operator をインストールする必要があります。

次に、Kubernetes プルシークレットを作成し、FusionAccess カスタムリソース (CR) を作成する必要があります。

最後に、OpenShift Container Platform Web コンソールのウィザードに従って、ストレージクラスター、ローカルディスク、およびファイルシステムを設定します。

重要

SAN Operator の Fusion Access は非推奨の機能です。非推奨の機能は依然として OpenShift Container Platform に含まれており、引き続きサポートされますが、この製品の今後のリリースで削除されるため、新規デプロイメントでの使用は推奨されません。

新しいデプロイメントの場合は、Fusion Data Foundation で SAN の IBM Fusion アクセスを外部システムとして設定します。

11.12.1.1. Fusion Access for SAN を使用すべき理由

使いやすさ
Fusion Access for SAN は、ストレージクラスター、ファイルシステム、およびストレージクラスをインストールおよび設定するためのウィザードベースのユーザーインターフェイス (UI) を備えており、セットアッププロセスを簡素化します。
既存のインフラストラクチャーの使用
組織は、OpenShift Virtualization への移行や拡張を行う際に、ファイバーチャネル (FC) や iSCSI テクノロジーを含む既存の SAN 製品を活用できます。
Scalability
ストレージクラスターは、OpenShift Container Platform クラスターと仮想マシン (VM) のワークロードに合わせて拡張できるように設計されています。6 台のベアメタルホスト上で最大約 3000 台の仮想マシンをサポートできます。ファイルシステムを追加したり、特定のストレージクラスパラメーターを使用したりすることで、さらに拡張することも可能です。
統合および共有ストレージ
SAN を使用すると、複数のサーバーが大きな共有データストレージ容量を利用できるようになります。このアーキテクチャーにより、自動データバックアップと、ストレージおよびバックアッププロセスの継続的な監視が容易になります。
高速なデータ転送
Fusion Access for SAN は、ストレージ専用の高速ネットワークを使用することで、特に大容量データの場合に従来の LAN で発生する可能性のあるデータ転送のボトルネックを解消します。
ファイルレベルのアクセス
SAN は主にブロックレベルで動作しますが、SAN ストレージ上に構築されたファイルシステムは、共有ディスクファイルシステムを通じてファイルレベルのアクセスを提供できます。
管理の一元化
基盤となる SAN ソフトウェアは、サーバー、ストレージデバイス、およびネットワークを管理し、サーバーの介入を最小限に抑えながら、ストレージデバイス間でデータを直接移動できるようにします。また、論理ユニット番号 (LUN) などの SAN コンポーネントの一元的な管理と設定もサポートしています。

11.12.2. SAN ストレージのクラスター要件

SAN の Fusion Access には、同じ LUN を共有するベアメタルワーカーノードが必要です。これらの要件と制限を確認し、Operator をインストールする前にクラスターが適していることを確認します。

11.12.2.1. 前提条件

Fusion Access for SAN をインストールして設定するには、次の前提条件を満たす必要があります。

  • SAN ストレージが接続されたベアメタルワーカーノード。
  • 動作するコンテナーレジストリーが有効になっている。
  • すべてのワーカーノードが同じ LUN に接続している。

    共有 LUN は、すべてのワーカーノードが同時にアクセスする共有ディスクです。

  • Kubernetes プルシークレット。

11.12.2.2. 制限事項

  • Fusion Access for SAN の制限は、IBM Storage Scale container native の制限に依存しており、IBM Storage Scale container native のドキュメントに記載されています。
  • Hosted Control Plane (HCP) クラスターはサポートされていません。

11.12.3. SAN Operator の Fusion Access のインストール

OpenShift Container Platform Web コンソールのソフトウェアカタログから Fusion Access for SAN Operator をインストールできます。次に、Operator を使用して、既存の SAN ストレージにストレージクラスターとファイルシステムを設定します。

前提条件

  • cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。
  • 動作するコンテナーレジストリーが有効になっている。

手順

  1. OpenShift Container Platform Web コンソールで、Ecosystem Software Catalog に移動します。
  2. Filter by keyword フィールドに Fusion Access for SAN と入力します。
  3. Fusion Access for SAN タイルを選択し、Install をクリックします。
  4. Install Operator ページで、Update Channel、Version、および Installation mode のデフォルトの選択をそのままにします。
  5. Installed Namespace で Operator recommended Namespace が選択されていることを確認します。

    これにより、Operator が ibm-fusion-access namespace にインストールされます。この namespace がまだ存在しない場合は、自動的に作成されます。

    警告

    Fusion Access for SAN Operator は、ibm-fusion-access namespace にインストールする必要があります。他の namespace へのインストールはサポートされていません。

  6. Update Approval でデフォルトの Automatic が選択されていることを確認します。

    これにより、新しい z-stream リリースが利用可能になったときに自動更新が可能になります。

  7. Install をクリックします。

    これにより、Operator がインストールされます。

検証

  1. Ecosystem Installed Operators に移動します。
  2. Fusion Access for SAN Operator が表示されていることを確認します。

11.12.4. IBM レジストリーからイメージのプルを承認します

SAN 用の Fusion Access が必要とするコンテナーイメージをプルするには、IBM のエンタイトルメントキーが必要です。キーを Kubernetes シークレットに保存します。

前提条件

  • oc CLI がインストールされている。
  • cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。
  • Fusion Access for SAN Operator をインストールし、そのプロセスで ibm-fusion-access namespace を作成した。

手順

  1. Fusion Access for SAN の IBMid と password を使用して、IBM Container software library にログインします。
  2. IBM Container software library で、エンタイトルメントキーを取得します。

    1. エンタイトルメントキーがまだない場合は、Get entitlement key または Add new key をクリックし、Copy をクリックします。
    2. エンタイトルメントキーがすでにある場合は、Copy をクリックします。
  3. エンタイトルメントキーを安全な場所に保存します。
  4. oc create コマンドを実行してシークレットオブジェクトを作成します。<ibm-entitlement-key> は、ステップ 2 でコピーしたエンタイトルメントキーに置き換えます。

    $ oc create secret -n ibm-fusion-access generic fusion-pullsecret \
    --from-literal=ibm-entitlement-key=<ibm-entitlement-key>

検証

  1. OpenShift Container Platform Web コンソールで、Workloads Secrets に移動します。
  2. リストで fusion-pullsecret を見つけます。

11.12.5. FusionAccess CR を作成します。

FusionAccess カスタムリソース(CR)を作成すると、一致するバージョンの IBM Storage Scale がインストールされ、共有 LUN を持つワーカーノードが検出されます。

前提条件

  • cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。
  • Fusion Access for SAN Operator をインストールした。
  • Kubernetes プルシークレットを作成した。

手順

  1. OpenShift Container Platform Web コンソールで、Ecosystem Installed Operators に移動します。
  2. インストールした Fusion Access for SAN Operator をクリックします。
  3. Fusion Access for SAN ページで、Fusion Access タブを選択します。
  4. Create FusionAccess をクリックします。
  5. Create FusionAccess ページで、オブジェクトの Name を入力します。
  6. オプション: 関連する場合は Labels を追加することもできます。
  7. ドロップダウンリストから IBM Storage Scale Version を選択します。
  8. Create をクリックします。

検証

  • Fusion Access for SAN Operator ページの Fusion Access タブで、作成した FusionAccess CR に Ready ステータスが表示されていることを確認します。

11.12.6. ストレージクラスターの作成

ストレージクラスターは、同じ LUN へのアクセスを共有するベアメタルワーカーノードをグループ化します。クラスターを作成すると、ファイルシステムとストレージクラスで SAN 容量が利用可能になります。

OpenShift Container Platform Web コンソールのストレージクラスター作成ウィザードでは、わかりやすい手順が提供され、共有ディスクを持つ関連するワーカーノードのリストが表示されます。

前提条件

  • 認識および接続された共有 LUN を持つベアメタルワーカーノードがある。

    共有 LUN は、すべてのワーカーが同時にアクセスする共有ディスクです。

  • Fusion Access for SAN Operator をインストールした。
  • ibm-fusion-access namespace に FusionAccess カスタムリソース (CR) を作成した。

手順

  1. OpenShift Container Platform Web コンソールで、Storage Fusion Access for SAN に移動します。
  2. Create storage cluster をクリックします。
  3. 共有 LUN を持つワーカーノードを選択します。

    注記

    リストから選択できるのは、最低 20 GB の RAM を持つワーカーノードのみです。

  4. Create storage cluster をクリックします。

    ページが再読み込みされ、新しいストレージクラスターの Fusion Access for SAN ページが開きます。

11.12.7. ストレージクラスを提供するファイルシステムを作成します。

作成する各ファイルシステムは、ストレージクラスを提供します。ストレージクラスを使用して、仮想マシンの永続ボリュームをプロビジョニングします。

ファイルシステムは、ストレージクラスターの作成時に選択したワーカーノードで使用可能なストレージに基づいて作成されます。

前提条件

  • Fusion Access for SAN ストレージクラスターを作成した。

手順

  1. OpenShift Container Platform Web コンソールで、Storage Fusion Access for SAN に移動します。
  2. File systems タブで、Create file system をクリックします。
  3. 新しいファイルシステムの Name を入力します。
  4. ファイルシステムのストレージボリュームとして使用する LUN を選択します。
  5. Create file system をクリックします。

    Fusion Access for SAN ページが再読み込みされ、新しいファイルシステムが File systems タブに表示されます。

次のステップ

作成するファイルシステムごとにこの手順を繰り返します。

検証

  1. File systems タブでファイルシステムの Status を監視し、それが Healthy とマークされるまで待ちます。これには数分かかる場合があります。
  2. ファイルシステムの StorageClass をクリックします。
  3. YAML タブで、次の点を確認します。

    1. name フィールドの値は作成したファイルシステムの名前です。
    2. provisioner フィールドの値は spectrumscale.csi.ibm.com です。
    3. volBackendFs フィールドの値は、作成したファイルシステムの名前と同じになります。

      kind: StorageClass
      apiVersion: storage.k8s.io/v1
      metadata:
        name: filesystem1
        uid: eb410309-a043-a89b-9bb05483872a
        resourceVersion: '87746'
        creationTimestamp: '2025-05-14T12:30:08Z'
        managedFields:
      provisioner: spectrumscale.csi.ibm.com
      parameters:
        volBackendFs: filesystem1
      reclaimPolicy: Delete
      allowVolumeExpansion: true
      volumeBindingMode: Immediate

11.12.8. Red Hat サポート用の診断データの収集

IBM Fusion Access for SAN で問題が発生した場合は、must-gather データを収集して Red Hat サポートに提供します。データには、クラスターおよびプロジェクトのリソース、ログ、およびデプロイメントからのイベントが含まれます。

手順

  1. 次のコマンドを実行して、デプロイされた IBM Fusion Access for SAN バージョンを取得します。

    $ oc get fusionaccesses.fusion.storage.openshift.io  -n ibm-fusion-access fusionaccess-sample -o jsonpath='{.spec.storageScaleVersion}'
    注記

    このコマンドは、デプロイされた IBM Fusion Access for SAN バージョンの数値 (例: 2.11.0) を返します。

  2. 次のコマンドを実行して、must-gather イメージを作成します。

    $ oc adm must-gather --image=icr.io/cpopen/ibm-spectrum-scale-must-gather:v<software_version>
    • <software_version> は、IBM Fusion Access for SAN のバージョン値に置き換えます。

11.12.9. IBM Fusion Access for SAN のリリース更新情報

IBM Fusion Access for SAN では、再設計されたファイルシステムバックエンドとスナップショットクラスの自動作成が導入されています。アップグレードする前に、新機能、バグ修正、および既知の問題を確認してください。

11.12.9.1. 新機能および変更された機能

IBM Fusion Access for SAN 1.1.0 には、Spectrum Scale 5.2.3.5 が含まれています。

IBM Fusion Access for SAN 1.1.0 は、Spectrum Scale バージョン 5.2.3.5 を使用しています。IBM Fusion Access for SAN 1.1.0 にアップグレードすると、Spectrum Scale は自動的にバージョン 5.2.3.5 にアップグレードされます。

OCPNAS-294

OCPNAS-279

FileSystemClaim リソースのバックエンド再設計

IBM Fusion Access for SAN は、ファイルシステム関連オブジェクトの管理に FileSystemClaim リソースを使用するようにバックエンドを更新します。以前は、処理が中断されるとファイルシステムの作成が失敗する可能性がありました。今回のアップデートにより、ユーザーインターフェイスのフローや外観を維持しつつ、バックエンド処理により信頼性が向上しました。

IBM Fusion Access for SAN 1.1.0 にアップグレードすると、1.0 のユーザーインターフェイスを使用して作成されたリソースは自動的に移行され、FileSystemClaim リソースに関連付けられます。

OCPNAS-241

ファイルシステム用の VolumeSnapshotClass リソースの自動作成

IBM Fusion Access for SAN は、各ファイルシステムに対して StorageClass リソースと共に VolumeSnapshotClass リソースを作成するようになりました。これにより、新規に作成されたファイルシステムにおいて、スナップショットのサポートが常に利用可能な状態になります。

IBM Fusion Access for SAN 1.0 から 1.1.0 へのアップグレード後、VolumeSnapshotClass リソースが、これまで存在しなかった既存のファイルシステムに対して自動的に作成されます。

OCPNAS-293

カーネルモジュール管理に関するイメージレジストリー要件

IBM Fusion Access for SAN は、カーネルモジュールの管理に OpenShift Container Platform イメージレジストリーを使用します。emptyDir ストレージを使用するようにレジストリーを設定しないでください。emptyDir ストレージは一時的なストレージしか提供せず、実稼働環境での使用には適していないためです。Operator をインストールした後、FusionAccess CR を作成する前に、config map とシークレットを作成し、別のイメージレジストリーを使用するように IBM Fusion Access for SAN を設定してください。

OCPNAS-213

11.12.9.2. バグ修正

デーモンが準備完了になるまでファイルシステム作成ボタンが無効のままになる

IBM Fusion Access for SAN Operator が更新され、ファイルシステムの作成を許可する前にファイルシステムデーモンの準備状況をチェックするようになりました。環境が準備完了になるまで、Web コンソールの Create file system ボタンが無効のままになり、条件を説明するツールヒントが表示されます。この変更により、作成中にファイルシステムが停止したように見えることがなくなります。

OCPNAS-184

ユーザーインターフェイスからファイルシステムを削除できない

OpenShift Container Platform Web コンソールはファイルシステムの削除をサポートしていません。ファイルシステムを削除するには、OpenShift CLI (oc) を使用してください。

OCPNAS-217

11.12.9.3. 既知の問題

コア Pod の削除時にファイルシステムの作成が失敗する場合がある

複数のコア Pod が同時に削除されると、ファイルシステムの作成が失敗する場合があります。ファイルシステムが LUN 上に部分的に作成される場合があります。その場合、次の永続的なエラーが発生します。

Disk <ID> may still belong to an active file system

回避策はありません。サポートが必要な場合は、IBM サポートにお問い合わせください。

OCPNAS-233

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る