第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) がインストールされている。 - 計画した設定がストレージクラスとそのプロバイダーでサポートされていることを確認してください。ストレージプロファイルに互換性のない設定を指定すると、ボリュームのプロビジョニングに失敗します。
手順
ストレージプロファイルを編集します。この例では、プロビジョナーは CDI によって認識されません。
$ oc edit storageprofile <storage_class>ストレージプロファイルに設定する
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 コンソールで、デフォルトのボリュームスナップショットクラスを指定できます。
手順
- Virtualization に重点を置いたビューから、Storage を選択します。
- VolumeSnapshotClasses をクリックします。
- リストからボリュームスナップショットクラスを選択します。
- Annotations の鉛筆アイコンをクリックします。
-
次の キー を入力します:
snapshot.storage.kubernetes.io/is-default-class。 -
次の 値 を入力します:
true。 - 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) がインストールされている。
手順
ストレージプロファイルのリストを表示するには、次のコマンドを実行します。
$ oc get storageprofile特定のストレージプロファイルの詳細を取得するには、次のコマンドを実行します。
$ 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 として保存されるか、ボリュームスナップショットとして保存されるかを示します。
11.2.1.4. ストレージプロファイルを使用してデフォルトのクローン作成ストラテジーを設定する リンクのコピーリンクがクリップボードにコピーされました!
ストレージプロファイルを使用してストレージクラスのデフォルトクローン作成メソッドを設定して、クローンストラテジーを作成できます。これは、たとえば、ストレージベンダーが特定のクローン作成方法のみをサポートしている場合に役立ちます。また、リソースの使用の制限やパフォーマンスの最大化を実現する手法を選択することもできます。
クローン作成ストラテジーは、ストレージプロファイルの 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 を使用してクローン作成ストラテジーを設定できます。
手順
クローンストラテジーを定義するには、
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は、デフォルトのクローン作成方法を設定します。
-
設定を適用します。
$ oc apply -f <storage_profile>.yaml
11.3. ブートソースの自動更新の管理 リンクのコピーリンクがクリップボードにコピーされました!
仮想マシンを作成するために使用されるブートソースの自動更新を管理できます。これには、Red Hat およびカスタムブートソースの更新動作の設定が含まれます。
11.3.1. すべてのシステム定義のブートソースの自動更新の管理 リンクのコピーリンクがクリップボードにコピーされました!
ブートソースの自動インポートと更新を無効にすると、リソースの使用量が削減される可能性があります。切断された環境では、ブートソースの自動更新を無効にすると、CDIDataImportCronOutdated アラートがログをいっぱいにするのを防ぎます。
すべてのシステム定義のブートソースの自動更新を無効にするには、enableCommonBootImageImport フィールドの値を false に設定します。自動更新を無効にすると、関連する DataImportCron オブジェクトは削除されますが、以前にインポートされたブートソースイメージは削除されません。この値を true に設定すると、自動更新が再びオンになります。
カスタムブートソースは、この設定の影響を受けません。
前提条件
-
OpenShift CLI (
oc) がインストールされている。
手順
HyperConvergedカスタムリソース (CR) を編集して、自動ブートソース更新を有効または無効にします。自動ブートソース更新を無効にするには、
HyperConvergedCR のspec.enableCommonBootImageImportフィールド値をfalseに設定します。以下に例を示します。$ oc patch hyperconverged kubevirt-hyperconverged -n openshift-cnv \ --type json -p '[{"op": "replace", "path": \ "/spec/enableCommonBootImageImport", \ "value": false}]'自動ブートソース更新を再度有効にするには、
HyperConvergedCR の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) がインストールされている。
手順
現在の virt-default またはクラスターのデフォルトストレージクラスを false にパッチします。
次のコマンドを実行して、現在 virt-default としてマークされているすべてのストレージクラスを識別します。
$ oc get sc -o json| jq '.items[].metadata|select(.annotations."storageclass.kubevirt.io/is-default-virt-class"=="true")|.name'返されたストレージクラスごとに、次のコマンドを実行して virt-default アノテーションを削除します。
$ oc patch storageclass <storage_class_name> -p '{"metadata": {"annotations": {"storageclass.kubevirt.io/is-default-virt-class": "false"}}}'次のコマンドを実行して、現在クラスターのデフォルトとしてマークされているすべてのストレージクラスを識別します。
$ oc get sc -o json| jq '.items[].metadata|select(.annotations."storageclass.kubernetes.io/is-default-class"=="true")|.name'返されたストレージクラスごとに、次のコマンドを実行してクラスターのデフォルトアノテーションを削除します。
$ oc patch storageclass <storage_class_name> -p '{"metadata": {"annotations": {"storageclass.kubernetes.io/is-default-class": "false"}}}'
新しいデフォルトのストレージクラスを設定します。
次のコマンドを実行して、virt-default ロールをストレージクラスに割り当てます。
$ oc patch storageclass <storage_class_name> -p '{"metadata": {"annotations": {"storageclass.kubevirt.io/is-default-virt-class": "true"}}}'または、次のコマンドを実行して、クラスターのデフォルトロールをストレージクラスに割り当てます。
$ 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) がインストールされている。
手順
以下のコマンドを実行して、デフォルトのエディターで
HyperConvergedCR を開きます。$ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnvHyperConvergedリソースの 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パラメーターの値がこの値と一致する必要があります。
-
- HyperConverged Operator (HCO) と Scheduling、Scale、および Performance (SSP) リソースのリコンシリエーションが完了するまで待ちます。
次のコマンドを実行して、
openshift-virtualization-os-imagesnamespace から古くなったDataVolumeおよびVolumeSnapshotオブジェクトを削除します。$ oc delete DataVolume,VolumeSnapshot -n openshift-virtualization-os-images --selector=cdi.kubevirt.io/dataImportCronすべての
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) がインストールされている。
手順
以下のコマンドを実行して、デフォルトのエディターで
HyperConvergedCR を開きます。$ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv適切なテンプレートおよびブートソースを
dataImportCronTemplatesセクションで追加して、HyperConvergedCR を編集します。以下に例を示します。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は、データボリュームを作成するために使用するレジストリーソースを指定します。nodedocker キャッシュに基づくデフォルトのnodepullMethodではなく、デフォルトのpodpullMethodを使用します。nodedocker キャッシュはレジストリーイメージがContainer.Imageで利用可能な場合に便利ですが、CDI インポーターはこれにアクセスすることは許可されていません。 -
spec.dataImportCronTemplates.spec.managedDataSourceは、マネージドデータソースの名前を指定します。利用可能なブートソースとして検出するカスタムイメージの場合、イメージのmanagedDataSourceの名前が、仮想マシンテンプレート YAML ファイルのspec.dataVolumeTemplates.spec.sourceRef.nameにあるテンプレートのDataSourceの名前に一致する必要があります。
-
- ファイルを保存します。
11.3.5. ボリュームスナップショットのブートソースを有効にする リンクのコピーリンクがクリップボードにコピーされました!
オペレーティングシステムのベースイメージを格納するストレージクラスに関連付けられている StorageProfile でパラメーターを設定することで、ボリュームスナップショットのブートソースを有効にできます。
DataImportCron は、元々 PVC ソースのみを維持するように設計されていましたが、特定のストレージタイプでは VolumeSnapshot ソースの方が PVC ソースよりも拡張性に優れています。
ストレージプロファイルでは、単一のスナップショットからクローンを作成する場合により適切に拡張できることが証明されているボリュームスナップショットを使用してください。
前提条件
- オペレーティングシステムイメージを含むボリュームスナップショットにアクセスできる。
- ストレージはスナップショットをサポートしている。
-
OpenShift CLI (
oc) がインストールされている。
手順
次のコマンドを実行して、ブートソースのプロビジョニングに使用されるストレージクラスに対応するストレージプロファイルオブジェクトを開きます。
$ oc edit storageprofile <storage_class>-
StorageProfileのdataImportCronSourceFormat仕様を確認して、仮想マシンがデフォルトで PVC またはボリュームスナップショットを使用しているか確認します。 必要に応じて、
dataImportCronSourceFormat仕様をsnapshotに更新して、ストレージプロファイルを編集します。ストレージプロファイルの例:
apiVersion: cdi.kubevirt.io/v1beta1 kind: StorageProfile metadata: # ... spec: dataImportCronSourceFormat: snapshot
検証
ブートソースのプロビジョニングに使用されるストレージクラスに対応するストレージプロファイルオブジェクトを開きます。
$ oc get storageprofile <storage_class> -oyaml-
StorageProfileのdataImportCronSourceFormat仕様が 'snapshot' に設定されていること、およびDataImportCronが指すDataSourceオブジェクトがボリュームスナップショットを参照していることを確認します。
これで、これらのブートソースを使用して仮想マシンを作成できるようになりました。
11.3.6. 単一ブートソースの自動更新を無効にする リンクのコピーリンクがクリップボードにコピーされました!
HyperConverged カスタムリソース (CR) を編集することで、カスタムブートソースかシステム定義ブートソースかに関係なく、個々のブートソースの自動更新を無効にできます。
前提条件
-
OpenShift CLI (
oc) がインストールされている。
手順
以下のコマンドを実行して、デフォルトのエディターで
HyperConvergedCR を開きます。$ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnvspec.dataImportCronTemplatesフィールドを編集して、個々のブートソースの自動更新を無効にします。- カスタムブートソース
-
spec.dataImportCronTemplatesフィールドからブートソースを削除します。カスタムブートソースの自動更新はデフォルトで無効になっています。
-
- システム定義のブートソース
ブートソースを
spec.dataImportCronTemplatesに追加します。注記システム定義のブートソースの自動更新はデフォルトで有効になっていますが、これらのブートソースは追加しない限り CR にリストされません。
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 # ...
- ファイルを保存します。
11.3.7. ブートソースのステータスの確認 リンクのコピーリンクがクリップボードにコピーされました!
HyperConverged カスタムリソース (CR) を表示することで、ブートソースがシステム定義であるかカスタムであるかを判断できます。
前提条件
-
OpenShift CLI (
oc) がインストールされている。
手順
次のコマンドを実行して、
HyperConvergedCR の内容を表示します。$ 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は、カスタムブートソースを指定します。
-
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 の容量をすべて利用できるようにします。
| 要求された仮想ディスクサイズ | 計算されたオーバーヘッド (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) がインストールされている。
手順
次のコマンドを実行して、
HCOオブジェクトを編集用に開きます。$ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnvspec.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% に変更します。
-
-
エディターを保存して終了し、
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) がインストールされている。
手順
次の例のように、
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の値が、各ワーカーノード上に存在するディレクトリーを指定していることを確認します。
-
- ファイルを保存して終了します。
次のコマンドを実行して 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 オブジェクトの作成後には、このオブジェクトのパラメーターを更新できません。
手順
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) で定義されているストレージプールの名前を定義します。
-
- ファイルを保存して終了します。
次のコマンドを実行して、
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) がインストールされている。
手順
次の例に従って、
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 にバインドすることができません。ストレージクラスが動的にプロビジョニングされたストレージを使用する場合は、一般的なリクエストのサイズに一致する割り当てサイズを選択します。
-
- ファイルを保存して終了します。
次のコマンドを実行して、ストレージプールを使用して HPP を作成します。
$ oc create -f hpp_pvc_template_pool.yaml
11.6. 複数の namespace 間でデータボリュームをクローン作成するためのユーザーパーミッションの有効化 リンクのコピーリンクがクリップボードにコピーされました!
デフォルトでは、ユーザーは namespace 間でリソースをクローンすることはできません。クローン機能を有効にするには、cluster-admin ロールを持つユーザーが、必要な権限を付与するクラスターロールを作成し、バインドする必要があります。
ユーザーが仮想マシンのクローンを別の namespace に作成できるようにするには、cluster-admin ロールを持つユーザーが新規のクラスターロールを作成する必要があります。このクラスターロールをユーザーにバインドし、それらのユーザーが仮想マシンのクローンを宛先 namespace に対して作成できるようにします。
11.6.1. データボリュームのクローン作成のための RBAC リソースの作成 リンクのコピーリンクがクリップボードにコピーされました!
datavolumes リソースのすべてのアクションの権限を有効にする新しいクラスターロールを作成できます。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 - クラスター管理者権限がある。
ソース namespace とターゲット namespace の両方の管理者である非管理者ユーザーの場合は、必要に応じて ClusterRole の代わりに Role を作成できます。
手順
ClusterRoleマニフェストを作成します。apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: name: <datavolume_cloner> rules: - apiGroups: ["cdi.kubevirt.io"] resources: ["datavolumes/source"] verbs: ["*"] # ...各項目の説明:
<datavolume_cloner>- クラスターロールの一意の名前を指定します。
クラスターにクラスターロールを作成します。
$ oc create -f <datavolume_cloner.yaml>各項目の説明:
<datavolume_cloner.yaml>-
前の手順で作成された
ClusterRoleマニフェストのファイル名を指定します。
移行元および宛先 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は、前の手順で作成されたクラスターロールの名前を指定します。
-
クラスターにロールバインディングを作成します。
$ 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) がインストールされている。
手順
以下のコマンドを実行して、
HyperConvergedCR を編集します。$ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnvspec.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"-
エディターを保存して終了し、
HyperConvergedCR を更新します。
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) がインストールされている。
手順
以下のコマンドを実行して、
HyperConvergedCR を編集します。$ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnvspec.scratchSpaceStorageClassフィールドを CR に追加し、値をクラスターに存在するストレージクラスの名前に設定します。ストレージクラスを指定しない場合、CDI は設定されている永続ボリューム要求のストレージクラスを使用します。apiVersion: hco.kubevirt.io/v1beta1 kind: HyperConverged metadata: name: kubevirt-hyperconverged spec: scratchSpaceStorageClass: "<storage_class>"-
デフォルトのエディターを保存して終了し、
HyperConvergedCR を更新します。
11.8.4. CDI がサポートする操作マトリックス リンクのコピーリンクがクリップボードにコピーされました!
このマトリックスにはエンドポイントに対してコンテンツタイプのサポートされる CDI 操作が表示されます。これらの操作にはスクラッチ領域が必要です。
| コンテンツタイプ | HTTP | HTTPS | HTTP 基本認証 | レジストリー | アップロード |
|---|---|---|---|---|---|
| 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 アクセスセマンティクスに従ったものであり、複数のライターが同一ボリュームにアクセスした場合、データ破損を招く恐れがあります。
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ロールを持つユーザーとしてクラスターにアクセスできる。 - 動作するコンテナーレジストリーが有効になっている。
手順
-
OpenShift Container Platform Web コンソールで、Ecosystem
Software Catalog に移動します。 -
Filter by keyword フィールドに
Fusion Access for SANと入力します。 - Fusion Access for SAN タイルを選択し、Install をクリックします。
- Install Operator ページで、Update Channel、Version、および Installation mode のデフォルトの選択をそのままにします。
Installed Namespace で Operator recommended Namespace が選択されていることを確認します。
これにより、Operator が
ibm-fusion-accessnamespace にインストールされます。この namespace がまだ存在しない場合は、自動的に作成されます。警告Fusion Access for SAN Operator は、
ibm-fusion-accessnamespace にインストールする必要があります。他の namespace へのインストールはサポートされていません。Update Approval でデフォルトの Automatic が選択されていることを確認します。
これにより、新しい z-stream リリースが利用可能になったときに自動更新が可能になります。
Install をクリックします。
これにより、Operator がインストールされます。
検証
-
Ecosystem
Installed Operators に移動します。 - Fusion Access for SAN Operator が表示されていることを確認します。
11.12.4. IBM レジストリーからイメージのプルを承認します リンクのコピーリンクがクリップボードにコピーされました!
SAN 用の Fusion Access が必要とするコンテナーイメージをプルするには、IBM のエンタイトルメントキーが必要です。キーを Kubernetes シークレットに保存します。
前提条件
-
ocCLI がインストールされている。 -
cluster-adminロールを持つユーザーとしてクラスターにアクセスできる。 -
Fusion Access for SAN Operator をインストールし、そのプロセスで
ibm-fusion-accessnamespace を作成した。
手順
- Fusion Access for SAN の IBMid と password を使用して、IBM Container software library にログインします。
IBM Container software library で、エンタイトルメントキーを取得します。
- エンタイトルメントキーがまだない場合は、Get entitlement key または Add new key をクリックし、Copy をクリックします。
- エンタイトルメントキーがすでにある場合は、Copy をクリックします。
- エンタイトルメントキーを安全な場所に保存します。
oc createコマンドを実行してシークレットオブジェクトを作成します。<ibm-entitlement-key>は、ステップ 2 でコピーしたエンタイトルメントキーに置き換えます。$ oc create secret -n ibm-fusion-access generic fusion-pullsecret \ --from-literal=ibm-entitlement-key=<ibm-entitlement-key>
検証
-
OpenShift Container Platform Web コンソールで、Workloads
Secrets に移動します。 -
リストで
fusion-pullsecretを見つけます。
11.12.5. FusionAccess CR を作成します。 リンクのコピーリンクがクリップボードにコピーされました!
FusionAccess カスタムリソース(CR)を作成すると、一致するバージョンの IBM Storage Scale がインストールされ、共有 LUN を持つワーカーノードが検出されます。
前提条件
-
cluster-adminロールを持つユーザーとしてクラスターにアクセスできる。 - Fusion Access for SAN Operator をインストールした。
- Kubernetes プルシークレットを作成した。
手順
-
OpenShift Container Platform Web コンソールで、Ecosystem
Installed Operators に移動します。 - インストールした Fusion Access for SAN Operator をクリックします。
- Fusion Access for SAN ページで、Fusion Access タブを選択します。
- Create FusionAccess をクリックします。
- Create FusionAccess ページで、オブジェクトの Name を入力します。
- オプション: 関連する場合は Labels を追加することもできます。
- ドロップダウンリストから IBM Storage Scale Version を選択します。
- Create をクリックします。
検証
-
Fusion Access for SAN Operator ページの Fusion Access タブで、作成した
FusionAccessCR に Ready ステータスが表示されていることを確認します。
11.12.6. ストレージクラスターの作成 リンクのコピーリンクがクリップボードにコピーされました!
ストレージクラスターは、同じ LUN へのアクセスを共有するベアメタルワーカーノードをグループ化します。クラスターを作成すると、ファイルシステムとストレージクラスで SAN 容量が利用可能になります。
OpenShift Container Platform Web コンソールのストレージクラスター作成ウィザードでは、わかりやすい手順が提供され、共有ディスクを持つ関連するワーカーノードのリストが表示されます。
前提条件
認識および接続された共有 LUN を持つベアメタルワーカーノードがある。
共有 LUN は、すべてのワーカーが同時にアクセスする共有ディスクです。
- Fusion Access for SAN Operator をインストールした。
-
ibm-fusion-accessnamespace にFusionAccessカスタムリソース (CR) を作成した。
手順
-
OpenShift Container Platform Web コンソールで、Storage
Fusion Access for SAN に移動します。 - Create storage cluster をクリックします。
共有 LUN を持つワーカーノードを選択します。
注記リストから選択できるのは、最低 20 GB の RAM を持つワーカーノードのみです。
Create storage cluster をクリックします。
ページが再読み込みされ、新しいストレージクラスターの Fusion Access for SAN ページが開きます。
11.12.7. ストレージクラスを提供するファイルシステムを作成します。 リンクのコピーリンクがクリップボードにコピーされました!
作成する各ファイルシステムは、ストレージクラスを提供します。ストレージクラスを使用して、仮想マシンの永続ボリュームをプロビジョニングします。
ファイルシステムは、ストレージクラスターの作成時に選択したワーカーノードで使用可能なストレージに基づいて作成されます。
前提条件
- Fusion Access for SAN ストレージクラスターを作成した。
手順
-
OpenShift Container Platform Web コンソールで、Storage
Fusion Access for SAN に移動します。 - File systems タブで、Create file system をクリックします。
- 新しいファイルシステムの Name を入力します。
- ファイルシステムのストレージボリュームとして使用する LUN を選択します。
Create file system をクリックします。
Fusion Access for SAN ページが再読み込みされ、新しいファイルシステムが File systems タブに表示されます。
次のステップ
作成するファイルシステムごとにこの手順を繰り返します。
検証
- File systems タブでファイルシステムの Status を監視し、それが Healthy とマークされるまで待ちます。これには数分かかる場合があります。
- ファイルシステムの StorageClass をクリックします。
YAML タブで、次の点を確認します。
-
nameフィールドの値は作成したファイルシステムの名前です。 -
provisionerフィールドの値はspectrumscale.csi.ibm.comです。 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 サポートに提供します。データには、クラスターおよびプロジェクトのリソース、ログ、およびデプロイメントからのイベントが含まれます。
手順
次のコマンドを実行して、デプロイされた 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) を返します。次のコマンドを実行して、
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 にアップグレードされます。
FileSystemClaimリソースのバックエンド再設計IBM Fusion Access for SAN は、ファイルシステム関連オブジェクトの管理に
FileSystemClaimリソースを使用するようにバックエンドを更新します。以前は、処理が中断されるとファイルシステムの作成が失敗する可能性がありました。今回のアップデートにより、ユーザーインターフェイスのフローや外観を維持しつつ、バックエンド処理により信頼性が向上しました。IBM Fusion Access for SAN 1.1.0 にアップグレードすると、1.0 のユーザーインターフェイスを使用して作成されたリソースは自動的に移行され、
FileSystemClaimリソースに関連付けられます。- ファイルシステム用の
VolumeSnapshotClassリソースの自動作成 IBM Fusion Access for SAN は、各ファイルシステムに対して
StorageClassリソースと共にVolumeSnapshotClassリソースを作成するようになりました。これにより、新規に作成されたファイルシステムにおいて、スナップショットのサポートが常に利用可能な状態になります。IBM Fusion Access for SAN 1.0 から 1.1.0 へのアップグレード後、
VolumeSnapshotClassリソースが、これまで存在しなかった既存のファイルシステムに対して自動的に作成されます。- カーネルモジュール管理に関するイメージレジストリー要件
IBM Fusion Access for SAN は、カーネルモジュールの管理に OpenShift Container Platform イメージレジストリーを使用します。
emptyDirストレージを使用するようにレジストリーを設定しないでください。emptyDir ストレージは一時的なストレージしか提供せず、実稼働環境での使用には適していないためです。Operator をインストールした後、FusionAccessCR を作成する前に、config map とシークレットを作成し、別のイメージレジストリーを使用するように IBM Fusion Access for SAN を設定してください。
11.12.9.2. バグ修正 リンクのコピーリンクがクリップボードにコピーされました!
- デーモンが準備完了になるまでファイルシステム作成ボタンが無効のままになる
IBM Fusion Access for SAN Operator が更新され、ファイルシステムの作成を許可する前にファイルシステムデーモンの準備状況をチェックするようになりました。環境が準備完了になるまで、Web コンソールの Create file system ボタンが無効のままになり、条件を説明するツールヒントが表示されます。この変更により、作成中にファイルシステムが停止したように見えることがなくなります。
- ユーザーインターフェイスからファイルシステムを削除できない
OpenShift Container Platform Web コンソールはファイルシステムの削除をサポートしていません。ファイルシステムを削除するには、OpenShift CLI (
oc) を使用してください。
11.12.9.3. 既知の問題 リンクのコピーリンクがクリップボードにコピーされました!
- コア Pod の削除時にファイルシステムの作成が失敗する場合がある
複数のコア Pod が同時に削除されると、ファイルシステムの作成が失敗する場合があります。ファイルシステムが LUN 上に部分的に作成される場合があります。その場合、次の永続的なエラーが発生します。
Disk <ID> may still belong to an active file system回避策はありません。サポートが必要な場合は、IBM サポートにお問い合わせください。