Container-native Virtualization ユーザーガイド

手順

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

手順

1. サイドメニューから Workloads → Virtual Machine をクリックします。
2. 仮想マシンを選択します。

3. YAML タブをクリックして編集可能な設定を表示します。

   1. (オプション) Download をクリックして YAML ファイルをその現在の状態でローカルにダウンロードできます。
4. ファイルを編集し、Save をクリックします。

手順

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

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。

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

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

手順

1. サイドメニューから Workloads → Virtual Machine をクリックします。

2. 仮想マシンの ⋮ ボタンをクリックし、Start Virtual Machine を選択します。

   1. または、仮想マシン名をクリックして Virtual Machine Details 画面を開き、Actions をクリックして Start Virtual Machine を選択します。
3. 確認のポップアップウィンドウで、Start をクリックし、仮想マシンを起動します。

手順

1. サイドメニューから Workloads → Virtual Machine をクリックします。

2. 仮想マシンの ⋮ ボタンをクリックし、Stop Virtual Machine を選択します。

   1. または、仮想マシン名をクリックして Virtual Machine Details 画面を開き、Actions クリックして Stop Virtual Machine を選択します。
3. 確認のポップアップウィンドウで、Stop をクリックし、仮想マシンを停止します。

手順

1. サイドメニューから Workloads → Virtual Machine をクリックします。

2. 仮想マシンの ⋮ ボタンをクリックし、Restart Virtual Machine を選択します。

   1. または、仮想マシン名をクリックして Virtual Machine Details 画面を開き、Actions クリックして Restart Virtual Machine を選択します。
3. 確認のポップアップウィンドウで、Restart をクリックし、仮想マシンを再起動します。

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. 仮想マシンを選択します。
3. Consoles をクリックします。VNC コンソールがデフォルトで開きます。

手順

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

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. 仮想マシンテンプレートを選択します。
3. Network Interfaces をクリックし、仮想マシンにすでに割り当てられている NIC を表示します。
4. Create NIC をクリックして、新規スロットを一覧に作成します。
5. 新規 NIC の NAME、NETWORK、および MAC ADDRESS の詳細を入力します。
6. ✓ ボタンをクリックして NIC を保存し、これを仮想マシンに割り当てます。

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. 仮想マシンを選択します。
3. Network Interfaces をクリックし、仮想マシンにすでに割り当てられている NIC を表示します。
4. 削除する NIC の ⋮ ボタンをクリックし、Delete を選択します。
5. 確認のポップアップウィンドウで、Delete をクリックして NIC の割り当てを解除し、これを削除します。

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. 仮想マシンを選択します。
3. Disks をクリックして、仮想マシンにすでに割り当てられているディスクを表示します。
4. Create Disk をクリックして、新規スロットを一覧に作成します。
5. 新規ディスクの NAME、SIZE、およびオプションの STORAGE CLASS の詳細を入力します。
6. ✓ ボタンをクリックしてディスクを保存し、これを仮想マシンに割り当てます。

手順

1. サイドメニューから Workloads → Virtual Machines をクリックします。
2. 仮想マシンを選択します。
3. Disks をクリックして、仮想マシンにすでに割り当てられているディスクを表示します。
4. 削除するディスクの ⋮ ボタンをクリックし、Delete を選択します。
5. Confirm をクリックし、ディスクの割り当てを解除し、これを削除します。

手順

1. サイドメニューから Workloads → Virtual Machine Templates をクリックします。
2. Create Template をクリックし、Create with Wizard を選択します。
3. すべての必須の Basic Settings を入力します。

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 Template > をクリックします。Results 画面には、仮想マシンテンプレートの JSON 設定ファイルが表示されます。

手順

1. サイドメニューから Workloads → Virtual Machine Template をクリックします。
2. テンプレートを選択します。

3. YAML タブをクリックして編集可能な設定を表示します。

   1. (オプション) Download をクリックして YAML ファイルをその現在の状態でローカルにダウンロードできます。
4. ファイルを編集し、Save をクリックします。

手順

1. サイドメニューから Workloads → Virtual Machine Templates をクリックします。

2. 削除するテンプレートの ⋮ ボタンをクリックし、Delete Template を選択します。

   1. または、テンプレート名をクリックして Virtual Machine Template Details 画面を開き、Actions → Delete Template をクリックします。
3. 確認のポップアップウィンドウで、Delete をクリックし、テンプレートを永続的に削除します。

