OpenShift Virtualization

手順

1. 正しいプロジェクトを指定していることを確認します。そうでない場合は、Project 一覧をクリックして適切なプロジェクトを選択します。
2. サイドメニューから Workloads → Virtualization をクリックします。
3. Virtual Machines タブをクリックします。
4. 仮想マシンを選択して、Virtual Machine Overview 画面を開きます。
5. Details タブで、virt-launcher-<vm-name> Pod をクリックします。
6. Terminal タブをクリックします。ターミナルが空白の場合、ターミナルをクリックし、任意のキーを押して接続を開始します。

手順

1. OpenShift Virtualization コンソールのサイドメニューから Workloads → Virtualization をクリックします。
2. Virtual Machines タブをクリックします。
3. 仮想マシンを選択して、Virtual Machine Overview 画面を開きます。
4. Consoles をクリックします。VNC コンソールがデフォルトで開きます。
5. VNC Console ドロップダウンリストをクリックし、Serial Console を選択します。

手順

1. OpenShift Virtualization コンソールのサイドメニューから Workloads → Virtualization をクリックします。
2. Virtual Machines タブをクリックします。
3. 仮想マシンを選択して、Virtual Machine Overview 画面を開きます。
4. Console タブをクリックします。VNC コンソールがデフォルトで開きます。

手順

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. 以下のコマンドを実行して fedora-vm-ssh サービスを作成します。

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

   1

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

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

   $ oc get svc

1. SSH 経由で仮想マシンインスタンスにログインします。ノードの 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. 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 の NetworkAttachmentDefinition ファイルを作成します。

      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. 直前の手順で作成したファイルを使用して NetworkAttachmentDefinition オブジェクトを作成します。

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

      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 にあることを確認します。ConfigMap は、同じ namespace にある場合に DataVolume によってのみ参照されます。

   $ oc get ns

2. ConfigMap を作成します。

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

手順

1. オプション: データソースに認証情報が必要な場合、endpoint-secret.yaml ファイルを編集し、更新された設定をクラスターに適用します。

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

   1

   オプション: キーまたはユーザー名 (base64 エンコード)

   2

   オプション: シークレットまたはパスワード、base64 エンコード

   $ oc apply -f endpoint-secret.yaml

2. 仮想マシン設定ファイルを編集し、インポートする必要のある仮想マシンイメージのデータソースを指定します。この例では、http ソースから Fedora イメージがインポートされます。

   apiVersion: kubevirt.io/v1alpha3
   kind: VirtualMachine
   metadata:
     creationTimestamp: null
     labels:
       kubevirt.io/vm: vm-fedora-datavolume
     name: vm-fedora-datavolume
   spec:
     dataVolumeTemplates:
     - metadata:
         creationTimestamp: null
         name: fedora-dv
       spec:
         pvc:
           accessModes:
           - ReadWriteOnce
           resources:
             requests:
               storage: 10Gi
           storageClassName: local
         source:
           http: 1
             url: "https://download.fedoraproject.org/pub/fedora/linux/releases/33/Cloud/x86_64/images/Fedora-Cloud-Base-33-1.2.x86_64.qcow2" 2
             secretRef: "" 3
             certConfigMap: "" 4
       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: "" 5
           resources:
             requests:
               memory: 1.5Gi
         terminationGracePeriodSeconds: 60
         volumes:
         - dataVolume:
             name: fedora-dv
           name: datavolumedisk1
   status: {}

   1

   イメージのインポート元となるソースタイプ。この例では、HTTP エンドポイントを使用します。レジストリーからコンテナーディスクをインポートするには、http を registry に置き換えます。

   2

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

   3

   secretRef パラメーターはオプションです。

   4

   certConfigMap は、自己署名証明書またはシステム CA バンドルで署名されていない証明書を使用するサーバーと通信するために必要です。参照される ConfigMap は DataVolume と同じ namespace にある必要があります。

   5

   type: dataVolume または type: "" を指定します。persistentVolumeClaim などの type に他の値を指定すると、警告が表示され、仮想マシンは起動しません。

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

   $ oc create -f vm-<name>-datavolume.yaml

   注記

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

   DataVolume のプロビジョニングはバックグランドで実行されるため、これをモニターする必要はありません。仮想マシンは起動できますが、これはインポートが完了するまで実行されません。

検証

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

   $ oc get pods

2. 以下のコマンドを実行し、Succeeded が表示されるまで DataVolume のステータスをモニターします。

   $ oc describe dv <datavolume-name> 1

   1

   仮想マシン設定ファイルの dataVolumeTemplates.metadata.name で指定される DataVolume の名前。上記の設定例では、これは fedora-dv です。

