手順

1. サイドメニューから Workloads → Virtualization をクリックします。
2. Virtual Machines タブをクリックします。
3. Create Virtual Machine をクリックし、New from YAML を選択します。

4. 編集可能なウィンドウで仮想マシンの設定を作成するか、またはこれを貼り付けます。

   1. または、YAML 画面にデフォルトで提供される example 仮想マシンを使用します。
5. オプション: Download をクリックして YAML 設定ファイルをその現在の状態でダウンロードします。
6. Create をクリックして仮想マシンを作成します。

手順

1. OpenShift Virtualization コンソールのサイドメニューから Workloads → Virtualization をクリックします。
2. Virtual Machines タブをクリックします。
3. 仮想マシンを選択して、Virtual Machine Overview ページを開きます。
4. Consoles をクリックします。VNC コンソールがデフォルトで開きます。
5. 一度に 1 つのコンソールセッションのみが開かれるようにするには、Disconnect before switching を選択します。それ以外の場合、VNC コンソール セッションはバックグラウンドでアクティブなままになります。
6. VNC Console ドロップダウンリストをクリックし、Serial Console を選択します。
7. Disconnect をクリックして、コンソールセッションを終了します。
8. オプション: Open Console in New Window をクリックして、別のウィンドウでシリアルコンソールを開きます。

手順

1. OpenShift Virtualization コンソールのサイドメニューから Workloads → Virtualization をクリックします。
2. Virtual Machines タブをクリックします。
3. 仮想マシンを選択して、Virtual Machine Overview ページを開きます。
4. Console タブをクリックします。VNC コンソールがデフォルトで開きます。
5. オプション: Open Console in New Window をクリックして、別のウィンドウで VNC コンソールを開きます。
6. オプション: Send Key をクリックして、キーの組み合わせを仮想マシンに送信します。

手順

1. OpenShift Virtualization コンソールのサイドメニューから Workloads → Virtualization をクリックします。
2. Virtual Machines タブをクリックします。
3. Windows 仮想マシンを選択して、Virtual Machine Overview 画面を開きます。
4. Console タブをクリックします。
5. Console 一覧で、Desktop Viewer を選択します。
6. Network Interface 一覧で、 layer-2 NIC を選択します。
7. Launch Remote Desktop をクリックし、 console.rdp ファイルをダウンロードします。

8. RDP クライアントを開き、console.rdp ファイルを参照します。たとえば、remmina を使用します。

   $ remmina --connect /path/to/console.rdp

9. Administrator ユーザー名およびパスワードを入力して、Windows 仮想マシンに接続します。

手順

1. OpenShift Container Platform コンソールで、サイドメニューから Workloads → Virtualization をクリックします。
2. Virtual Machines タブをクリックします。
3. 仮想マシンを選択して、Virtual Machine Overview ページを開きます。
4. Actions リストから Copy SSH Command を選択します。このコマンドを OpenShift CLI (oc) に貼り付けることができるようになりました。

手順

1. 以下のコマンドを実行して fedora-vm-ssh サービスを作成します。

   $ virtctl expose vm <fedora-vm> --port=22 --name=fedora-vm-ssh --type=NodePort 1

   1

   <fedora-vm> は、fedora-vm-ssh サービスを実行する仮想マシンの名前です。

2. サービスをチェックし、サービスが取得したポートを見つけます。

   $ oc get svc

1. SSH 経由で VMI にログインします。クラスターノードの ipAddress および直前の手順で確認したポートを使用します。

   $ ssh username@<node_IP_address> -p 32551

手順

1. virtctl ユーティリティーを使用してグラフィカルインターフェイスに接続します。

   $ virtctl vnc <VMI>

2. コマンドが失敗した場合には、トラブルシューティング情報を収集するために -v フラグの使用を試行します。

   $ virtctl vnc <VMI> -v 4

手順

1. アクセストークンを持つユーザーとして、oc CLI ツールを使って OpenShift Virtualization クラスターにログインします。

   $ oc login -u <user> https://<cluster.example.com>:8443

2. oc describe vmi を使用して、実行中の Windows 仮想マシンの設定を表示します。

   $ oc describe vmi <windows-vmi-name>

   出力例

   ...
   spec:
     networks:
     - name: default
       pod: {}
     - multus:
         networkName: cnv-bridge
       name: bridge-net
   ...
   status:
     interfaces:
     - interfaceName: eth0
       ipAddress: 198.51.100.0/24
       ipAddresses:
         198.51.100.0/24
       mac: a0:36:9f:0f:b1:70
       name: default
     - interfaceName: eth1
       ipAddress: 192.0.2.0/24
       ipAddresses:
         192.0.2.0/24
         2001:db8::/32
       mac: 00:17:a4:77:77:25
       name: bridge-net
   ...

