手順

1. 以下のコマンドを実行して kubevirt-hyperconverged namespace を作成します。

   $ oc new-project kubevirt-hyperconverged

2. 以下のコマンドを実行して kubevirt-hyperconverged namespace に OperatorGroup および CatalogSource を作成します。

   cat <<EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha2
   kind: OperatorGroup
   metadata:
     name: hco-operatorgroup
     namespace: kubevirt-hyperconverged
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: hco-catalogsource
     namespace: openshift-operator-lifecycle-manager
     imagePullPolicy: Always
   spec:
     sourceType: grpc
     image: registry.redhat.io/container-native-virtualization/hco-bundle-registry:v2.0.0
     displayName: KubeVirt HyperConverged
     publisher: Red Hat
   EOF

手順

1. ブラウザーウィンドウを開き、OpenShift Container Platform Web コンソールに移動します。
2. kubevirt-hyperconverged プロジェクトを Projects 一覧から選択します。
3. Catalog → Operator Management ページに移動します。
4. Operator Catalogs タブで、KubeVirt HyperConverged Cluster Operator を見つけ、Create Subscription をクリックします。
5. Create をクリックして Container-native Virtualization Operator を起動します。

手順

1. Catalog → Installed Operators ページに移動します。
2. KubeVirt HyperConverged Cluster Operator をクリックします。
3. KubeVirt HyperConverged Cluster Operator Deployment タブをクリックし、Create HyperConverged をクリックします。
4. Create をクリックして Container-native Virtualization を起動します。
5. Workloads → Pods ページに移動して、Container-native Virtualization Pod がすべて Running 状態になるまでこれらの Pod をモニターします。すべての Pod で Running 状態が表示された後に、Container-native Virtualization にアクセスできます。

手順

1. OpenShift Container Platform Web コンソールで、kubevirt-hyperconverged を Projects 一覧から選択します。
2. Catalog → Installed Operators ページに移動します。
3. KubeVirt HyperConverged Cluster Operator をクリックします。
4. KubeVirt HyperConverged Cluster Operator Deployment タブをクリックします。
5. Options メニュー kubevirt-hyperconverged カスタムリソースを含む行でクリックします。拡張されたメニューで、Delete HyperConverged をクリックします。
6. 確認ウィンドウで Delete をクリックします。
7. Workloads → Pods ページに移動し、Operator Pod のみが実行中であることを確認します。

8. ターミナルウィンドウを開き、以下のコマンドを実行して残りの KubeVirt リソースをクリーンアップします。

   $ oc delete apiservices v1alpha3.subresources.kubevirt.io -n kubevirt-hyperconverged

   注記

   現時点で、一部の KubeVirt リソースが不適切に保持される状態が確認されるため、それらを手動で削除する必要があります。これらのリソースは、(BZ1712429) の解決後に自動的に削除されます。

手順

1. OpenShift Container Platform Web コンソールで、kubevirt-hyperconverged を Projects 一覧から選択します。
2. Catalog → Operator Management ページに移動します。
3. Operator Subscriptions タブをクリックします。
4. 仮想マシンの末尾の Options メニュー hco-subscription サブスクリプションを含む行でクリックします。拡張されたメニューで、 Remove Subscription をクリックします。
5. 「Also completely remove the Operator from the selected namespace」チェックボックスが選択されていることを確認します。これが選択されていない場合、サブスクリプションが削除されると Operator Pod は Workloads → Pods に残ります。
6. Remove を再度クリックしてサブスクリプションを削除することを確定します。

手順

1. Home → Projects に移動します。
2. プロジェクトの一覧から削除するプロジェクトを見つけます。
3. プロジェクト一覧の右端にあるメニューから Delete Project を選択します。プロジェクトを削除するパーミッションがない場合は、Delete Project オプションがグレーアウトされるため、オプションをクリックすることができません。

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. Create Virtual Machine をクリックし、Create with Wizard を選択します。
3. すべての必須の Basic Settings を入力します。Template を選択すると、これらのフィールドへの入力が自動的に行われます。

4. Next をクリックして Networking 画面に進みます。デフォルトで nic0 NIC が割り当てられます。

   1. (オプション) Create NIC をクリックして追加の NIC を作成します。
   2. (オプション) ⋮ ボタンをクリックし、Remove NIC を選択して、NICS のいずれかまたはすべてを削除できます。仮想マシンの作成において、NIC が割り当てられている必要はありません。NIC は仮想マシンの作成後に作成することができます。