3. プロビジョニングが完了し、VMI が起動したことを検証するには、以下のコマンドを実行してそのシリアルコンソールへのアクセスを試行します。

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

   4

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

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

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

   1

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

手順

1. データソースに認証情報が必要な場合、endpoint-secret.yaml ファイルを編集し、更新された設定をクラスターに適用します。

   1. 選択するテキストエディターで endpoint-secret.yaml ファイルを編集します。

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

      1

      オプション: キーまたはユーザー名 (base64 エンコード)

      2

      オプション: シークレットまたはパスワード、base64 エンコード

   2. 以下のコマンドを実行してシークレットを更新します。

      $ oc apply -f endpoint-secret.yaml

2. インポートするイメージのデータソースを指定する DataVolume および volumeMode: Block を作成して、利用可能なブロック PV が使用されるようにします。

   apiVersion: cdi.kubevirt.io/v1alpha1
   kind: DataVolume
   metadata:
     name: <import-pv-datavolume> 1
   spec:
     storageClassName: local 2
     source:
         http:
            url: <http://download.fedoraproject.org/pub/fedora/linux/releases/28/Cloud/x86_64/images/Fedora-Cloud-Base-28-1.1.x86_64.qcow2> 3
            secretRef: <endpoint-secret> 4
     pvc:
       volumeMode: Block 5
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: <2Gi>

   1

   DataVolume の名前。

   2

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

   3

   インポートするイメージの HTTP ソース。

   4

   データソースに認証が必要である場合にのみ必要です。

   5

   ブロック PV にインポートするために必要です。

3. 以下のコマンドを実行して、仮想マシンイメージをインポートするために DataVolume を作成します。

   $ oc create -f <import-pv-datavolume.yaml>1

   1

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

手順

1. Web ブラウザーで、http://<RHV_Manager_FQDN>/ovirt-engine/api/vms/<VM_ID> に移動して RHV 仮想マシンオペレーティングシステムの REST API 名を特定します。以下の例のように、オペレーティングシステム名が XML 出力の <os> セクションに表示されます。

   ...
   <os>
   ...
   <type>rhel_8x64</type>
   </os>

2. 利用可能な OpenShift Virtualization テンプレートの一覧を表示します。

   $ oc get templates -n openshift --show-labels | tr ',' '\n' | grep os.template.kubevirt.io | sed -r 's#os.template.kubevirt.io/(.*)=.*#\1#g' | sort -u

   出力例

   fedora31
   fedora32
   ...
   rhel8.1
   rhel8.2
   ...

3. RHV 仮想マシンオペレーティングシステムに一致する OpenShift Virtualization テンプレートが利用可能なテンプレートの一覧に表示されない場合は、OpenShift Virtualization Web コンソールでテンプレートを作成します。

4. RHV 仮想マシンオペレーティングシステムを OpenShift Virtualization テンプレートにマップするために ConfigMap を作成します。

   $ cat <<EOF | oc create -f -
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: os-configmap
     namespace: default 1
   data:
     guestos2common: |
       "Red Hat Enterprise Linux Server": "rhel"
       "CentOS Linux": "centos"
       "Fedora": "fedora"
       "Ubuntu": "ubuntu"
       "openSUSE": "opensuse"
     osinfo2common: |
       "<rhv-operating-system>": "<vm-template>" 2
   EOF

   1

   オプション: namespace パラメーターの値を変更できます。

   2

   以下の例のように、RHV オペレーティングシステムおよび対応する仮想マシンテンプレートの REST API 名を指定します。

   ConfigMap の例

   $ cat <<EOF | oc apply -f -
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: os-configmap
     namespace: default
   data:
     osinfo2common: |
       "other_linux": "fedora31"
   EOF

5. カスタム ConfigMap が作成されていることを確認します。

   $ oc get cm -n default os-configmap -o yaml

6. kubevirt-hyperconverged-operator.v2.4.9.yaml ファイルを編集します。

   $ oc edit clusterserviceversion -n openshift-cnv kubevirt-hyperconverged-operator.v2.4.9

7. vm-import-operator デプロイメントマニフェストの以下のパラメーターを更新します。

   ...
   spec:
     containers:
     - env:
       ...
       - name: OS_CONFIGMAP_NAME
         value: os-configmap 1
       - name: OS_CONFIGMAP_NAMESPACE
         value: default 2

   1

   value: os-configmap を name: OS_CONFIGMAP_NAME パラメーターに追加します。

   2

   オプション: ConfigMap で namespace を変更した場合にこの値を追加できます。

8. kubevirt-hyperconverged-operator.v2.4.9.yaml ファイルを保存します。

   vm-import-operator デプロイメントを更新すると、vm-import-controller ConfigMap が更新されます。