3. レイヤー 2 ネットワークインターフェイスの IP アドレスを特定し、これをコピーします。これは直前の例では 192.0.2.0 であり、IPv6 を選択する場合は 2001:db8:: になります。
4. RDP クライアントを開き、接続用に直前の手順でコピーした IP アドレスを使用します。
5. Administrator ユーザー名およびパスワードを入力して、Windows 仮想マシンに接続します。

手順

1. 仮想マシンを起動し、グラフィカルコンソールに接続します。
2. Windows ユーザーセッションにログインします。

3. Device Manager を開き、Other devices を拡張して、Unknown device を一覧表示します。

   1. Device Properties を開いて、不明なデバイスを特定します。デバイスを右クリックし、Properties を選択します。
   2. Details タブをクリックし、Property リストで Hardware Ids を選択します。
   3. Hardware Ids の Value をサポートされる VirtIO ドライバーと比較します。
4. デバイスを右クリックし、Update Driver Software を選択します。
5. Browse my computer for driver software をクリックし、VirtIO ドライバーが置かれている割り当て済みの SATA CD ドライブの場所に移動します。ドライバーは、ドライバーのタイプ、オペレーティングシステム、および CPU アーキテクチャー別に階層的に編成されます。
6. Next をクリックしてドライバーをインストールします。
7. 必要なすべての VirtIO ドライバーに対してこのプロセスを繰り返します。
8. ドライバーのインストール後に、Close をクリックしてウィンドウを閉じます。
9. 仮想マシンを再起動してドライバーのインストールを完了します。

手順

1. 仮想マシンを起動し、グラフィカルコンソールに接続します。
2. Windows インストールプロセスを開始します。
3. Advanced インストールを選択します。
4. ストレージの宛先は、ドライバーがロードされるまで認識されません。Load driver をクリックします。
5. ドライバーは SATA CD ドライブとして割り当てられます。OK をクリックし、CD ドライバーでロードするストレージドライバーを参照します。ドライバーは、ドライバーのタイプ、オペレーティングシステム、および CPU アーキテクチャー別に階層的に編成されます。
6. 必要なすべてのドライバーについて直前の 2 つの手順を繰り返します。
7. Windows インストールを完了します。

手順

1. kubevirt_vm タスクを含むように Ansible Playbook YAML ファイルを編集します。

     kubevirt_vm:
       namespace:
       name:
       cpu_cores:
       memory:
       disks:
         - name:
           volume:
             containerDisk:
               image:
           disk:
             bus:

   注記

   このスニペットには Playbook の kubevirt_vm 部分のみが含まれます。

2. namespace、cpu_cores の数、memory、および disks を含む、作成する必要のある仮想マシンを反映させるように値を編集します。以下に例を示します。

     kubevirt_vm:
       namespace: default
       name: vm1
       cpu_cores: 1
       memory: 64Mi
       disks:
         - name: containerdisk
           volume:
             containerDisk:
               image: kubevirt/cirros-container-disk-demo:latest
           disk:
             bus: virtio

3. 仮想マシンを作成後すぐに起動する必要がある場合には、state: running を YAML ファイルに追加します。以下に例を示します。

     kubevirt_vm:
       namespace: default
       name: vm1
       state: running 1
       cpu_cores: 1

   1

   この値を state: absent に変更すると、すでに存在する場合に仮想マシンは削除されます。

4. Playbook のファイル名を引数としてのみ使用して、 ansible-playbook コマンドを実行します。

   $ ansible-playbook create-vm.yaml

5. 出力を確認し、プレイが正常に実行されたかどうかを確認します。

   出力例

   (...)
   TASK [Create my first VM] ************************************************************************
   changed: [localhost]
   
   PLAY RECAP ********************************************************************************************************
   localhost                  : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

6. Playbook ファイルに state: running を含めず、すぐに仮想マシンを起動する必要がある場合には、 state: running を含めるようにファイルを編集し、Playbook を再度実行します。

   $ ansible-playbook create-vm.yaml

手順

1. クラスターに PXE ネットワークを設定します。

   1. PXE ネットワーク pxe-net-conf のネットワーク接続定義ファイルを作成します。

      apiVersion: "k8s.cni.cncf.io/v1"
      kind: NetworkAttachmentDefinition
      metadata:
        name: pxe-net-conf
      spec:
        config: '{
          "cniVersion": "0.3.1",
          "name": "pxe-net-conf",
          "plugins": [
            {
              "type": "cnv-bridge",
              "bridge": "br1",
              "vlan": 1 1
            },
            {
              "type": "cnv-tuning" 2
            }
          ]
        }'

      1

      オプション: VLAN タグ。

      2

      cnv-tuning プラグインは、カスタム MAC アドレスのサポートを提供します。

      注記

      仮想マシンインスタンスは、必要な VLAN のアクセスポートでブリッジ br1 に割り当てられます。

2. 直前の手順で作成したファイルを使用してネットワーク接続定義を作成します。

   $ oc create -f pxe-net-conf.yaml