5. Next をクリックして Storage 画面に進みます。

   1. (オプション) Create Disk をクリックして追加のディスクを作成します。これらのディスクは、⋮ ボタンをクリックし、 Remove Disk を選択して削除できます。
   2. (オプション) ディスクをクリックして選択可能なフィールドを変更します。✓ ボタンをクリックして更新を保存します。
   3. (オプション) Attach Disk をクリックして、Select Storage ドロップダウンリストから利用可能なディスクを選択します。
6. Create Virtual Machine > をクリックします。Results 画面には、仮想マシンの JSON 設定ファイルが表示されます。

手順

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

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

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

1. 関連する PVC claimName をボリュームとして参照し、仮想マシンディスクを仮想マシンに割り当てます。

2. OpenShift Container Platform クライアントで仮想マシンを作成するには、以下のコマンドを実行します。

   $ oc create -f <vm.yaml>

3. 仮想マシンは Stopped 状態で作成されるため、これを起動して仮想マシンインスタンスを実行します。

手順

1. 正しい namespace にあることを確認します。ConfigMap は、同じ namespace にある場合に DataVolume によってのみ参照されます。

   $ oc get ns

2. ConfigMap を作成します。

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

手順

1. ブラウザーで VMware ドキュメントに移動し、ログインします。
2. VMware SDK & API Product Documentation をクリックして拡張します。
3. VMware Virtual Disk Development Kit (VDDK) をクリックします。
4. Latest Releases をクリックして、最新の VDDK リリースを選択します。
5. Download SDKs をクリックして VDDK アーカイブファイルをダウンロードします。
6. VDDK アーカイブを HTTP でアクセス可能な場所に保存します。

7. 仮想マシンをインポートする namespace に切り替えます。

   $ oc project <namespace>

8. VDDK を namespace にアップロードします。

   $ cat <<EOF | oc apply -f -
   apiVersion: cdi.kubevirt.io/v1alpha1
   kind: DataVolume
   metadata:
     name: "vddk-pvc"
   spec:
     source:
       http:
         url: "<http://www.example.com/VDDK_archive_file>" 1
     contentType: "archive"
     pvc:
       storageClassName: nfs-sc
       accessModes:
       - ReadWriteMany
       resources:
         requests:
           storage: "200Mi"
   EOF

   1

   <url> は VDDK アーカイブファイルのパスです。

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. Create Virtual Machine をクリックし、Create with Wizard を選択します。

3. Basic Settings 画面で以下の手順を実行します。

   1. Provision Source をクリックし、Import を選択します。
   2. Provider をクリックし、VMware を選択します。

   3. vCenter Instance をクリックし、Connect to New Instance または保存された vCenter インスタンスを選択します。

      • Connect to New Instance を選択する場合、以下のフィールドに値を指定し、Check and Save をクリックします。

        • vCenter Hostname
        • vCenter User Name

        • vCenter Password

          ウィザードは vCenter インスタンスに接続し、認証情報を保存します。

          Save as New vCenter Instance チェックボックスをクリアし、Check をクリックする場合、ウィザードは認証情報を保存せずに vCenter インスタンスに接続します。

      • 保存された vCenter インスタンスを選択する場合、ウィザードは保存された認証情報を使用してこれに接続します。

   4. VM to import をクリックし、仮想マシンまたはテンプレートを選択します。

      Name および Operating System には、選択された仮想マシンまたはテンプレートの属性が自動的に入力されます。

   5. デフォルトのフレーバー Custom を使用する場合、Memory (GB) および CPUs の数を指定します。

      オプションで、既存の Flavor を選択できます。

   6. Workload Profile を選択します。
   7. Next をクリックします。

4. Networking 画面で以下の手順を実行します。

   1. NETWORK CONFIGURATION をクリックし、Pod Networking を選択します。
   2. BINDING METHOD を選択します。
   3. ✓ ボタンをクリックして更新を保存します。
   4. Next をクリックします。

