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

手順

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/v1alpha3
   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: 60
         volumes:
         - dataVolume:
             name: fedora-dv
           name: datavolumedisk1
   status: {}

   1

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

   2

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

   3

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

   4

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

   5

   データソースの 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 を作成した場合は必須です。

   5

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

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

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

手順

1. Web コンソールで、Workloads Virtual Machines をクリックします。
2. Create Virtual Machine をクリックし、Import with Wizard を選択します。
3. Provider 一覧で Red Hat Virtualization (RHV) を選択します。

4. Connect to New Instance または保存された RHV インスタンスを選択します。

   • Connect to New Instance を選択する場合は、以下のフィールドに入力します。

     • API URL: https://<RHV_Manager_FQDN>/ovirt-engine/api など。

     • CA certificate: Browse をクリックして RHV Manager CA 証明書をアップロードするか、またはフィールドに CA 証明書を貼り付けます。

       以下のコマンドを実行して CA 証明書を表示します。

       $ openssl s_client -connect <RHV_Manager_FQDN>:443 -showcerts < /dev/null

       CA 証明書は、出力内の 2 番目の証明書です。

     • Username: RHV Manager ユーザー名 (例: ocpadmin@internal)
     • Password: RHV Manager パスワード
   • 保存された RHV インスタンスを選択する場合、ウィザードは保存された認証情報を使用して RHV インスタンスに接続します。

5. Check and Save をクリックし、接続が完了するまで待ちます。

   注記

   接続の詳細はシークレットに保存されます。正しくない URL、ユーザー名またはパスワードを使用してプロバイダーを追加する場合、Workloads Secrets をクリックし、プロバイダーのシークレットを削除します。

6. クラスターおよび仮想マシンを選択します。
7. Next をクリックします。
8. Review 画面で、設定を確認します。
9. オプション:Start virtual machine on creation を選択します。

10. Edit をクリックして、以下の設定を更新します。

    • General Name: 仮想マシン名は 63 文字に制限されます。

    • General Description: 仮想マシンの説明 (オプション)。

      • Storage Class: NFS または ocs-storagecluster-ceph-rbd を選択します。

        ocs-storagecluster-ceph-rbd を選択する場合、ディスクの Volume Mode を Block に設定する必要があります。

      • Advanced Volume Mode: Block を選択します。
    • Advanced Volume Mode: Block を選択します。
    • Networking Network: 利用可能なネットワーク割り当て定義オブジェクトの一覧からネットワークを選択できます。

11. インポート設定を編集した場合は、Import または Review and Import をクリックします。

    Successfully created virtual machine というメッセージが表示され、仮想マシンに作成されたリソースの一覧が表示されます。仮想マシンが Workloads Virtual Machines に表示されます。

1. コマンドラインインターフェイスを使用してアクセスモードを変更できます。

手順

1. 以下のコマンドを実行して Secret CR を作成します。

   $ cat <<EOF | oc create -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: rhv-credentials
     namespace: default 1
   type: Opaque
   stringData:
     ovirt: |
       apiUrl: <api_endpoint> 2
       username: ocpadmin@internal
       password: 3
       caCert: |
         -----BEGIN CERTIFICATE-----
         4
         -----END CERTIFICATE-----
   EOF

   1

   オプション。すべての CR に異なる namespace を指定できます。

   2

   RHV Manager の API エンドポイントを指定します (例: \"https://www.example.com:8443/ovirt-engine/api")。

   3

   ocpadmin@internal のパスワードを指定します。

   4

   RHV Manager CA 証明書を指定します。以下のコマンドを実行して CA 証明書を取得できます。

   $ openssl s_client -connect :443 -showcerts < /dev/null