3. 仮想マシンインスタンス設定ファイルを、インターフェイスおよびネットワークの詳細を含めるように編集します。

   1. PXE サーバーで必要な場合には、ネットワークおよび MAC アドレスを指定します。MAC アドレスが指定されていない場合、値は自動的に割り当てられます。ただし、この時点で自動的に割り当てられる MAC アドレスは永続しないことに注意してください。

      bootOrder が 1 に設定されており、インターフェイスが最初に起動することを確認します。この例では、インターフェイスは <pxe-net> というネットワークに接続されています。

      interfaces:
      - masquerade: {}
        name: default
      - bridge: {}
        name: pxe-net
        macAddress: de:00:00:00:00:de
        bootOrder: 1

      注記

      複数のインターフェイスおよびディスクのブートの順序はグローバル順序になります。

   2. オペレーティングシステムのプロビジョニング後に起動が適切に実行されるよう、ブートデバイス番号をディスクに割り当てます。

      ディスク bootOrder の値を 2 に設定します。

      devices:
        disks:
        - disk:
            bus: virtio
          name: containerdisk
          bootOrder: 2

   3. 直前に作成されたネットワーク接続定義に接続されるネットワークを指定します。このシナリオでは、<pxe-net> は <pxe-net-conf> というネットワーク接続定義に接続されます。

      networks:
      - name: default
        pod: {}
      - name: pxe-net
        multus:
          networkName: pxe-net-conf

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

   $ oc create -f vmi-pxe-boot.yaml

1. 仮想マシンインスタンスの実行を待機します。

   $ oc get vmi vmi-pxe-boot -o yaml | grep -i phase
     phase: Running

2. VNC を使用して仮想マシンインスタンスを表示します。

   $ virtctl vnc vmi-pxe-boot

3. ブート画面で、PXE ブートが正常に実行されていることを確認します。

4. 仮想マシンインスタンスにログインします。

   $ virtctl console vmi-pxe-boot

5. 仮想マシンのインターフェイスおよび MAC アドレスを確認し、ブリッジに接続されたインターフェイスに MAC アドレスが指定されていることを確認します。この場合、PXE ブートには IP アドレスなしに eth1 を使用しています。他のインターフェイス eth0 は OpenShift Container Platform から IP アドレスを取得しています。

   $ ip addr

手順

1. 仮想マシンインスタンスに対し、クラスターから要求された以上のメモリーが利用可能であることを明示的に示すために、仮想マシン設定ファイルを編集し、spec.domain.memory.guest を spec.domain.resources.requests.memory よりも高い値に設定します。このプロセスはメモリーのオーバーコミットと呼ばれています。

   以下の例では、1024M がクラスターから要求されますが、仮想マシンインスタンスには 2048M が利用可能であると通知されます。ノードに利用可能な空のメモリーが十分にある限り、仮想マシンインスタンスは最大 2048M を消費します。

   kind: VirtualMachine
   spec:
     template:
       domain:
       resources:
           requests:
             memory: 1024M
       memory:
           guest: 2048M

   注記

   ノードがメモリー不足の状態になると、Pod のエビクションルールと同じルールが仮想マシンインスタンスに適用されます。

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

   $ oc create -f <file_name>.yaml

手順

1. ゲストメモリーオーバーヘッドアカウンティングを無効にするには、YAML 設定ファイルを編集し、overcommitGuestOverhead の値を true に設定します。このパラメーターはデフォルトで無効にされています。

   kind: VirtualMachine
   spec:
     template:
       domain:
       resources:
           overcommitGuestOverhead: true
           requests:
             memory: 1024M

   注記

   overcommitGuestOverhead が有効にされている場合、これはゲストのオーバーヘッドをメモリー制限 (ある場合) に追加します。

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

   $ oc create -f <file_name>.yaml

手順

1. 仮想マシン設定で、resources.requests.memory および memory.hugepages.pageSize パラメーターを spec.domain に追加します。以下の設定スニペットは、ページサイズが 1Gi の合計 4Gi メモリーを要求する仮想マシンについてのものです。

   kind: VirtualMachine
   ...
   spec:
     domain:
       resources:
         requests:
           memory: "4Gi" 1
       memory:
         hugepages:
           pageSize: "1Gi" 2
   ...

   1

   仮想マシンに要求されるメモリーの合計量。この値はページサイズで分ける必要があります。

   2

   各 Huge Page のサイズ。x86_64 アーキテクチャーの有効な値は 1Gi および 2Mi です。ページサイズは要求されたメモリーよりも小さくなければなりません。

2. 仮想マシン設定を適用します。

   $ oc apply -f <virtual_machine>.yaml

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. 仮想マシンを選択して、Virtual Machine Overview ページを開きます。
3. Details タブをクリックします。
4. Dedicated Resources フィールドの右側にある鉛筆アイコンをクリックして、Dedicated Resources ウィンドウを開きます。
5. Schedule this workload with dedicated resources (guaranteed policy) を選択します。
6. Save をクリックします。

手順

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 に表示されます。