5. Storage 画面で以下の手順を実行します。

   1. 各ディスクをクリックし、STORAGE CLASS を選択します。ストレージクラスを選択しない場合、Container-native Virtualization はデフォルトストレージクラスを使用して仮想マシンを作成します。
   2. ✓ ボタンをクリックして更新を保存します。
   3. 複数のブート可能なディスクがある場合は、Bootable Disk を選択します。

   4. Create Virtual Machine > をクリックします。

      Result 画面に、仮想マシン用に作成されたリソースが表示されます。

6. Close をクリックします。

1. サイドメニューから Workloads → Pods をクリックします。
2. 変換 Pod kubevirt-v2v-conversion-<id> をクリックし、Pod の詳細を表示します。
3. Overview タブで、v2vConversionProgress 値の ANNOTATIONS をクリックします。

1. サイドメニューから Workloads → Pods をクリックします。
2. 変換 Pod kubevirt-v2v-conversion-<id> をクリックし、Pod の詳細を表示します。
3. Logs をクリックし、変換 Pod ログを表示します。

手順

1. インポートされた仮想マシンにログインします。
2. /etc/sysconfig/network-scripts ディレクトリーに移動します。

3. ネットワーク設定ファイルの名前を新規 NIC 名に変更します (単一 NIC は eth0 と呼ばれます)。

   $ mv original_NIC ifcfg-ethx

4. ネットワーク設定ファイルで以下のパラメーターを更新します。

   NAME=ethx
   DEVICE=ethx

5. ネットワークを再起動します。

   $ systemctl restart network

手順

1. インポートする必要のある仮想ディスクイメージをホストする HTTP ファイルサーバーを特定します。正しい形式での完全な URL が必要になります。

   • http://www.example.com/path/to/data

2. データソースに認証情報が必要な場合、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

3. 仮想マシン設定ファイルを編集し、インポートする必要のあるイメージのデータソースを指定します。この例では、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: 2Gi
           storageClassName: local
         source:
           http:
             url: https://download.fedoraproject.org/pub/fedora/linux/releases/28/Cloud/x86_64/images/Fedora-Cloud-Base-28-1.1.x86_64.qcow2 1
             secretRef: "" 2
             certConfigMap: "" 3
       status: {}
     running: false
     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: 64M
         terminationGracePeriodSeconds: 0
         volumes:
         - dataVolume:
             name: fedora-dv
           name: datavolumedisk1
   status: {}

   1

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

   2

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

   3

   certConfigMap はエンドポイントが認証を必要とする場合のみ必要になります。参照される ConfigMap は DataVolume と同じ namespace にある必要があります。

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

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

   注記

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

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

オプションの検証手順

1. oc get pods を実行し、インポーター Pod を見つけます。この Pod は指定された URL からイメージをダウンロードし、これをプロビジョニングされた PV に保存します。

2. Succeeded が表示されるまで DataVolume のステータスをモニターします。

   $ oc describe dv <data-label> 1

   1

   仮想マシン設定ファイルに指定された DataVolume のデータラベル。

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

   $ virtctl console <vm-fedora-datavolume>

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. 仮想マシンを選択します。
3. Edit をクリックして、編集可能なフィールドを選択可能にします。
4. Flavor は Custom のみに変更できます。 これにより、CPU および Memory の追加フィールドが提供されます。

5. Save をクリックします。

   値と仮想マシンは、操作の処理後に更新されます。

   仮想マシンが実行中の場合、変更内容は仮想マシンが再起動されるまで表示されません。

手順

1. サイドメニューから Workloads → Virtual Machine をクリックします。
2. 仮想マシンを選択します。
3. YAML タブをクリックして編集可能な設定を表示します。
4. オプション: Download をクリックして YAML ファイルをその現在の状態でローカルにダウンロードできます。
5. ファイルを編集し、Save をクリックします。

手順

1. 以下のコマンドを実行して、仮想マシン設定を更新します。

   oc edit

2. オブジェクト設定を開きます。
3. YAML を編集します。

4. 実行中の仮想マシンを編集する場合は、以下のいずれかを実行する必要があります。

   • 仮想マシンの再起動

   • 新規の設定を有効にするために、以下のコマンドを実行します。

     oc apply

手順

1. Container-native Virtualization コンソールのサイドメニューから Workloads → Virtual Machines をクリックします。