手順

1. QEMU ゲストエージェントを仮想マシンにインストールすること。

   $ yum install -y qemu-guest-agent

   Copy to Clipboard Toggle word wrap

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

   $ systemctl start qemu-guest-agent

   Copy to Clipboard Toggle word wrap

3. VMI の IP アドレス情報を表示します。

   $ oc describe vmi <vmi_name>
   
   ...
   Interfaces:
      Interface Name:  eth0
      Ip Address:      10.244.0.37/24
      Ip Addresses:
        10.244.0.37/24
        fe80::858:aff:fef4:25/64
      Mac:             0a:58:0a:f4:00:25
      Name:            default
      Interface Name:  v2
      Ip Address:      1.1.1.7/24
      Ip Addresses:
        1.1.1.7/24
        fe80::f4d9:70ff:fe13:9089/64
      Mac:             f6:d9:70:13:90:89
      Interface Name:  v1
      Ip Address:      1.1.1.1/24
      Ip Addresses:
        1.1.1.1/24
        1.1.1.2/24
        1.1.1.4/24
        2001:de7:0:f101::1/64
        2001:db8:0:f101::1/64
        fe80::1420:84ff:fe10:17aa/64
      Mac:             16:20:84:10:17:aa

   Copy to Clipboard Toggle word wrap
   注記

   IP アドレス情報は、仮想マシン上で ip addr を実行するか、または oc get vmi -o yaml を実行して表示できます。

手順

1. 仮想マシン設定ファイルの interfaces 仕様を編集します。

   kind: VM
   spec:
     domain:
       devices:
         interfaces:
           - name: red
             masquerade: {} 

   1

   
             ports:
               - port: 80 

   2

   
     networks:
     - name: red
       pod: {}

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

手順

1. 以下を特定します。

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

2. 既存の passthrough ルートを削除します。

   $ oc delete route -n cdi cdi-uploadproxy-route

   Copy to Clipboard Toggle word wrap

3. re-encryption termination を使用してセキュリティー保護されたルートを作成します。

   $ oc get secret -n cdi cdi-upload-proxy-ca-key -o=jsonpath="{.data['tls\.crt']}" | base64 -d > ca.pem
   
   $ oc create route reencrypt cdi-uploadproxy-route -n cdi --service=cdi-uploadproxy --dest-ca-cert=ca.pem

   Copy to Clipboard Toggle word wrap

4. virtctl image-upload コマンドを使用して VM イメージをアップロードし、選択したパラメーターが含まれていることを確認します。以下に例を示します。

   $ virtctl image-upload --uploadproxy-url=https://$(oc get route cdi-uploadproxy-route -n cdi -o=jsonpath='{.status.ingress[0].host}') --pvc-name=upload-fedora-pvc --pvc-size=10Gi --image-path=/images/fedora28.qcow2

   Copy to Clipboard Toggle word wrap
   Important

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

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

   $ oc get pvc

   Copy to Clipboard Toggle word wrap

手順

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

   • http://www.example.com/path/to/data
   • s3://bucketName/fileName

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

   apiVersion: v1
   kind: Secret
   metadata:
     name: <endpoint-secret>
     labels:
       app: containerized-data-importer
   type: Opaque
   data:
     accessKeyId: ""  # <optional: your key or user name, base64 encoded>
     secretKey:    "" # <optional: your secret or password, base64 encoded>

   Copy to Clipboard Toggle word wrap

   $ oc apply -f endpoint-secret.yaml

   Copy to Clipboard Toggle word wrap

3. VM 設定ファイル (オプションで secretRef パラメーターが含まれる) を編集します。以下のサンプルでは、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
             secretRef: "" # Optional
       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

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

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

   Copy to Clipboard Toggle word wrap

   仮想マシンおよび 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

   VirtualMachine 設定ファイルで指定された DataVolume のデータラベル。

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

   $ virtctl console <vm-fedora-datavolume>

   Copy to Clipboard Toggle word wrap

手順

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

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

   • s3://bucketName/fileName

     この URL を、PVC 設定ファイルの cdi.kubevirt.io/storage.import.endpoint アノテーションの値として使用します。

     例: cdi.kubevirt.io/storage.import.endpoint: https://download.fedoraproject.org/pub/fedora/linux/releases/28/Cloud/x86_64/images/Fedora-Cloud-Base-28-1.1.x86_64.qcow2

