7.2. カスタムイメージからの仮想マシンの作成

手順

1. Dockerfile を作成して、仮想マシンイメージをコンテナーイメージにビルドします。仮想マシンイメージは、UID 107 を持つ QEMU によって所有され、コンテナー内の /disk/ ディレクトリーに配置される必要があります。次に、/disk/ ディレクトリーのパーミッションは 0440 に設定する必要があります。

   以下の例では、Red Hat Universal Base Image (UBI) を使用して最初の段階でこれらの設定変更を処理し、2 番目の段階で最小の scratch イメージを使用して結果を保存します。

   $ cat > Dockerfile << EOF
   FROM registry.access.redhat.com/ubi8/ubi:latest AS builder
   ADD --chown=107:107 <vm_image>.qcow2 /disk/ 1
   RUN chmod 0440 /disk/*
   
   FROM scratch
   COPY --from=builder /disk/* /disk/
   EOF

   1

   <vm_image> は、QCOW2 または RAW 形式のイメージです。リモートイメージを使用する場合は、<vm_image>.qcow2 を完全な URL に置き換えます。

2. コンテナーをビルドし、これにタグ付けします。

   $ podman build -t <registry>/<container_disk_name>:latest .

3. コンテナーイメージをレジストリーにプッシュします。

   $ podman push <registry>/<container_disk_name>:latest

前提条件

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

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

2. セキュアでないレジストリーのリストを spec.storageImport.insecureRegistries フィールドに追加します。

   HyperConverged カスタムリソースの例

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:
     storageImport:
       insecureRegistries: 1
         - "private-registry-example-1:5000"
         - "private-registry-example-2:5000"

   1

   このリストのサンプルを、有効なレジストリーホスト名に置き換えます。

手順

1. Web コンソールで Virtualization Catalog に移動します。
2. 使用可能なブートソースのないテンプレートタイルをクリックします。
3. Customize VirtualMachine をクリックします。
4. Customize template parameters ページで、Storage を展開し、Disk source リストから Registry (creates PVC) を選択します。
5. コンテナーイメージの URL を入力します。例: https://mirror.arizona.edu/fedora/linux/releases/38/Cloud/x86_64/images/Fedora-Cloud-Base-38-1.6.x86_64.qcow2
6. ディスクサイズを設定します。
7. Next をクリックします。
8. Create VirtualMachine をクリックします。

手順

1. コンテナーレジストリーで認証が必要な場合は、認証情報を指定して Secret マニフェストを作成し、data-source-secret.yaml ファイルとして保存します。

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

   1

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

   2

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

2. 次のコマンドを実行して Secret マニフェストを取得します。

   $ oc apply -f data-source-secret.yaml

3. 仮想マシンが自己署名証明書またはシステム CA バンドルによって署名されていない証明書を使用するサーバーと通信する必要がある場合は、仮想マシンと同じ namespace に config map を作成します。

   $ oc create configmap tls-certs 1
     --from-file=</path/to/file/ca.pem> 2

   1

   config map 名を指定します。

   2

   CA 証明書へのパスを指定します。

4. 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 3
           storageClassName: <storage_class> 4
         source:
           registry:
             url: "docker://kubevirt/fedora-cloud-container-disk-demo:latest" 5
             secretRef: data-source-secret 6
             certConfigMap: tls-certs 7
       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

   データボリュームに要求されるストレージのサイズを指定します。

   4

   オプション: ストレージクラスを指定しない場合は、デフォルトのストレージクラスが適用されます。

   5

   コンテナーレジストリーの URL を指定します。

   6

   オプション: コンテナーレジストリーアクセス認証情報のシークレットを作成した場合は、シークレット名を指定します。

   7

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

5. 次のコマンドを実行して VM を作成します。

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

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

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

検証

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

   $ oc get pods

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

   $ oc describe dv fedora-dv 1

   1

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

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

   $ virtctl console vm-fedora-datavolume

手順

1. Web コンソールで Virtualization Catalog に移動します。
2. 使用可能なブートソースのないテンプレートタイルをクリックします。
3. Customize VirtualMachine をクリックします。
4. Customize template parameters ページで、Storage を展開し、Disk source リストから URL (creates PVC) を選択します。
5. イメージの URL を入力します。例: https://access.redhat.com/downloads/content/69/ver=/rhel---7/7.9/x86_64/product-software
6. コンテナーイメージの URL を入力します。例: https://mirror.arizona.edu/fedora/linux/releases/38/Cloud/x86_64/images/Fedora-Cloud-Base-38-1.6.x86_64.qcow2
7. ディスクサイズを設定します。
8. Next をクリックします。
9. Create VirtualMachine をクリックします。

手順

1. Web ページで認証が必要な場合は、認証情報を指定して Secret マニフェストを作成し、data-source-secret.yaml ファイルとして保存します。

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

   1

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

   2

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

2. 次のコマンドを実行して Secret マニフェストを取得します。

   $ oc apply -f data-source-secret.yaml

3. 仮想マシンが自己署名証明書またはシステム CA バンドルによって署名されていない証明書を使用するサーバーと通信する必要がある場合は、仮想マシンと同じ namespace に config map を作成します。

   $ oc create configmap tls-certs 1
     --from-file=</path/to/file/ca.pem> 2

   1

   config map 名を指定します。

   2

   CA 証明書へのパスを指定します。

4. 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 3
           storageClassName: <storage_class> 4
         source:
           http:
             url: "https://mirror.arizona.edu/fedora/linux/releases/35/Cloud/x86_64/images/Fedora-Cloud-Base-35-1.2.x86_64.qcow2" 5
           registry:
             url: "docker://kubevirt/fedora-cloud-container-disk-demo:latest" 6
             secretRef: data-source-secret 7
             certConfigMap: tls-certs 8
       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

   データボリュームに要求されるストレージのサイズを指定します。

   4

   オプション: ストレージクラスを指定しない場合は、デフォルトのストレージクラスが適用されます。

   5 6

   Web ページの URL を指定します。

   7

   オプション: Web ページのアクセス認証情報のシークレットを作成した場合は、シークレット名を指定します。

   8

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

5. 次のコマンドを実行して VM を作成します。

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

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

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

検証

1. インポーター Pod は、指定された URL からイメージをダウンロードし、プロビジョニングされた永続ボリュームに保存します。以下のコマンドを実行してインポーター Pod のステータスを確認します。

   $ oc get pods

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

   $ oc describe dv fedora-dv 1

   1

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

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

   $ virtctl console vm-fedora-datavolume

手順

1. Web コンソールで Virtualization Catalog に移動します。
2. 使用可能なブートソースのないテンプレートタイルをクリックします。
3. Customize VirtualMachine をクリックします。
4. Customize template parameters ページで、Storage を展開し、Disk source リストから Upload (Upload a new file to a PVC) を選択します。
5. ローカルマシン上のイメージを参照し、ディスクサイズを設定します。
6. Customize VirtualMachine をクリックします。
7. Create VirtualMachine をクリックします。

手順

1. Windows イメージを新しい PVC としてアップロードします。

   1. Web コンソールで Storage PersistentVolumeClaims に移動します。
   2. Create PersistentVolumeClaim With Data upload form をクリックします。
   3. Windows イメージを参照して選択します。

   4. PVC 名を入力し、ストレージクラスとサイズを選択して、Upload をクリックします。

      Windows イメージは PVC にアップロードされます。

2. アップロードされた PVC のクローンを作成して、新しい仮想マシンを設定します。

   1. Virtualization Catalog に移動します。
   2. Windows テンプレートタイルを選択し、Customize VirtualMachine をクリックします。
   3. Disk source リストから Clone (clone PVC) を選択します。
   4. PVC プロジェクト、Windows イメージ PVC、およびディスクサイズを選択します。

3. アンサーファイルを仮想マシンに適用します。

   1. VirtualMachine パラメーターのカスタマイズ をクリックします。
   2. Scripts タブの Sysprep セクションで、Edit をクリックします。
   3. autounattend.xml 応答ファイルを参照し、Save をクリックします。

4. 仮想マシンの実行戦略を設定します。

   1. 仮想マシンがすぐに起動しないように、Start this VirtualMachine after creation をオフにします。
   2. Create VirtualMachine をクリックします。
   3. YAML タブで、running:false を runStrategy: RerunOnFailure に置き換え、Save をクリックします。

5. オプションメニュー をクリックして Start を選択します。

   仮想マシンは、autounattend.xml アンサーファイルを含む sysprep ディスクから起動します。

手順

1. virtctl image-upload コマンドを実行してイメージをアップロードします。

   $ virtctl image-upload dv <datavolume_name> \ 1
     --size=<datavolume_size> \ 2
     --image-path=</path/to/image> \ 3

   1

   データボリュームの名前。

   2

   データボリュームのサイズ。例: --size=500Mi、--size=1G

   3

   イメージのファイルパス。

   注記
   • 新規データボリュームを作成する必要がない場合は、--size パラメーターを省略し、--no-create フラグを含めます。
   • ディスクイメージを PVC にアップロードする場合、PVC サイズは圧縮されていない仮想ディスクのサイズよりも大きくなければなりません。
   • HTTPS を使用したセキュアでないサーバー接続を許可するには、--insecure パラメーターを使用します。--insecure フラグを使用する際に、アップロードエンドポイントの信頼性は検証 されない 点に注意してください。

2. オプション: データボリュームが作成されたことを確認するには、以下のコマンドを実行してすべてのデータボリュームを表示します。

   $ oc get dvs

手順

1. Web コンソールで Virtualization Catalog に移動します。
2. 使用可能なブートソースのないテンプレートタイルをクリックします。
3. Customize VirtualMachine をクリックします。
4. テンプレートパラメーターのカスタマイズ ページで、Storage を展開し、Disk source リストから PVC (clone PVC) を選択します。
5. イメージの URL を入力します。例: https://access.redhat.com/downloads/content/69/ver=/rhel---7/7.9/x86_64/product-software
6. コンテナーイメージの URL を入力します。例: https://mirror.arizona.edu/fedora/linux/releases/38/Cloud/x86_64/images/Fedora-Cloud-Base-38-1.6.x86_64.qcow2
7. PVC プロジェクトと PVC 名を選択します。
8. ディスクサイズを設定します。
9. Next をクリックします。
10. Create VirtualMachine をクリックします。