2. 削除する仮想マシンの ⋮ ボタンをクリックして Delete Virtual Machine を選択します。

   • または、仮想マシン名をクリックして Virtual Machine Details 画面を開き、Actions → Delete Virtual Machine をクリックします。
3. 確認のポップアップウィンドウで、Delete をクリックし、仮想マシンを永続的に削除します。

1. 以下のコマンドを実行し、仮想マシンを削除します。

   $ oc delete vm <fedora-vm>

2. 以下のコマンドを実行し、仮想マシンに関連付けられた PVC を削除します。

   $ oc delete pvc <fedora-vm-pvc>

手順

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. 仮想マシン設定ファイルの interfaces 仕様を編集します。

   kind: VirtualMachine
   spec:
     domain:
       devices:
         interfaces:
           - name: red
             masquerade: {} 1
             ports:
               - port: 80 2
     networks:
     - name: red
       pod: {}

   1

   マスカレードモードを使用した接続

   2

   ポート 80 での受信トラフィックの許可

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

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

手順

1. 任意のローカルディレクトリーで NetworkAttachmentDefinition の新規ファイルを作成します。このファイルには、お使いの設定に合わせて変更された以下の内容が含まれる必要があります。

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition
   metadata:
     name: a-bridge-network
     annotations:
       k8s.v1.cni.cncf.io/resourceName: bridge.network.kubevirt.io/br0 1
   spec:
     config: '{
       "cniVersion": "0.3.0",
       "name": "a-bridge-network", 2
       "type": "cnv-bridge", 3
       "bridge": "br0", 4
       "isGateway": true,
       "ipam": {}
   }'

   1

   このアノテーションを NetworkAttachmentDefinition に追加する場合、仮想マシンインスタンスは br0 ブリッジが接続されているノードでのみ実行されます。

   2

   name 値は、次の手順で使用するアノテーションの一部を構成します。

   3

   この NetworkAttachmentDefinition のネットワークを提供する Container Network Interface (CNI) プラグインの実際の名前。異なる CNI を使用するのでない限り、このフィールドは変更しないでください。

   4

   ブリッジの名前が br0 でない場合、ブリッジの実際の名前に置き換える必要があります。

   $ oc create -f <resource_spec.yaml>

2. ブリッジネットワークに接続する必要のある仮想マシンまたは仮想マシンインスタンスの設定を編集します。

   apiVersion: v1
   kind: VirtualMachine
   metadata:
     name: example-vm
     annotations:
       k8s.v1.cni.cncf.io/networks: a-bridge-network 1
   spec:
   ...

   1

   NetworkAttachmentDefinition の実際の name 値に置き換える必要があります。

   この例では、NetworkAttachmentDefinition および Pod が同じ namespace に置かれています。

   異なる namespace を指定するには、以下の構文を使用します。

   ...
     annotations:
       k8s.v1.cni.cncf.io/networks: <namespace>/a-bridge-network
   ...

3. 設定ファイルをリソースに適用します。

   $ oc create -f <local/path/to/network-attachment-definition.yaml>

手順

1. Container-native Virtualization コンソールの適切なプロジェクトで、Workloads → Virtual Machines をクリックします。
2. 仮想マシンテンプレートを選択します。
3. Network Interfaces をクリックし、仮想マシンにすでに割り当てられている NIC を表示します。
4. Create NIC をクリックして、新規スロットを一覧に作成します。
5. 新規 NIC の NAME、NETWORK、MAC ADDRESS、および BINDING METHOD に入力します。
6. ✓ ボタンをクリックして NIC を保存し、これを仮想マシンに割り当てます。

手順

1. コンソールのいずれか、または SSH を使用して仮想マシンのコマンドラインにアクセスします。

2. QEMU ゲストエージェントを仮想マシンにインストールします。

   $ yum install -y qemu-guest-agent

3. QEMU ゲストエージェントサービスを起動します。

   $ systemctl start qemu-guest-agent

4. サービスに永続性があることを確認します。

   $ systemctl enable qemu-guest-agent

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machinesをクリックします。
2. 仮想マシンの名前をクリックして、Virtual Machine Overview 画面を開きます。

