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

手順

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"}}}'

手順

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> 1
         schedule: "0 */12 * * *" 2
         managedDataSource: <data_source> 3
   # ...

   1

   ストレージクラスを定義します。

   2

   必須: cron 形式で指定したジョブのスケジュール。

   3

   必須: 使用するデータソース。

   For the custom image to be detected as an available boot source, the value of the `spec.dataVolumeTemplates.spec.sourceRef.name` parameter in the VM template must match this value.

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

手順

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" 1
       spec:
         schedule: "0 */12 * * *" 2
         template:
           spec:
             source:
               registry: 3
                 url: docker://quay.io/containerdisks/centos-stream:9
             storage:
               resources:
                 requests:
                   storage: 30Gi
         garbageCollect: Outdated
         managedDataSource: centos-stream9 4

   1

   このアノテーションは、volumeBindingMode が WaitForFirstConsumer に設定されたストレージクラスに必要です。

   2

   cron 形式で指定されるジョブのスケジュール。

   3

   レジストリーソースからデータボリュームを作成するのに使用します。node docker キャッシュに基づくデフォルトの node pullMethod ではなく、デフォルトの pod pullMethod を使用します。node docker キャッシュはレジストリーイメージがContainer.Image で利用可能な場合に便利ですが、CDI インポーターはこれにアクセスすることは許可されていません。

   4

   利用可能なブートソースとして検出するカスタムイメージの場合、イメージの managedDataSource の名前が、仮想マシンテンプレート YAML ファイルの spec.dataVolumeTemplates.spec.sourceRef.name にあるテンプレートの DataSource の名前に一致する必要があります。

3. ファイルを保存します。

手順

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 オブジェクトがボリュームスナップショットを参照していることを確認します。