6.9. 仮想マシンのインポート

手順

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

   $ oc get ns

2. ConfigMap を作成します。

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

手順

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 は、自己署名証明書またはシステム CA バンドルで署名されていない証明書を使用するサーバーと通信するために必要です。参照される 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. ローカル 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. 一時ディレクトリーを作成し、これに移動します。

   $ mkdir /tmp/<dir_name> && cd /tmp/<dir_name>

2. ブラウザーで VMware code に移動し、SDKs をクリックします。
3. Compute Virtualization で Virtual Disk Development Kit(VDDK) をクリックします。
4. 最新の VDDK リリースを選択し、Download をクリックしてから VDDK アーカイブを一時ディレクトリーに保存します。

5. VDDK アーカイブを展開します。

   $ tar -xzf VMware-vix-disklib-<version>.x86_64.tar.gz

6. Dockerfile を作成します。

   $ cat > Dockerfile <<EOF
   FROM busybox:latest
   COPY vmware-vix-disklib-distrib /vmware-vix-disklib-distrib
   RUN mkdir -p /opt
   ENTRYPOINT ["cp", "-r", "/vmware-vix-disklib-distrib", "/opt"]
   EOF

7. イメージをビルドします。

   $ podman build . -t <registry_route_or_server_path>/vddk:<tag> 1

   1

   イメージレジストリーを指定します。

   • 内部 OpenShift Container Platform レジストリーの場合は、内部レジストリールート (例: image-registry.openshift-image-registry.svc:5000/openshift/vddk:<tag>) を使用します。
   • 外部レジストリーの場合は、サーバー名、パスおよびタグを指定します (例: server.example.com:5000/vddk:<tag>)。

8. イメージをレジストリーにプッシュします。

   $ podman push <registry_route_or_server_path>/vddk:<tag>

9. イメージが OpenShift Container Platform 環境からアクセスできることを確認します。

10. openshift-cnv プロジェクトで v2v-vmware ConfigMap を編集します。

    $ oc edit configmap v2v-vmware -n openshift-cnv

11. vddk-init-image パラメーターを data スタンザに追加します。

    ...
    data:
      vddk-init-image: <registry_route_or_server_path>/vddk:<tag>

手順

1. Container-native Virtualization Web コンソールで Workloads Virtual Machines をクリックします。
2. Create Virtual Machine をクリックし、Import with Wizard を選択します。

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

   1. Provider 一覧から、VMware を選択します。

   2. vCenter instance 一覧から Connect to New Instance または保存された vCenter インスタンスを選択します。

      • Connect to New Instance を選択する場合、vCenter hostname、Username、Password を入力します。
      • 保存された vCenter インスタンスを選択する場合、ウィザードは保存された認証情報を使用して vCenter に接続します。
   3. VM or Template to Import 一覧からインポートする仮想マシンまたはテンプレートを選択します。
   4. オペレーティングシステムを選択します。

   5. Flavor 一覧から既存フレーバーまたは Custom を選択します。

      Custom を選択した場合は、Memory (GB) および CPUs を指定します。

   6. Workload Profile を選択します。
   7. 仮想マシン名が namespace の別の仮想マシンで使用されている場合、名前を更新します。
   8. Next をクリックします。

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

   1. ネットワークインターフェースの Options メニュー をクリックし、Edit を選択します。

   2. 有効なネットワークインターフェース名を入力します。

      この名前には、小文字 (a-z)、数字 (0-9)、およびハイフン (-) を含めることができ、最大 253 文字を使用できます。最初と最後の文字は英数字にする必要があります。この名前には、大文字、スペース、ピリオド (.)、または特殊文字を使用できません。

   3. ネットワークインターフェースモデルを選択します。
   4. ネットワーク定義を選択します。
   5. ネットワークインターフェースの種類を選択します。
   6. MAC アドレスを入力します。
   7. Save をクリックした後に、Next をクリックします。

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

   1. ディスクの Options メニュー をクリックし、Edit を選択します。

   2. 有効な名前を入力します。

      この名前には、小文字 (a-z)、数字 (0-9)、およびハイフン (-) を含めることができ、最大 253 文字を使用できます。最初と最後の文字は英数字にする必要があります。この名前には、大文字、スペース、ピリオド (.)、または特殊文字を使用できません。

   3. インターフェースタイプを選択します。

   4. ストレージクラスを作成します。

      ストレージクラスを選択しない場合、Container-native Virtualization はデフォルトストレージクラスを使用して仮想マシンを作成します。

   5. Save をクリックした後に、Next をクリックします。
6. Advanced 画面で、cloud-init を使用している場合は Hostname および Authorized SSH Keys を入力します。
7. Next をクリックします。

8. 設定を確認し、Create Virtual Machine をクリックします。

   Successfully created virtual machine というメッセージが表示され、仮想マシンに作成されたリソースの一覧が表示されます。電源がオフになった仮想マシンが Workloads Virtual Machines に表示されます。

9. See virtual machine details をクリックして、インポートされた仮想マシンのダッシュボードを表示します。

   エラーが発生した場合は、以下の手順を実行します。

   1. Workloads Pods をクリックします。
   2. 変換 Pod (例: kubevirt-v2v-conversion-rhel7-mini-1-27b9h) をクリックします。
   3. Logs をクリックし、エラーメッセージの有無を確認します。

手順

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

3. ネットワーク設定ファイル名を ifcfg-eth0 に変更します。

   $ mv vmnic0 ifcfg-eth0 1

   1

   追加のネットワーク設定ファイルには、ifcfg-eth1、 ifcfg-eth2 などの番号が順番に付けられます。

4. ネットワーク設定ファイルで NAME および DEVICE パラメーターを更新します。

   NAME=eth0
   DEVICE=eth0

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

   $ systemctl restart network

1. Conversion Pod 名を取得します。

   $ oc get pods -n <project> | grep v2v 1
   kubevirt-v2v-conversion-f66f7d-zqkz7            1/1     Running     0          4h49m

   1

   インポートされた仮想マシンのプロジェクトを指定します。

2. Conversion Pod ログを取得します。

   $ oc logs kubevirt-v2v-conversion-f66f7d-zqkz7 -f -n <project>