手順

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",
                "ipam": {}
              },
              {
                "type": "cnv-tuning" 1
              }
            ]
          }'

      1

      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
     virtualmachineinstance.kubevirt.io "vmi-pxe-boot" created

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

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

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

   $ virtctl vnc vmi-pxe-boot

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

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

   $ virtctl console vmi-pxe-boot

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

   $ ip addr
   ...
   3. eth1: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
      link/ether de:00:00:00:00:de brd ff:ff:ff:ff:ff:ff

手順

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. Container-native Virtualization コンソールで Workloads → Virtual Machine Templates をクリックします。
2. Create Template をクリックし、Create with Wizard を選択します。
3. すべての必須の Basic Settings を入力します。

4. Next をクリックして Networking 画面に進みます。デフォルトで nic0 という名前の NIC が割り当てられます。

   1. オプション: Create NIC をクリックして追加の NIC を作成します。
   2. オプション: Options メニュー をクリックし、Remove NIC を選択していずれか、またはすべての NIC を削除できます。テンプレートから作成される仮想マシンには、割り当てられている NIC は不要です。NIC は仮想マシンの作成後に作成できます。

5. Next をクリックして Storage 画面に進みます。

   1. オプション: Create Disk をクリックして追加のディスクを作成します。
   2. オプション: ディスクをクリックして選択可能なフィールドを変更します。✓ ボタンをクリックして変更を保存します。

   3. オプション: Attach Disk をクリックして、Select Storage リストから利用可能なディスクを選択します。

      注記

      URL または Container のいずれかが Basic Settings 画面で Provision Source として選択されてる場合、rootdisk ディスクが作成され、Bootable Disk として仮想マシンに割り当てられます。rootdisk を変更できますが、これを削除することはできません。

      Bootable Disk は、仮想マシンにディスクが割り当てられていない場合、PXE ソースからプロビジョニングされる仮想マシンには不要です。1 つ以上のディスクが仮想マシンに割り当てられている場合、Bootable Disk を 1 つを選択する必要があります。

6. Create Virtual Machine Template > をクリックします。Results 画面には、仮想マシンテンプレートの JSON 設定ファイルが表示されます。

   テンプレートは Workloads → Virtual Machine Templates に一覧表示されます。

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machine Templates をクリックします。
2. テンプレートを選択します。
3. YAML タブをクリックして編集可能な設定を表示します。
4. ファイルを編集し、Save をクリックします。

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machine Templates をクリックします。

2. このペインから仮想マシンテンプレートを削除できます。 これにより、1 つのペインで複数のマシンに対してアクションを実行することがより容易になります。 または、Virtual Machine Template Details ペインから仮想マシンテンプレートを削除することもできます。 この場合、選択されたテンプレートの総合的な詳細情報を確認できます。

   • Options メニュー をクリックし、Delete Template を選択します。
   • テンプレート名をクリックして Virtual Machine Template Details ペインを開き、Actions → Delete Template をクリックします。
3. 確認のポップアップウィンドウで、Delete をクリックし、テンプレートを永続的に削除します。

手順

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: 500Mi 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

手順

1. 以下を特定します。

   • アップロードする VM ディスクイメージのファイルの場所
   • 結果として生成される PVC の名前およびこれに必要なサイズ

2. virtctl image-upload コマンドを実行して仮想マシンイメージをアップロードします。PVC 名、PVC サイズ、およびファイルの場所を指定する必要があります。以下は例になります。

   $ virtctl image-upload --pvc-name=upload-fedora-pvc --pvc-size=10Gi --image-path=/images/fedora28.qcow2

   注意

   HTTPS を使用したセキュアでないサーバー接続を許可するには、--insecure パラメーターを使用します。--insecure フラグを使用する際に、アップロードエンドポイントの信頼性は検証 されない 点に注意してください。

3. PVC が作成されていることを確認するには、すべての PVC オブジェクトを表示します。

   $ oc get pvc

手順

1. DataVolume 設定ファイルを編集します。

   apiVersion: cdi.kubevirt.io/v1alpha1
   kind: DataVolume
   metadata:
     name: blank-image-datavolume
   spec:
     source:
         blank: {}
     pvc:
       # Optional: Set the storage class or omit to accept the default
       # storageClassName: "hostpath"
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: 500Mi

2. 以下のコマンドを実行して、空のディスクイメージを作成します。

   $ oc create -f <blank-image-datavolume>.yaml

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machinesをクリックします。

