6.12. 仮想マシンディスク

手順

1. MachineConfig ファイルを作成します。以下は例になります。

   $ touch machineconfig.yaml

2. ファイルを編集し、ホストパスプロビジョナーが PV を作成するディレクトリーを組み込みます。以下は例になります。

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     name: 50-set-selinux-for-hostpath-provisioner
     labels:
       machineconfiguration.openshift.io/role: worker
   spec:
     config:
       ignition:
         version: 2.2.0
       systemd:
         units:
           - contents: |
               [Unit]
               Description=Set SELinux chcon for hostpath provisioner
               Before=kubelet.service
   
               [Service]
               ExecStart=/usr/bin/chcon -Rt container_file_t <path/to/backing/directory> 1
   
               [Install]
               WantedBy=multi-user.target
             enabled: true
             name: hostpath-provisioner.service

   1

   プロビジョナーが PV を作成するバッキングディレクトリーを指定します。

3. MachineConfig オブジェクトを作成します。

   $ oc create -f machineconfig.yaml -n <namespace>

手順

1. HostPathProvisioner カスタムリソースファイルを作成します。以下は例になります。

   $ touch hostpathprovisioner_cr.yaml

2. ファイルを編集し、spec.pathConfig.path の値がホストパスプロビジョナーが PV を作成するディレクトリーであることを確認します。以下は例になります。

   apiVersion: hostpathprovisioner.kubevirt.io/v1alpha1
   kind: HostPathProvisioner
   metadata:
     name: hostpath-provisioner
   spec:
     imagePullPolicy: IfNotPresent
     pathConfig:
       path: "</path/to/backing/directory>" 1
       useNamingPrefix: "false" 2

   1

   プロビジョナーが PV を作成するバッキングディレクトリーを指定します。

   2

   作成された PV にバインドされる PersistentVolumeClaim (PVC) の名前をディレクトリー名のプレフィックスとして使用する場合には、この値を true に変更します。

   注記

   バッキングディレクトリーを作成していない場合、プロビジョナーはこの作成を試行します。container_file_t SELinux コンテキストを適用していない場合、これにより Permission denied エラーが生じる可能性があります。

3. openshift-cnv namespace にカスタムリソースを作成します。

   $ oc create -f hostpathprovisioner_cr.yaml -n openshift-cnv

手順

1. ストレージクラスを定義する YAML ファイルを作成します。以下は例になります。

   $ touch storageclass.yaml

2. ファイルを編集します。以下は例になります。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: hostpath-provisioner 1
   provisioner: kubevirt.io/hostpath-provisioner
   reclaimPolicy: Delete 2
   volumeBindingMode: WaitForFirstConsumer 3

   1

   この値を変更することで、オプションでストレージクラスの名前を変更できます。

   2

   reclaimPolicy には、Delete および Retain の 2 つの値があります。値を指定しない場合、ストレージクラスはデフォルトで Delete に設定されます。

   3

   volumeBindingMode 値は、動的プロビジョニングおよびボリュームバインディングが実行されるタイミングを決定します。WaitForFirstConsumer を指定して、PersistentVolumeClaim (PVC) を使用する Pod が作成されるまで PV のバインディングおよびプロビジョニングを遅延させます。これにより、PV が Pod のスケジュール要件を満たすようになります。

3. StorageClass オブジェクトを作成します。

   $ oc create -f storageclass.yaml

手順

1. 以下を特定します。

   • アップロードする VM ディスクイメージのファイルの場所
   • 結果として生成される PVC の名前およびこれに必要なサイズ

2. virtctl image-upload コマンドを実行して仮想マシンイメージをアップロードします。PVC 名、PVC サイズ、およびファイルの場所を指定する必要があります。以下は例になります。

   $ virtctl image-upload --pvc-name=<upload-fedora-pvc> --pvc-size=<2Gi> --image-path=</images/fedora.qcow2>

   警告

   HTTPS を使用したセキュアでないサーバー接続を許可するには、--insecure パラメーターを使用します。--insecure フラグを使用する際に、アップロードエンドポイントの信頼性は検証 されない 点に注意してください。

3. PVC が作成されていることを確認するには、すべての PVC オブジェクトを表示します。

   $ oc get pvc

