Container-native Virtualization

手順

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

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machinesをクリックします。
2. 仮想マシンを選択します。
3. Consoles をクリックします。VNC コンソールがデフォルトで開きます。
4. VNC Console ドロップダウンリストをクリックし、Serial Console を選択します。

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machinesをクリックします。
2. 仮想マシンを選択します。
3. Consoles をクリックします。VNC コンソールがデフォルトで開きます。

手順

1. Container-native Virtualization コンソールで Workloads → Virtual Machinesをクリックします。
2. Windows 仮想マシンを選択します。
3. Consoles タブをクリックします。
4. Consoles 一覧をクリックし、Desktop Viewer を選択します。
5. Network Interface 一覧で、 layer-2 NIC を選択します。
6. Launch Remote Desktop をクリックし、 console.rdp ファイルをダウンロードします。

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

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

   Copy to Clipboard Toggle word wrap
8. Administrator ユーザー名およびパスワードを入力して、Windows 仮想マシンに接続します。

手順

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

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

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

   $ oc get svc
   NAME            TYPE       CLUSTER-IP     EXTERNAL-IP   PORT(S)           AGE
   fedora-vm-ssh   NodePort   127.0.0.1      <none>        20022:32551/TCP   6s

   Copy to Clipboard Toggle word wrap

   この例では、サービスは 32551 ポートを取得しています。

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

   $ ssh username@<node_IP_address> -p 32551

   Copy to Clipboard Toggle word wrap

手順

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

   $ virtctl vnc <VMI>

   Copy to Clipboard Toggle word wrap

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

   $ virtctl vnc <VMI> -v 4

   Copy to Clipboard Toggle word wrap

手順

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc describe vmi <windows-vmi-name>

   Copy to Clipboard Toggle word wrap

   ...
   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
   ...

   Copy to Clipboard Toggle word wrap
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:

   Copy to Clipboard Toggle word wrap
   注記

   このスニペットには 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

   Copy to Clipboard Toggle word wrap

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

     kubevirt_vm:
       namespace: default
       name: vm1
       state: running 

   1

   
       cpu_cores: 1

   Copy to Clipboard Toggle word wrap

   1

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

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

   $ ansible-playbook create-vm.yaml

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   $ ansible-playbook create-vm.yaml

   Copy to Clipboard Toggle word wrap

手順

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

      1

      
              }
            ]
          }'

      Copy to Clipboard Toggle word wrap

      1

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

      注記

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

2. 直前の手順で作成したファイルを使用して NetworkAttachmentDefinition オブジェクトを作成します。

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

   Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap
      注記

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

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

   $ oc create -f vmi-pxe-boot.yaml
     virtualmachineinstance.kubevirt.io "vmi-pxe-boot" created

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   $ virtctl vnc vmi-pxe-boot

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

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

   $ virtctl console vmi-pxe-boot

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap
   注記

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

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

   $ oc create -f <file name>.yaml

   Copy to Clipboard Toggle word wrap

手順

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

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

   Copy to Clipboard Toggle word wrap
   注記

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

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

   $ oc create -f <file name>.yaml

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap

2. ConfigMap を作成します。

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

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

   $ oc apply -f endpoint-secret.yaml

   Copy to Clipboard Toggle word wrap

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: {}

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

   3

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

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

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

   Copy to Clipboard Toggle word wrap
   注記

   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

   Copy to Clipboard Toggle word wrap

   1

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

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

   $ virtctl console <vm-fedora-datavolume>

   Copy to Clipboard Toggle word wrap

手順

1. ローカル PV を作成するノードに root としてログインします。この手順では、node01 を例に使用します。

2. ファイルを作成して、これを null 文字で設定し、ブロックデバイスとして使用できるようにします。以下の例では、2Gb (20 100Mb ブロック) のサイズのファイル loop10 を作成します。

   $ dd if=/dev/zero of=<loop10> bs=100M count=20

   Copy to Clipboard Toggle word wrap

3. loop10 ファイルをループデバイスとしてマウントします。

   $ losetup </dev/loop10>d3 <loop10> 

   1

   2

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   1

   ノード上のループデバイスのパス。

   2

   ブロック PV であることを指定します。

   3

   オプション: PV に StorageClass を設定します。これを省略する場合、クラスターのデフォルトが使用されます。

   4

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

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

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