2. ファイルサーバーに認証情報が必要な場合、endpoint-secret.yaml ファイルを編集します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: endpoint-secret
     labels:
       app: containerized-data-importer
   type: Opaque
   data:
     accessKeyId: ""  # <optional: your key or user name, base64 encoded>
     secretKey:    "" # <optional: your secret or password, base64 encoded>

   Copy to Clipboard Toggle word wrap

   1. PVC 設定ファイルの cdi.kubevirt.io/storage.import.secret アノテーションで使用する metadata.name の値を保存します。

      例: cdi.kubevirt.io/storage.import.secret: endpoint-secret

3. endpoint-secret.yaml をクラスターに適用します。

   $ oc apply -f endpoint-secret.yaml

   Copy to Clipboard Toggle word wrap

4. PVC 設定ファイルを編集し、必要なアノテーションが組み込まれていることを確認します。

   以下に例を示します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: "example-vmdisk-volume"
     labels:
      app: containerized-data-importer
     annotations:
       cdi.kubevirt.io/storage.import.endpoint: "https://download.fedoraproject.org/pub/fedora/linux/releases/28/Cloud/x86_64/images/Fedora-Cloud-Base-28-1.1.x86_64.qcow2" 

   1

   
       cdi.kubevirt.io/storage.import.secret: "endpoint-secret" 

   2

   
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 5Gi

   Copy to Clipboard Toggle word wrap

   1

   インポートイメージ URL のエンドポイントアノテーション

   2

   認可シークレットのエンドポイントアノテーション

5. oc CLI を使用して PVC を作成します。

   $ oc create -f <pvc.yaml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   PersistentVolumeClaim ファイル名。

   ディスクイメージが PV に正常にインポートされた後に、インポーター Pod の有効期限は切れ、PVC を OpenShift Container Platform 内の仮想マシンオブジェクトにバインドできます。

手順

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

2. VirtualMachine オブジェクトの YAML ファイルを作成します。以下の仮想マシンのサンプル <vm-dv-clone> は <my-favorite-vm-disk> (<source-namespace> namespace にある) のクローンを作成し、仮想マシンで <favorite-clone> ボリュームとして参照される、2Gi <favorite-clone> DataVolume を作成します。

   以下に例を示します。

   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"

   Copy to Clipboard Toggle word wrap

   1

   作成する仮想マシン。

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

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

   Copy to Clipboard Toggle word wrap

手順

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

2. 以下のパラメーターを指定する DataVolume オブジェクトの YAML ファイルを作成します。

   metadata: name	新規 DataVolume の名前。
   source: pvc: namespace	ソース PVC が存在する namespace。
   source: pvc: name	ソース PVC の名前。
   storage	新規 DataVolume のサイズ。十分な領域が割り当てられていることを確認します。そうでない場合には、クローン操作は失敗します。 サイズはソース PVC と同じか、またはそれよりも大きくなければなりません。 以下に例を示します。 apiVersion: cdi.kubevirt.io/v1alpha1 kind: DataVolume metadata: name: cloner-datavolume spec: source: pvc: namespace: "<source-namespace>" name: "<my-favorite-vm-disk>" pvc: accessModes: - ReadWriteOnce resources: requests: storage: 2Gi Copy to Clipboard Toggle word wrap

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

   $ oc create -f <datavolume>.yaml

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap

2. 空のディスクイメージを作成するために DataVolume マニフェストをデプロイします。

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

   Copy to Clipboard Toggle word wrap

手順

1. PVC マニフェストファイルを作成します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: "blank-image-pvc"
     labels:
       app: containerized-data-importer
     annotations:
       cdi.kubevirt.io/storage.import.source: "none"
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 4Gi
     # Optional: Set the storage class or omit to accept the default
     # storageClassName: local

   Copy to Clipboard Toggle word wrap

2. 空のディスクイメージを作成するために PVC マニフェストをデプロイします。

   $ oc create -f blank-image-pvc.yaml

   Copy to Clipboard Toggle word wrap

手順

1. virtctl を使ってシリアルコンソールに接続します。

   $ virtctl console <VMI>

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

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

   Copy to Clipboard Toggle word wrap

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

3. ノードの ipAddress および手順 2 で見つけたポートを使用して、SSH 経由で仮想マシンインスタンスにログインします。

   $ ssh username@<node IP> -p 32551

   Copy to Clipboard Toggle word wrap