9. テンプレートが OpenShift Virtualization Web コンソールに表示されることを確認します。

   1. サイドメニューから Workloads → Virtualization をクリックします。
   2. Virtual Machine Templates タブをクリックして、一覧でテンプレートを見つけます。

手順

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 ユーザー名 (例: admin@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. 以下のコマンドを実行してシークレット 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: admin@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

   admin@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/v1alpha1
   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 です。

手順

1. Workloads → Virtual Machines をクリックします。
2. インポートする仮想マシンの Options メニュー をクリックし、Delete Virtual Machine を選択します。

3. Delete Virtual Machine ウィンドウで Delete をクリックします。

   仮想マシンは仮想マシンの一覧から削除されます。

手順

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: masquerade バインディングメソッドを選択する必要があります。
     • 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 に表示されます。

手順

1. ClusterRole マニフェストを作成します。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: <datavolume-cloner> 1
   rules:
   - apiGroups: ["cdi.kubevirt.io"]
     resources: ["datavolumes/source"]
     verbs: ["*"]

   1

   ClusterRole の一意の名前。

2. クラスターに ClusterRole を作成します。

   $ oc create -f <datavolume-cloner.yaml> 1

   1

   直前の手順で作成された ClusterRole マニフェストのファイル名です。

3. 移行元および宛先 namespace の両方に適用される RoleBinding マニフェストを作成し、直前の手順で作成した ClusterRole を参照します。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: RoleBinding
   metadata:
     name: <allow-clone-to-user> 1
     namespace: <Source namespace> 2
   subjects:
   - kind: ServiceAccount
     name: default
     namespace: <Destination namespace> 3
   roleRef:
     kind: ClusterRole
     name: datavolume-cloner 4
     apiGroup: rbac.authorization.k8s.io

   1

   RoleBinding の一意の名前。

   2

   ソース DataVolume の namespace。

   3

   DataVolume のクローンが作成される namespace。

   4

   直前の手順で作成した ClusterRole の名前。

4. クラスターに RoleBinding を作成します。

   $ oc create -f <datavolume-cloner.yaml> 1

   1

   直前の手順で作成された RoleBinding マニフェストのファイル名です。

手順

1. 関連付けられた PVC の名前および namespace を特定するために、クローン作成に必要な仮想マシンディスクを確認します。

2. 新規 DataVolume の名前、ソース PVC の名前および namespace、および新規 DataVolume のサイズを指定する DataVolume オブジェクトの YAML ファイルを作成します。

   以下は例になります。

   apiVersion: cdi.kubevirt.io/v1alpha1
   kind: DataVolume
   metadata:
     name: <cloner-datavolume> 1
   spec:
     source:
       pvc:
         namespace: "<source-namespace>" 2
         name: "<my-favorite-vm-disk>" 3
     pvc:
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: <2Gi> 4

   1

   新規 DataVolume の名前。

   2

   ソース PVC が存在する namespace。

   3

   ソース PVC の名前。

   4

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

3. DataVolume を作成して PVC のクローン作成を開始します。

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

   注記

   DataVolume は仮想マシンが PVC の作成前に起動することを防ぐため、PVC のクローン作成中に新規 DataVolume を参照する仮想マシンを作成できます。

手順

1. 関連付けられた PVC の名前および namespace を特定するために、クローン作成に必要な仮想マシンを確認します。

2. VirtualMachine オブジェクトの YAML ファイルを作成します。以下の仮想マシンのサンプルでは、source-namespace namespace にある my-favorite-vm-disk のクローンを作成します。favorite-clone という 2Gi DataVolume が my-favorite-vm-disk から作成されます。

   以下は例になります。

   apiVersion: kubevirt.io/v1alpha3
   kind: VirtualMachine
   metadata:
     labels:
       kubevirt.io/vm: vm-dv-clone
     name: vm-dv-clone 1
   spec:
     running: false
     template:
       metadata:
         labels:
           kubevirt.io/vm: vm-dv-clone
       spec:
         domain:
           devices:
             disks:
             - disk:
                 bus: virtio
               name: root-disk
           resources:
             requests:
               memory: 64M
         volumes:
         - dataVolume:
             name: favorite-clone
           name: root-disk
     dataVolumeTemplates:
     - metadata:
         name: favorite-clone
       spec:
         pvc:
           accessModes:
           - ReadWriteOnce
           resources:
             requests:
               storage: 2Gi
         source:
           pvc:
             namespace: "source-namespace"
             name: "my-favorite-vm-disk"

   1

   作成する仮想マシン。

3. PVC のクローンが作成された DataVolume で仮想マシンを作成します。

   $ oc create -f <vm-clone-datavolumetemplate>.yaml