8.16. 仮想マシンのインポート

手順

1. 正しい namespace にあることを確認します。設定マップは、同じ namespace にある場合にデータボリュームによってのみ参照されます。

   $ oc get ns

2. 設定マップを作成します。

   $ oc create configmap <configmap-name> --from-file=</path/to/file/ca.pem>

手順

1. データソースに認証が必要な場合は、データソースのクレデンシャルを指定して Secret マニフェストを作成し、endpoint-secret.yaml として保存します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: endpoint-secret 1
     labels:
       app: containerized-data-importer
   type: Opaque
   data:
     accessKeyId: "" 2
     secretKey:   "" 3

   1

   Secret の名前を指定します。

   2

   Base64 でエンコードされたキー ID またはユーザー名を指定します。

   3

   Base64 でエンコードされた秘密鍵またはパスワードを指定します。

2. Secret マニフェストを適用します。

   $ oc apply -f endpoint-secret.yaml

3. VirtualMachine マニフェストを編集し、インポートする仮想マシンイメージのデータソースを指定して、vm-fedora-datavolume.yaml として保存します。

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     creationTimestamp: null
     labels:
       kubevirt.io/vm: vm-fedora-datavolume
     name: vm-fedora-datavolume 1
   spec:
     dataVolumeTemplates:
     - metadata:
         creationTimestamp: null
         name: fedora-dv 2
       spec:
         storage:
           resources:
             requests:
               storage: 10Gi
           storageClassName: local
         source:
           http: 3
             url: "https://mirror.arizona.edu/fedora/linux/releases/35/Cloud/x86_64/images/Fedora-Cloud-Base-35-1.2.x86_64.qcow2" 4
             secretRef: endpoint-secret 5
             certConfigMap: "" 6
       status: {}
     running: true
     template:
       metadata:
         creationTimestamp: null
         labels:
           kubevirt.io/vm: vm-fedora-datavolume
       spec:
         domain:
           devices:
             disks:
             - disk:
                 bus: virtio
               name: datavolumedisk1
           machine:
             type: ""
           resources:
             requests:
               memory: 1.5Gi
         terminationGracePeriodSeconds: 180
         volumes:
         - dataVolume:
             name: fedora-dv
           name: datavolumedisk1
   status: {}

   1

   仮想マシンの名前を指定します。

   2

   データボリュームの名前を指定します。

   3

   HTTP または HTTPS エンドポイントに http を指定します。レジストリーからインポートされたコンテナーディスクイメージの registry を指定します。

   4

   インポートする仮想マシンイメージの URL またはレジストリーエンドポイントを指定します。この例では、HTTPS エンドポイントで仮想マシンイメージを参照します。コンテナーレジストリーエンドポイントのサンプルは url: "docker://kubevirt/fedora-cloud-container-disk-demo:latest" です。

   5

   データソースの Secret を作成した場合は、Secret 名を指定します。

   6

   オプション: CA 証明書 config map を指定します。

4. 仮想マシンを作成します。

   $ oc create -f vm-fedora-datavolume.yaml

   注記

   oc create コマンドは、データボリュームおよび仮想マシンを作成します。CDI コントローラーは適切なアノテーションを使用して基礎となる PVC を作成し、インポートプロセスが開始されます。インポートが完了すると、データボリュームのステータスが Succeeded に変わります。仮想マシンを起動できます。

   データボリュームのプロビジョニングはバックグランドで実行されるため、これをプロセスをモニターする必要はありません。

検証

1. インポーター Pod は指定された URL から仮想マシンイメージまたはコンテナーディスクをダウンロードし、これをプロビジョニングされた PV に保存します。以下のコマンドを実行してインポーター Pod のステータスを確認します。

   $ oc get pods

2. 次のコマンドを実行して、ステータスが Succeeded になるまでデータボリュームを監視します。

   $ oc describe dv fedora-dv 1

   1

   VirtualMachine マニフェストで定義したデータボリューム名を指定します。

3. シリアルコンソールにアクセスして、プロビジョニングが完了し、仮想マシンが起動したことを確認します。

   $ virtctl console vm-fedora-datavolume

手順

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 にストレージクラスを設定します。これを省略する場合、クラスターのデフォルトが使用されます。

   4

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

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

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

   1

   直前の手順で作成された永続ボリュームのファイル名。

手順

1. データソースに認証が必要な場合は、データソースのクレデンシャルを指定して Secret マニフェストを作成し、endpoint-secret.yaml として保存します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: endpoint-secret 1
     labels:
       app: containerized-data-importer
   type: Opaque
   data:
     accessKeyId: "" 2
     secretKey:   "" 3

   1

   Secret の名前を指定します。

   2

   Base64 でエンコードされたキー ID またはユーザー名を指定します。

   3

   Base64 でエンコードされた秘密鍵またはパスワードを指定します。

2. Secret マニフェストを適用します。

   $ oc apply -f endpoint-secret.yaml

3. データ DataVolume マニフェストを作成し、仮想マシンイメージのデータソースと storage.volumeMode の Block を指定します。

   apiVersion: cdi.kubevirt.io/v1beta1
   kind: DataVolume
   metadata:
     name: import-pv-datavolume 1
   spec:
     storageClassName: local 2
       source:
         http:
           url: "https://mirror.arizona.edu/fedora/linux/releases/35/Cloud/x86_64/images/Fedora-Cloud-Base-35-1.2.x86_64.qcow2" 3
           secretRef: endpoint-secret 4
     storage:
       volumeMode: Block 5
       resources:
         requests:
           storage: 10Gi

   1

   データボリュームの名前を指定します。

   2

   オプション: ストレージクラスを設定するか、これを省略してクラスターのデフォルトを受け入れます。

   3

   インポートするイメージの HTTP または HTTPS URL を指定します。

   4

   データソースの Secret を作成した場合は、Secret 名を指定します。

   5

   ボリュームモードとアクセスモードは、既知のストレージプロビジョナーに対して自動的に検出されます。それ以外の場合は、Block を指定します。

4. 仮想マシンイメージをインポートするために data volume を作成します。

   $ oc create -f import-pv-datavolume.yaml