2. オプション: 以下のコマンドを実行して、リソースマッピングを VirtualMachineImport CR から分離する必要がある場合に ResourceMapping を作成します。

   $ cat <<EOF | kubectl create -f -
   apiVersion: v2v.kubevirt.io/v1alpha1
   kind: ResourceMapping
   metadata:
     name: resourcemapping_example
     namespace: default
   spec:
     ovirt:
       networkMappings:
         - source:
             name: <rhv_logical_network>/<vnic_profile> 1
           target:
             name: <target_network> 2
           type: pod
       storageMappings: 3
         - source:
             name: <rhv_storage_domain> 4
           target:
             name: <target_storage_class> 5
           volumeMode: <volume_mode> 6
   EOF

   1

   RHV の論理ネットワークおよび vNIC プロファイルを指定します。

   2

   OpenShift Virtualization ネットワークを指定します。

   3

   ストレージマッピングが ResourceMapping および VirtualMachineImport CR の両方に指定される場合、VirtualMachineImport CR が優先されます。

   4

   RHV ストレージドメインを指定します。

   5

   nfs または ocs-storagecluster-ceph-rbd を指定します。

   6

   ocs-storagecluster-ceph-rbd ストレージクラスを指定した場合、Block をボリュームモードとして指定する必要があります。

3. 以下のコマンドを実行して VirtualMachineImport CR を作成します。

   $ cat <<EOF | oc create -f -
   apiVersion: v2v.kubevirt.io/v1beta1
   kind: VirtualMachineImport
   metadata:
     name: vm-import
     namespace: default
   spec:
     providerCredentialsSecret:
       name: rhv-credentials
       namespace: default
   # resourceMapping: 1
   #   name: resourcemapping-example
   #   namespace: default
     targetVmName: vm_example 2
     startVm: true
     source:
       ovirt:
         vm:
           id: <source_vm_id> 3
           name: <source_vm_name> 4
         cluster:
           name: <source_cluster_name> 5
         mappings: 6
           networkMappings:
             - source:
                 name: <source_logical_network>/<vnic_profile> 7
               target:
                 name: <target_network> 8
               type: pod
           storageMappings: 9
             - source:
                 name: <source_storage_domain> 10
               target:
                 name: <target_storage_class> 11
               accessMode: <volume_access_mode> 12
           diskMappings:
             - source:
                 id: <source_vm_disk_id> 13
               target:
                 name: <target_storage_class> 14
   EOF

   1

   ResourceMapping CR を作成する場合、resourceMapping セクションのコメントを解除します。

   2

   ターゲットの仮想マシン名を指定します。

   3

   ソース仮想マシン ID を指定します (例: 80554327-0569-496b-bdeb-fcbbf52b827b)。Manager マシンの Web ブラウザーで https://www.example.com/ovirt-engine/api/vms/ を入力して仮想マシン ID を取得し、すべての仮想マシンを一覧表示できます。インポートする仮想マシンとその対応する仮想マシン ID を見つけます。仮想マシン名またはクラスター名を指定する必要はありません。

   4

   ソース仮想マシン名を指定する場合、ソースクラスターも指定する必要があります。ソース仮想マシン ID は指定しないでください。

   5

   ソースクラスターを指定する場合、ソース仮想マシン名も指定する必要があります。ソース仮想マシン ID は指定しないでください。

   6

   ResourceMapping CR を作成する場合、mappings セクションをコメントアウトします。

   7

   ソース仮想マシンの論理ネットワークおよび vNIC プロファイルを指定します。

   8

   OpenShift Virtualization ネットワークを指定します。

   9

   ストレージマッピングが ResourceMapping および VirtualMachineImport CR の両方に指定される場合、VirtualMachineImport CR が優先されます。

   10

   ソースストレージドメインを指定します。

   11

   ターゲットストレージクラスを指定します。

   12

   ReadWriteOnce、ReadWriteMany、または ReadOnlyMany を指定します。アクセスモードが指定されていない場合、{virt} は RHV 仮想マシンまたは仮想ディスクアクセスモード上の Host Migration mode 設定に基づいて正しいボリュームアクセスモードを判別します。

   • RHV 仮想マシン移行モードが Allow manual and automatic migration の場合、デフォルトのアクセスモードは ReadWriteMany になります。
   • RHV 仮想ディスクのアクセスモードが ReadOnly の場合、デフォルトのアクセスモードは ReadOnlyMany になります。
   • その他のすべての設定では、デフォルトのアクセスモードは ReadWriteOnce です。

   13

   ソース仮想マシンディスク ID を指定します (例: 8181ecc1-5db8-4193-9c92-3ddab3be7b05)。Manager マシンの Web ブラウザーで https://www.example.com/ovirt-engine/api/vms/vm23 を入力して仮想マシンの詳細を確認し、ディスク ID 取得できます。

   14

   ターゲットストレージクラスを指定します。