手順

1. ローカル PV を作成するノードに root としてログインします。この手順では、node01 を例に使用します。

2. ファイルを作成して、これを null 文字で設定し、ブロックデバイスとして使用できるようにします。以下の例では、2Gb (20 100Mb ブロック) のサイズのファイル loop10 を作成します。

   $ dd if=/dev/zero of=<loop10> bs=100M count=20

3. loop10 ファイルをループデバイスとしてマウントします。

   $ losetup </dev/loop10>d3 <loop10> 1 2

   1

   ループデバイスがマウントされているファイルパスです。

   2

   前の手順で作成したファイルはループデバイスとしてマウントされます。

4. マウントされたループデバイスを参照する PersistentVolume 設定を作成します。

   kind: PersistentVolume
   apiVersion: v1
   metadata:
     name: <local-block-pv10>
     annotations:
   spec:
     local:
       path: </dev/loop10> 1
     capacity:
       storage: <2Gi>
     volumeMode: Block 2
     storageClassName: local 3
     accessModes:
       - ReadWriteOnce
     persistentVolumeReclaimPolicy: Delete
     nodeAffinity:
       required:
         nodeSelectorTerms:
         - matchExpressions:
           - key: kubernetes.io/hostname
             operator: In
             values:
             - <node01> 4

   1

   ノード上のループデバイスのパス。

   2

   ブロック PV であることを指定します。

   3

   オプション: PV に StorageClass を設定します。これを省略する場合、クラスターのデフォルトが使用されます。

   4

   ブロックデバイスがマウントされたノード。

5. ブロック PV を作成します。

   # oc create -f <local-block-pv10.yaml>1

   1

   直前の手順で作成された PersistentVolume のファイル名。

手順

1. spec: source: upload{} を指定する DataVolume 設定を作成します。

   apiVersion: cdi.kubevirt.io/v1alpha1
   kind: DataVolume
   metadata:
     name: <upload-datavolume> 1
   spec:
     source:
         upload: {}
     pvc:
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: <2Gi> 2

   1

   DataVolume の名前

   2

   DataVolume のサイズ

2. DataVolume を作成します。

   $ oc create -f <upload-datavolume>.yaml

手順

1. 以下を特定します。

   • アップロードする仮想マシンディスクイメージのファイルの場所
   • DataVolume の名前

2. virtctl image-upload コマンドを実行してディスクイメージをアップロードします。DV 名とファイルの場所を指定する必要があります。以下は例になります。

   $ virtctl image-upload --dv-name=<upload-datavolume> --image-path=</images/fedora.qcow2> 1 2

   1

   作成する DataVolume の名前。

   2

   アップロードする仮想マシンディスクイメージのファイルパス。

   警告

   HTTPS を使用したセキュアでないサーバー接続を許可するには、--insecure パラメーターを使用します。--insecure フラグを使用する際に、アップロードエンドポイントの信頼性は検証 されない 点に注意してください。

3. DV が作成されていることを確認するには、すべての DV オブジェクトを表示します。

   $ oc get dvs

手順

1. ノードに新規のローカル PV を作成するか、またはノードにすでに存在しているローカル PV を特定します。

   • nodeAffinity.nodeSelectorTerms パラメーターを含むローカル PV を作成します。以下のマニフェストは、node01 に 10Gi のローカル PV を作成します。

     kind: PersistentVolume
     apiVersion: v1
     metadata:
       name: <destination-pv> 1
       annotations:
     spec:
       accessModes:
       - ReadWriteOnce
       capacity:
         storage: 10Gi 2
       local:
         path: /mnt/local-storage/local/disk1 3
       nodeAffinity:
         required:
           nodeSelectorTerms:
           - matchExpressions:
             - key: kubernetes.io/hostname
               operator: In
               values:
               - node01 4
       persistentVolumeReclaimPolicy: Delete
       storageClassName: local
       volumeMode: Filesystem

     1

     PV の名前。

     2

     PV のサイズ。十分な領域を割り当てる必要があります。そうでない場合には、クローン操作は失敗します。サイズはソース PVC と同じか、またはそれよりも大きくなければなりません。

     3

     ノードのマウントパス。

     4

     PV を作成するノードの名前。

   • ターゲットノードに存在する PV を特定します。設定の nodeAffinity フィールドを確認して、PV がプロビジョニングされるノードを特定することができます。

     $ oc get pv <destination-pv> -o yaml

     以下のスニペットは、PV が node01 にあることを示しています。

     ...
     spec:
       nodeAffinity:
         required:
           nodeSelectorTerms:
           - matchExpressions:
             - key: kubernetes.io/hostname 1
               operator: In
               values:
               - node01 2
     ...

     1

     kubernetes.io/hostname キーでは、ノードを選択するためにノードホスト名を使用します。

     2

     ノードのホスト名です。