2. この画面からマイグレーションを開始できます。 これにより、1 つの画面で複数のマシンに対してアクションを実行することがより容易になります。 または、Virtual Machine Details 画面から仮想マシンを停止することもできます。 この場合、選択された仮想マシンの総合的な詳細情報を確認できます。

   • Options メニュー をクリックし、Migrate Virtual Machine を選択します。
   • 仮想マシン名をクリックし、Virtual Machine Details 画面を開き、Actions → Migrate Virtual Machine をクリックします。
3. Migrate をクリックして、仮想マシンを別のノードに移行します。

手順

1. 移行する仮想マシンインスタンスの VirtualMachineInstanceMigration 設定ファイルを作成します。vmi-migrate.yaml はこの例になります。

   apiVersion: kubevirt.io/v1alpha3
   kind: VirtualMachineInstanceMigration
   metadata:
     name: migration-job
   spec:
     vmiName: vmi-fedora

2. クラスターにオブジェクトを作成します。

   $ oc create -f vmi-migrate.yaml

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machinesをクリックします。

2. この画面から移行を取り消すことができます。 これにより、1 つの画面で複数のマシンに対してアクションを実行することがより容易になります。 または、Virtual Machine Details 画面から仮想マシンを停止することもできます。 この場合、選択された仮想マシンの総合的な詳細情報を確認できます。

   • Options メニュー をクリックして、Cancel Virtual Machine Migrationを選択します。
   • 仮想マシン名をクリックして Virtual Machine Details 画面を開き、Actions → Cancel Virtual Machine Migration をクリックします。
3. Cancel Migration をクリックして仮想マシンのライブマイグレーションを取り消します。

手順

1. evictionStrategy: LiveMigrate オプションを、仮想マシン設定ファイルの spec セクションに追加します。この例では、oc edit を使用して VirtualMachine 設定ファイルの関連するスニペットを更新します。

   $ oc edit vm <custom-vm> -n <my-namespace>

   apiVersion: kubevirt.io/v1alpha3
   kind: VirtualMachine
   metadata:
     name: custom-vm
   spec:
     terminationGracePeriodSeconds: 30
     evictionStrategy: LiveMigrate
     domain:
       resources:
         requests:
   ...

2. 更新を有効にするために仮想マシンを再起動します。

   $ virtctl restart <custom-vm> -n <my-namespace>

手順

1. Container-native Virtualization コンソールで Compute → Nodes をクリックします。

2. この画面からノードをメンテナンスモードに設定できます。 これにより、1 つの画面で複数のノードに対してアクションを実行することがより容易になります。 または、Node Details 画面からノードをメンテナンスモードに設定することもできます。 この場合、選択されたノードの総合的な詳細情報を確認できます。

   • Options メニュー をクリックし、Start Maintenance を選択します。
   • ノード名をクリックし、Node Details 画面を開いて Actions → Stat Maintenance をクリックします。
3. 確認ウィンドウで Start Maintenance をクリックします。

手順

1. ノードメンテナンス CR 設定を作成します。この例では、node02-maintenance.yaml という CR を使用します。

   apiVersion: kubevirt.io/v1alpha1
   kind: NodeMaintenance
   metadata:
     name: node02-maintenance
   spec:
     nodeName: node02
     reason: "Replacing node02"

2. NodeMaintenance オブジェクトをクラスターに作成します。

   $ oc apply -f <node02-maintenance.yaml>

手順

1. Container-native Virtualization コンソールで Compute → Nodes をクリックします。

2. この画面からノードを再開できます。 これにより、1 つの画面で複数のノードに対してアクションを実行することがより容易になります。 または、Node Details 画面からノードを再開することもできます。 この場合、選択されたノードの総合的な詳細情報を確認できます。

   • Options メニュー をクリックし、Stop Maintenanceを選択します。
   • ノード名をクリックし、Node Details 画面を開いて Actions → Stop Maintenance をクリックします。
3. 確認ウィンドウで Stop Maintenance をクリックします。

手順

1. NodeMaintenance オブジェクトを見つけます。

   $ oc get nodemaintenance