4. 仮想マシンインポートの進捗に従い、インポートが正常に完了したことを確認します。

   $ oc get vmimports vm-import -n default

   インポートが成功したことを示す出力は、以下のようになります。

   出力例

   ...
   status:
     conditions:
     - lastHeartbeatTime: "2020-07-22T08:58:52Z"
       lastTransitionTime: "2020-07-22T08:58:52Z"
       message: Validation completed successfully
       reason: ValidationCompleted
       status: "True"
       type: Valid
     - lastHeartbeatTime: "2020-07-22T08:58:52Z"
       lastTransitionTime: "2020-07-22T08:58:52Z"
       message: 'VM specifies IO Threads: 1, VM has NUMA tune mode specified: interleave'
       reason: MappingRulesVerificationReportedWarnings
       status: "True"
       type: MappingRulesVerified
     - lastHeartbeatTime: "2020-07-22T08:58:56Z"
       lastTransitionTime: "2020-07-22T08:58:52Z"
       message: Copying virtual machine disks
       reason: CopyingDisks
       status: "True"
       type: Processing
     dataVolumes:
     - name: fedora32-b870c429-11e0-4630-b3df-21da551a48c0
     targetVmName: fedora32

手順

1. Web コンソールで、Workloads Virtual Machines をクリックします。
2. Create Virtual Machine をクリックし、Import with Wizard を選択します。
3. Provider 一覧から、VMware を選択します。

4. Connect to New Instance または保存された vCenter インスタンスを選択します。

   • Connect to New Instance を選択する場合、vCenter hostname、Username、Password を入力します。
   • 保存された vCenter インスタンスを選択する場合、ウィザードは保存された認証情報を使用して vCenter に接続します。

5. Check and Save をクリックし、接続が完了するまで待ちます。

   注記

   接続の詳細はシークレットに保存されます。ホスト名、ユーザー名、またはパスワードが正しくないプロバイダーを追加した場合は、Workloads Secrets をクリックし、プロバイダーのシークレットを削除します。

6. 仮想マシンまたはテンプレートを選択します。
7. Next をクリックします。
8. Review 画面で、設定を確認します。

9. Edit をクリックして、以下の設定を更新します。

   • General:

     • 説明
     • オペレーティングシステム
     • Flavor
     • Memory
     • CPU
     • Workload Profile

   • Networking:

     • 名前
     • Model
     • Network
     • Type
     • MAC Address

   • ストレージ: 仮想マシンディスクの Options メニュー をクリックし、Edit を選択して以下のフィールドを更新します。

     • 名前
     • Source: Import Disk など。
     • Size
     • Interface

     • Storage Class: NFS または ocs-storagecluster-ceph-rbd (ceph-rbd) を選択します。

       ocs-storagecluster-ceph-rbd を選択する場合、ディスクの Volume Mode を Block に設定する必要があります。

       他のストレージクラスは機能する可能性がありますが、正式にサポートされていません。

     • Advanced Volume Mode: Block を選択します。
     • Advanced Access Mode

   • Advanced Cloud-init:

     • Form: Hostname および Authenticated SSH Keys を入力します。
     • Custom script: テキストフィールドに cloud-init スクリプトを入力します。
   • Advanced Virtual Hardware: 仮想 CD-ROM をインポートされた仮想マシンに割り当てることができます。

10. インポート設定を編集した場合は、Import または Review and Import をクリックします。

    Successfully created virtual machine というメッセージが表示され、仮想マシンに作成されたリソースの一覧が表示されます。仮想マシンが Workloads Virtual Machines に表示されます。