2. PV に一意のラベルを追加します。

   $ oc label pv <destination-pv> node=node01

3. 以下を参照する DataVolume マニフェストを作成します。

   • 仮想マシンの PVC 名と namespace。
   • 直前の手順で PV に適用されたラベル。

   • 宛先 PV のサイズ。

     apiVersion: cdi.kubevirt.io/v1alpha1
     kind: DataVolume
     metadata:
       name: <clone-datavolume> 1
     spec:
       source:
         pvc:
           name: "<source-vm-disk>" 2
           namespace: "<source-namespace>" 3
       pvc:
         accessModes:
           - ReadWriteOnce
         selector:
           matchLabels:
             node: node01 4
         resources:
           requests:
             storage: <10Gi> 5

     1

     新規 DataVolume の名前。

     2

     ソース PVC の名前。PVC 名が分からない場合は、仮想マシン設定 spec.volumes.persistentVolumeClaim.claimName で確認できます。

     3

     ソース PVC が存在する namespace。

     4

     直前の手順で PV に追加したラベル。

     5

     宛先 PV のサイズ。

4. DataVolume マニフェストをクラスターに適用してクローン作成の操作を開始します。

   $ oc apply -f <clone-datavolume.yaml>

手順

1. DataVolume 設定ファイルを編集します。

   apiVersion: cdi.kubevirt.io/v1alpha1
   kind: DataVolume
   metadata:
     name: blank-image-datavolume
   spec:
     source:
         blank: {}
     pvc:
       # Optional: Set the storage class or omit to accept the default
       # storageClassName: "hostpath"
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: 500Mi

2. 以下のコマンドを実行して、空のディスクイメージを作成します。

   $ oc create -f <blank-image-datavolume>.yaml

手順

1. サイドメニューから、Workloads Config Maps をクリックします。
2. Project 一覧で、openshift-cnv を選択します。
3. kubevirt-storage-class-defaults をクリックして Config Map Overview を開きます。
4. YAML タブをクリックして編集可能な設定を表示します。

5. 基礎となるストレージに適したストレージ設定で data の値を更新します。

   ...
   data:
     accessMode: ReadWriteOnce 1
     volumeMode: Filesystem 2
     <new>.accessMode: ReadWriteMany 3
     <new>.volumeMode: Block 4

   1

   デフォルトの accessMode は ReadWriteOnce です。

   2

   デフォルトの volumeMode は Filesystem です。

   3

   ストレージクラスのアクセスモードを追加する場合は、パラメーターの <new> 部分をストレージクラス名に置き換えます。

   4

   ストレージクラスのボリュームモードを追加する場合は、パラメーターの <new> 部分をストレージクラス名に置き換えます。

6. Save をクリックして ConfigMap を更新します。

手順

1. oc edit を使用して ConfigMap を編集します。

   $ oc edit configmap kubevirt-storage-class-defaults -n openshift-cnv

2. ConfigMap の data 値を更新します。

   ...
   data:
     accessMode: ReadWriteOnce 1
     volumeMode: Filesystem 2
     <new>.accessMode: ReadWriteMany 3
     <new>.volumeMode: Block 4

   1

   デフォルトの accessMode は ReadWriteOnce です。

   2

   デフォルトの volumeMode は Filesystem です。

   3

   ストレージクラスのアクセスモードを追加する場合は、パラメーターの <new> 部分をストレージクラス名に置き換えます。

   4

   ストレージクラスのボリュームモードを追加する場合は、パラメーターの <new> 部分をストレージクラス名に置き換えます。

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