2. オプション: NodeMaintenance オブジェクトを検査し、これが正しいノードに関連付けられていることを確認します。

   $ oc describe nodemaintenance <node02-maintenance>

   Name:         node02-maintenance
   Namespace:
   Labels:
   Annotations:
   API Version:  kubevirt.io/v1alpha1
   Kind:         NodeMaintenance
   ...
   Spec:
     Node Name:  node02
     Reason:     Replacing node02

3. NodeMaintenance オブジェクトを削除します。

   $ oc delete nodemaintenance <node02-maintenance>

手順

1. cnv-tech-preview/virtio-win コンテナーディスクを cdrom ディスクとして Windows 仮想マシン設定ファイルに追加します。コンテナーディスクは、クラスターにない場合はレジストリーからダウンロードされます。

   spec:
     domain:
       devices:
         disks:
           - name: virtiocontainerdisk
             bootOrder: 2 1
             cdrom:
               bus: sata
   volumes:
     - containerDisk:
         image: cnv-tech-preview/virtio-win
       name: virtiocontainerdisk

   1

   Container-native Virtualization は、VirtualMachine 設定ファイルに定義される順序で仮想マシンディスクを起動します。cnv-tech-preview/virtio-win コンテナーディスクの前に仮想マシンの他のディスクを定義するか、またはオプションの bootOrder パラメーターを使用して仮想マシンが正しいディスクから起動するようにできます。ディスクに bootOrder を指定する場合、これは設定のすべてのディスクに指定される必要があります。

2. ディスクは、仮想マシンが起動すると利用可能になります。

   • コンテナーディスクを実行中の仮想マシンに追加する場合、変更を有効にするために CLI で oc apply -f <vm.yaml> を使用するか、または仮想マシンを再起動します。
   • 仮想マシンが実行されていない場合、virtctl start <vm> を使用します。

手順

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. 設定ファイルを編集し、disk および volume を削除します。

   $ oc edit vm <vm-name>

   spec:
     domain:
       devices:
         disks:
           - name: virtiocontainerdisk
             bootOrder: 2
             cdrom:
               bus: sata
   volumes:
     - containerDisk:
         image: cnv-tech-preview/virtio-win
       name: virtiocontainerdisk

2. 変更を有効にするために仮想マシンを再起動します。

手順

1. cnv-tech-preview/virtio-win コンテナーディスクを cdrom ディスクとして Windows 仮想マシン設定ファイルに追加します。コンテナーディスクは、クラスターにない場合はレジストリーからダウンロードされます。

   spec:
     domain:
       devices:
         disks:
           - name: virtiocontainerdisk
             bootOrder: 2 1
             cdrom:
               bus: sata
   volumes:
     - containerDisk:
         image: cnv-tech-preview/virtio-win
       name: virtiocontainerdisk

   1

   Container-native Virtualization は、VirtualMachine 設定ファイルに定義される順序で仮想マシンディスクを起動します。cnv-tech-preview/virtio-win コンテナーディスクの前に仮想マシンの他のディスクを定義するか、またはオプションの bootOrder パラメーターを使用して仮想マシンが正しいディスクから起動するようにできます。ディスクに bootOrder を指定する場合、これは設定のすべてのディスクに指定される必要があります。

2. ディスクは、仮想マシンが起動すると利用可能になります。

   • コンテナーディスクを実行中の仮想マシンに追加する場合、変更を有効にするために CLI で oc apply -f <vm.yaml> を使用するか、または仮想マシンを再起動します。
   • 仮想マシンが実行されていない場合、virtctl start <vm> を使用します。

手順

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

手順

1. 設定ファイルを編集し、disk および volume を削除します。

   $ oc edit vm <vm-name>

   spec:
     domain:
       devices:
         disks:
           - name: virtiocontainerdisk
             bootOrder: 2
             cdrom:
               bus: sata
   volumes:
     - containerDisk:
         image: cnv-tech-preview/virtio-win
       name: virtiocontainerdisk

2. 変更を有効にするために仮想マシンを再起動します。

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machinesをクリックします。
2. 仮想マシンをクリックし、Virtual Machine Details パネルを開きます。
3. Overview タブで、POD セクションの virt-launcher-<name> Pod をクリックします。
4. Logs をクリックします。

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. 仮想マシンを選択します。
3. Events をクリックして、仮想マシンのすべてのイベントを表示します。