6.8. 仮想マシンのエクスポート

手順

1. 次の例に従って VirtualMachineExport マニフェストを作成し、VirtualMachine、VirtualMachineSnapshot、または PersistentVolumeClaim CR からボリュームをエクスポートし、example-export.yaml として保存します。

   VirtualMachineExport の例

   apiVersion: export.kubevirt.io/v1beta1
   kind: VirtualMachineExport
   metadata:
     name: example-export
   spec:
     source:
       apiGroup: "kubevirt.io" 1
       kind: VirtualMachine 2
       name: example-vm
     ttlDuration: 1h 3

   1

   適切な API グループを指定します。

   • VirtualMachine の "kubevirt.io"。
   • VirtualMachineSnapshot の "snapshot.kubevirt.io"。
   • PersistentVolumeClaim の ""。

   2

   VirtualMachine、VirtualMachineSnapshot、または PersistentVolumeClaim を指定します。

   3

   オプション: デフォルトの期間は 2 時間です。

2. VirtualMachineExport CR を作成します。

   $ oc create -f example-export.yaml

3. VirtualMachineExport CR を取得します。

   $ oc get vmexport example-export -o yaml

   エクスポートされたボリュームの内部および外部リンクは、status スタンザに表示されます。

   出力例

   apiVersion: export.kubevirt.io/v1beta1
   kind: VirtualMachineExport
   metadata:
     name: example-export
     namespace: example
   spec:
     source:
       apiGroup: ""
       kind: PersistentVolumeClaim
       name: example-pvc
     tokenSecretRef: example-token
   status:
     conditions:
     - lastProbeTime: null
       lastTransitionTime: "2022-06-21T14:10:09Z"
       reason: podReady
       status: "True"
       type: Ready
     - lastProbeTime: null
       lastTransitionTime: "2022-06-21T14:09:02Z"
       reason: pvcBound
       status: "True"
       type: PVCReady
     links:
       external: 1
         cert: |-
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         volumes:
         - formats:
           - format: raw
             url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1beta1/namespaces/example/virtualmachineexports/example-export/volumes/example-disk/disk.img
           - format: gzip
             url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1beta1/namespaces/example/virtualmachineexports/example-export/volumes/example-disk/disk.img.gz
           name: example-disk
       internal:  2
         cert: |-
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         volumes:
         - formats:
           - format: raw
             url: https://virt-export-example-export.example.svc/volumes/example-disk/disk.img
           - format: gzip
             url: https://virt-export-example-export.example.svc/volumes/example-disk/disk.img.gz
           name: example-disk
     phase: Ready
     serviceName: virt-export-example-export

   1

   外部リンクは、Ingress または Route を使用してクラスターの外部からアクセスできます。

   2

   内部リンクは、クラスター内でのみ有効です。

手順

1. マニフェストにアクセスするには、まず証明書をソースクラスターからターゲットクラスターにコピーする必要があります。

   1. ソースクラスターにログインします。

   2. 次のコマンドを実行して、証明書を cacert.crt ファイルに保存します。

      $ oc get vmexport <export_name> -o jsonpath={.status.links.external.cert} > cacert.crt 1

      1

      <export_name> を、VirtualMachineExport オブジェクトの metadata.name 値に置き換えます。

   3. cacert.crt ファイルをターゲットクラスターにコピーします。

2. 次のコマンドを実行して、ソースクラスター内のトークンをデコードし、token_decode ファイルに保存します。

   $ oc get secret export-token-<export_name> -o jsonpath={.data.token} | base64 --decode > token_decode 1

   1

   <export_name> を、VirtualMachineExport オブジェクトの metadata.name 値に置き換えます。

3. token_decode ファイルをターゲットクラスターにコピーします。

4. 次のコマンドを実行して、VirtualMachineExport カスタムリソースを取得します。

   $ oc get vmexport <export_name> -o yaml

5. status.links スタンザを確認します。このスタンザは external セクションと internal セクションに分かれています。各セクション内の manifests.url フィールドに注意してください。

   出力例

   apiVersion: export.kubevirt.io/v1beta1
   kind: VirtualMachineExport
   metadata:
     name: example-export
   spec:
     source:
       apiGroup: "kubevirt.io"
       kind: VirtualMachine
       name: example-vm
     tokenSecretRef: example-token
   status:
   #...
     links:
       external:
   #...
         manifests:
         - type: all
           url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1beta1/namespaces/example/virtualmachineexports/example-export/external/manifests/all 1
         - type: auth-header-secret
           url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1beta1/namespaces/example/virtualmachineexports/example-export/external/manifests/secret 2
       internal:
   #...
         manifests:
         - type: all
           url: https://virt-export-export-pvc.default.svc/internal/manifests/all 3
         - type: auth-header-secret
           url: https://virt-export-export-pvc.default.svc/internal/manifests/secret
     phase: Ready
     serviceName: virt-export-example-export

   1

   VirtualMachine マニフェスト、存在する場合は DataVolume マニフェスト、外部 URL の Ingress またはルートの公開証明書を含む ConfigMap マニフェストが含まれます。

   2

   Containerized Data Importer (CDI) と互換性のあるヘッダーを含むシークレットが含まれます。ヘッダーには、エクスポートトークンのテキストバージョンが含まれています。

   3

   VirtualMachine マニフェスト、存在する場合は DataVolume マニフェスト、および内部 URL のエクスポートサーバーの証明書を含む ConfigMap マニフェストが含まれます。

6. ターゲットクラスターにログインします。

7. 次のコマンドを実行して Secret マニフェストを取得します。

   $ curl --cacert cacert.crt <secret_manifest_url> -H \ 1
   "x-kubevirt-export-token:token_decode" -H \ 2
   "Accept:application/yaml"

   1

   <secret_manifest_url> を、VirtualMachineExport YAML 出力の auth-header-secret URL に置き換えます。

   2

   前に作成した token_decode ファイルを参照します。

   以下に例を示します。

   $ curl --cacert cacert.crt https://vmexport-proxy.test.net/api/export.kubevirt.io/v1beta1/namespaces/example/virtualmachineexports/example-export/external/manifests/secret -H "x-kubevirt-export-token:token_decode" -H "Accept:application/yaml"

8. 次のコマンドを実行して、ConfigMap マニフェストや VirtualMachine マニフェストなどの type: all マニフェストを取得します。

   $ curl --cacert cacert.crt <all_manifest_url> -H \ 1
   "x-kubevirt-export-token:token_decode" -H \ 2
   "Accept:application/yaml"

   1

   <all_manifest_url> を、VirtualMachineExport YAML 出力の URL に置き換えます。

   2

   前に作成した token_decode ファイルを参照します。

   以下に例を示します。

   $ curl --cacert cacert.crt https://vmexport-proxy.test.net/api/export.kubevirt.io/v1beta1/namespaces/example/virtualmachineexports/example-export/external/manifests/all -H "x-kubevirt-export-token:token_decode" -H "Accept:application/yaml"