Migration Toolkit for Virtualization のインストールおよび使用

手順

1. 一時ディレクトリーを作成し、これに移動します。

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

   Copy to clipboard
2. ブラウザーで、VMware VDDK バージョン 8 ダウンロードページ に移動します。
3. バージョン 8.0.1 を選択し、Download をクリックします。

1. VDDK アーカイブファイルを一時ディレクトリーに保存します。

2. VDDK アーカイブをデプロイメントします。

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

   Copy to clipboard

3. Dockerfile を作成します。

   $ cat > Dockerfile <<EOF
   FROM registry.access.redhat.com/ubi8/ubi-minimal
   USER 1001
   COPY vmware-vix-disklib-distrib /vmware-vix-disklib-distrib
   RUN mkdir -p /opt
   ENTRYPOINT ["cp", "-r", "/vmware-vix-disklib-distrib", "/opt"]
   EOF

   Copy to clipboard

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

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

   Copy to clipboard

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

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

   Copy to clipboard
6. イメージが OpenShift Virtualization 環境からアクセスできることを確認します。

手順

1. root として ESXi ホストにログインします。

2. /etc/vmware/hostd/config.xml で maxMemory の値を 1000000000 に変更します。

   ...
         <nfcsvc>
            <path>libnfcsvc.so</path>
            <enabled>true</enabled>
            <maxMemory>1000000000</maxMemory>
            <maxStreamMemory>10485760</maxStreamMemory>
         </nfcsvc>
   ...

   Copy to clipboard

3. hostd を再起動します。

   # /etc/init.d/hostd restart

   Copy to clipboard

   ホストを再起動する必要はありません。

手順

1. Red Hat OpenShift Web コンソールで、Plans for virtualization、Create Plan の順にクリックします。

   Create migration plan ウィザードが開き、Select source provider インターフェイスが表示されます。

2. 移行する仮想マシンの移行元プロバイダーを選択します。

   Select virtual machines インターフェイスが開きます。

3. 移行する仮想マシンを選択し、Next をクリックします。

   Create migration plan ペインが開きます。移行元プロバイダーの名前と、移行先プロバイダーと namespace、ネットワークマップ、ストレージマップに関する提案が表示されます。

4. Plan name を入力します。
5. 編集可能な項目に必要な変更を加えます。
6. 提案されたネットワークマッピングまたはストレージマッピングを編集し、1 つ以上の追加マッピングを追加するには、Add mapping をクリックします。

7. Create migration plan をクリックします。

   MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。

8. VMware 移行元プロバイダーの場合のみ (すべて任意):

   • Preserving static IPs of VMs: デフォルトでは、仮想ネットワークインターフェイスコントローラー (vNIC) が移行プロセス中に変更されます。その結果、vSphere で静的 IP が設定されている vNIC の IP が失われます。仮想マシンの静的 IP を保持してこれを回避するには、Preserve static IPs の横にある Edit アイコンをクリックし、開いたウィンドウで Whether to preserve the static IPs スイッチを切り替えます。次に、Save をクリックします。

     その後、MTV が、vNIC プロパティーが欠落している Windows オペレーティングシステムを持つ仮想マシンに関する警告メッセージを発行します。不足している vNIC プロパティーを取得するには、vSphere で該当する仮想マシンを実行して、vNIC プロパティーが MTV に報告されるようにします。

   • Entering a list of decryption passphrases for disks encrypted using Linux Unified Key Setup (LUKS): LUKS で暗号化されたデバイスの復号化パスフレーズのリストを入力するには、Settings セクションで、Disk decryption passphrases の横にある編集アイコンをクリックし、パスフレーズを入力して、Save をクリックします。パスフレーズを特定の順序で入力する必要はありません。MTV は、LUKS で暗号化された各デバイスに対して、デバイスのロックが解除されるまで各パスフレーズを試します。

   • Specifying a root device: マルチブート仮想マシンの移行にのみ適用されます。デフォルトでは、MTV はルートデバイスとして検出された最初の起動可能なデバイスを使用します。

     別のルートデバイスを指定するには、Settings セクションで、Root device の横にある編集アイコンをクリックし、よく使用されるオプションのリストからデバイスを選択するか、テキストボックスにデバイスを入力します。

     MTV はディスクの場所に /dev/sd<disk_identifier><disk_partition> という形式を使用します。たとえば、2 番目のディスクがルートデバイスであり、オペレーティングシステムがディスクの 2 番目のパーティションにある場合、形式は /dev/sdb2 になります。起動デバイスを入力したら、Save をクリックします。

     指定した起動デバイスが正しくないために変換が失敗した場合は、変換 Pod のログを確認することで正確な情報を取得できます。

9. RHV 移行元プロバイダーの場合のみ (任意):

   • Preserving the CPU model of VMs that are migrated from RHV: 通常、RHV 仮想マシンの CPU モデル (タイプ) はクラスターレベルで設定されますが、仮想マシンレベルで設定することもできます。これはカスタム CPU モデルと呼ばれます。デフォルトでは、MTV は移行先クラスターの CPU モデルを設定する際に、カスタム CPU 設定を持つ仮想マシンにはカスタム CPU 設定を保持します。一方、カスタム CPU 設定を持たない仮想マシンには CPU モデルを設定しません。代わりに、CPU モデルは OpenShift Virtualization によって後で設定されます。

     RHV 仮想マシンのクラスターレベルの CPU モデルを保持するには、Settings セクションで、Preserve CPU model の横にある Edit アイコンをクリックします。Whether to preserve the CPU model スイッチを切り替えて、Save をクリックします。

10. 計画が有効な場合は、以下を行います。

    1. 今すぐ Start migration をクリックしてプランを実行できます。
    2. 後で Plans for virtualization ページで計画を選択し、移行計画の実行 の手順に従うことで、計画を実行できます。

手順

1. Red Hat OpenShift Web コンソールで Providers for virtualization をクリックします。

2. 適切な移行元プロバイダーの行で、VMs をクリックします。

   Virtual Machines タブが開きます。

3. 移行する仮想マシンを選択し、Create migration plan をクリックします。

   Create migration plan ペインが開きます。移行元プロバイダーの名前と、移行先プロバイダーと namespace、ネットワークマップ、ストレージマップに関する提案が表示されます。

4. Plan name を入力します。
5. 編集可能な項目に必要な変更を加えます。
6. 提案されたネットワークマッピングまたはストレージマッピングを編集し、1 つ以上の追加マッピングを追加するには、Add mapping をクリックします。

7. Create migration plan をクリックします。

   MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。

8. VMware 移行元プロバイダーの場合のみ (すべて任意):

   • Preserving static IPs of VMs: デフォルトでは、仮想ネットワークインターフェイスコントローラー (vNIC) が移行プロセス中に変更されます。その結果、vSphere で静的 IP が設定されている vNIC の IP が失われます。仮想マシンの静的 IP を保持してこれを回避するには、Preserve static IPs の横にある Edit アイコンをクリックし、開いたウィンドウで Whether to preserve the static IPs スイッチを切り替えます。次に、Save をクリックします。

     その後、MTV が、vNIC プロパティーが欠落している Windows オペレーティングシステムを持つ仮想マシンに関する警告メッセージを発行します。不足している vNIC プロパティーを取得するには、vSphere で該当する仮想マシンを実行して、vNIC プロパティーが MTV に報告されるようにします。

   • Entering a list of decryption passphrases for disks encrypted using Linux Unified Key Setup (LUKS): LUKS で暗号化されたデバイスの復号化パスフレーズのリストを入力するには、Settings セクションで、Disk decryption passphrases の横にある編集アイコンをクリックし、パスフレーズを入力して、Save をクリックします。パスフレーズを特定の順序で入力する必要はありません。MTV は、LUKS で暗号化された各デバイスに対して、デバイスのロックが解除されるまで各パスフレーズを試します。

   • Specifying a root device: マルチブート仮想マシンの移行にのみ適用されます。デフォルトでは、MTV はルートデバイスとして検出された最初の起動可能なデバイスを使用します。

     別のルートデバイスを指定するには、Settings セクションで、Root device の横にある編集アイコンをクリックし、よく使用されるオプションのリストからデバイスを選択するか、テキストボックスにデバイスを入力します。

     MTV はディスクの場所に /dev/sd<disk_identifier><disk_partition> という形式を使用します。たとえば、2 番目のディスクがルートデバイスであり、オペレーティングシステムがディスクの 2 番目のパーティションにある場合、形式は /dev/sdb2 になります。起動デバイスを入力したら、Save をクリックします。

     指定した起動デバイスが正しくないために変換が失敗した場合は、変換 Pod のログを確認することで正確な情報を取得できます。

9. RHV 移行元プロバイダーの場合のみ (任意):

   • Preserving the CPU model of VMs that are migrated from RHV: 通常、RHV 仮想マシンの CPU モデル (タイプ) はクラスターレベルで設定されますが、仮想マシンレベルで設定することもできます。これはカスタム CPU モデルと呼ばれます。デフォルトでは、MTV は移行先クラスターの CPU モデルを設定する際に、カスタム CPU 設定を持つ仮想マシンにはカスタム CPU 設定を保持します。一方、カスタム CPU 設定を持たない仮想マシンには CPU モデルを設定しません。代わりに、CPU モデルは OpenShift Virtualization によって後で設定されます。

     RHV 仮想マシンのクラスターレベルの CPU モデルを保持するには、Settings セクションで、Preserve CPU model の横にある Edit アイコンをクリックします。Whether to preserve the CPU model スイッチを切り替えて、Save をクリックします。

10. 計画が有効な場合は、以下を行います。

    1. 今すぐ Start migration をクリックしてプランを実行できます。
    2. 後で Plans for virtualization ページで計画を選択し、移行計画の実行 の手順に従うことで、計画を実行できます。

手順

1. 移行元プロバイダーの認証情報の Secret マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: <namespace>
     ownerReferences: 1
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: vsphere
       createdForResourceType: providers
   type: Opaque
   stringData:
     user: <user> 2
     password: <password> 3
     insecureSkipVerify: <"true"/"false"> 4
     cacert: | 5
       <ca_certificate>
     url: <api_end_point> 6
   EOF

   Copy to clipboard

   1

   ownerReferences セクションはオプションです。

   2

   vCenter ユーザーまたは ESX/ESXi ユーザーを指定します。

   3

   vCenter ユーザーまたは ESX/ESXi ユーザーのパスワードを指定します。

   4

   "true" を指定して証明書の検証を省略し、"false" を指定して証明書を検証します。指定されていない場合はデフォルトで "false" になります。証明書の検証をスキップすると、安全でない移行が続行され、証明書は不要になります。セキュアではない移行とは、転送されたデータがセキュアではない接続を介して送信され、機密性の高いデータが公開される可能性があることを意味します。

   5

   このフィールドが設定されておらず、skip certificate verification が無効になっている場合、MTV はシステム CA の使用を試みます。

   6

   vCenter または ESX/ESXi の API エンドポイント URL を指定します (例: https://<vCenter_host>/sdk)。

2. 移行元プロバイダーの Provider マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: vsphere
     url: <api_end_point> 1
     settings:
       vddkInitImage: <VDDK_image> 2
       sdkEndpoint: vcenter 3
     secret:
       name: <secret> 4
       namespace: <namespace>
   EOF

   Copy to clipboard

   1

   API エンドポイントの URL を指定します (例: https://<vCenter_host>/sdk)。

   2

   オプションですが、移行を高速化するために VDDK イメージを作成することを強く推奨します。OpenShift のドキュメントに従って、作成した VDDK イメージを指定します。

   3

   オプション: vcenter または esxi。

   4

   プロバイダーの Secret CR の名前を指定します。

3. Host マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Host
   metadata:
     name: <vmware_host>
     namespace: <namespace>
   spec:
     provider:
       namespace: <namespace>
       name: <source_provider> 1
     id: <source_host_mor> 2
     ipAddress: <source_network_ip> 3
   EOF

   Copy to clipboard

   1

   VMware vSphere Provider CR の名前を指定します。

   2

   VMware vSphere ホストの Managed Object Reference (moRef) を指定します。moRef を取得するには、VMware vSphere moRef の取得 を参照してください。

   3

   VMware vSphere 移行ネットワークの IP アドレスを指定します。

4. 移行元ネットワークと移行先ネットワークをマッピングする NetworkMap マニフェストを作成します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           name: <network_name>
           type: pod 1
         source: 2
           id: <source_network_id>
           name: <source_network_name>
       - destination:
           name: <network_attachment_definition> 3
           namespace: <network_attachment_definition_namespace> 4
           type: multus
         source:
           id: <source_network_id>
           name: <source_network_name>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は Pod および multus です。

   2

   id パラメーター または name パラメーターのいずれかを使用して、ソースネットワークを指定できます。id には、VMware vSphere ネットワーク Managed Object Reference (moRef) を指定します。moRef を取得するには、VMware vSphere moRef の取得 を参照してください。

   3

   追加の OpenShift Virtualization ネットワークごとにネットワークアタッチメント定義を指定します。

   4

   type が multus の場合に限り必要です。OpenShift Virtualization のネットワークアタッチメント定義の namespace を指定します。

5. StorageMap マニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode> 1
         source:
           id: <source_datastore> 2
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は ReadWriteOnce および ReadWriteMany です。

   2

   VMware vSphere データストアの moRef を指定します。たとえば、f2737930-b567-451a-9ceb-2887f6207009 です。moRef を取得するには、VMware vSphere moRef の取得 を参照してください。

6. オプション: Hook マニフェストを作成し、Plan CR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to clipboard

   ここでは、以下のようになります。

   Playbook は、任意の Base64 でエンコードされた Ansible Playbook を参照します。Playbook を指定する場合は、image が hook-runner である必要があります。

   注記

   デフォルトの hook-runner イメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。

7. 移行の Plan マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 1
     namespace: <namespace>
   spec:
     warm: false 2
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 3
       network: 4
         name: <network_map> 5
         namespace: <namespace>
       storage: 6
         name: <storage_map> 7
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms: 8
       - id: <source_vm> 9
       - name: <source_vm>
         hooks: 10
           - hook:
               namespace: <namespace>
               name: <hook> 11
             step: <step> 12
   EOF

   Copy to clipboard

   1

   Plan CR の名前を指定します。

   2

   移行がウォーム (true) かコールド (false) かを指定します。Migration マニフェストで cutover パラメーターの値を指定せずにウォーム移行を指定すると、プレコピーステージのみが実行します。

   3

   プランごとにネットワークマップとストレージマップを 1 つだけ指定します。

   4

   移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。

   5

   NetworkMap CR の名前を指定します。

   6

   移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。

   7

   StorageMap CR の名前を指定します。

   8

   id パラメーター または name パラメーターのいずれかを使用して、ソース仮想マシンを指定することができます。
   

   9

   VMware vSphere 仮想マシンの moRef を指定します。moRef を取得するには、VMware vSphere moRef の取得 を参照してください。

   10

   オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。

   11

   Hook CR の名前を指定します。

   12

   使用できる値は、移行計画が開始される前の PreHook、または移行が完了した後の PostHook です。

8. Plan CR を実行するための Migration マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <name_of_migration_cr>
     namespace: <namespace>
   spec:
     plan:
       name: <name_of_plan_cr>
       namespace: <namespace>
     cutover: <optional_cutover_time>
   EOF

   Copy to clipboard
   注記

   カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例: 2024-04-04T01:23:45.678+09:00)。

手順

1. 移行元プロバイダーの認証情報の Secret マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: <namespace>
     ownerReferences: 1
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: ovirt
       createdForResourceType: providers
   type: Opaque
   stringData:
     user: <user> 2
     password: <password> 3
     insecureSkipVerify: <"true"/"false"> 4
     cacert: | 5
       <ca_certificate>
     url: <api_end_point> 6
   EOF

   Copy to clipboard

   1

   ownerReferences セクションはオプションです。

   2

   RHV Manager ユーザーを指定します。

   3

   ユーザーパスワードを指定します。

   4

   "true" を指定して証明書の検証を省略し、"false" を指定して証明書を検証します。指定されていない場合はデフォルトで "false" になります。証明書の検証をスキップすると、安全でない移行が続行され、証明書は不要になります。セキュアではない移行とは、転送されたデータがセキュアではない接続を介して送信され、機密性の高いデータが公開される可能性があることを意味します。

   5

   サードパーティーの証明書に置き換えられていない限り、Manager CA 証明書を入力します。その場合は、Manager Apache CA 証明書を入力します。Manager CA 証明書は、https://<engine_host>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA で取得できます。

   6

   API エンドポイント URL を指定します (例: https://<engine_host>/ovirt-engine/api)。

2. 移行元プロバイダーの Provider マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: ovirt
     url: <api_end_point> 1
     secret:
       name: <secret> 2
       namespace: <namespace>
   EOF

   Copy to clipboard

   1

   API エンドポイントの URL を指定します (例: https://<engine_host>/ovirt-engine/api)。

   2

   プロバイダー Secret CR の名前を指定します。

3. 移行元ネットワークと移行先ネットワークをマッピングする NetworkMap マニフェストを作成します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           name: <network_name>
           type: pod 1
         source: 2
           id: <source_network_id>
           name: <source_network_name>
       - destination:
           name: <network_attachment_definition> 3
           namespace: <network_attachment_definition_namespace> 4
           type: multus
         source:
           id: <source_network_id>
           name: <source_network_name>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は Pod および multus です。

   2

   id パラメーター または name パラメーターのいずれかを使用して、ソースネットワークを指定できます。id には、RHV ネットワークの Universal Unique ID (UUID) を指定します。

   3

   追加の OpenShift Virtualization ネットワークごとにネットワークアタッチメント定義を指定します。

   4

   type が multus の場合に限り必要です。OpenShift Virtualization のネットワークアタッチメント定義の namespace を指定します。

4. StorageMap マニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode> 1
         source:
           id: <source_storage_domain> 2
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は ReadWriteOnce および ReadWriteMany です。

   2

   RHV ストレージドメイン UUID を指定します。たとえば、f2737930-b567-451a-9ceb-2887f6207009 です。

5. オプション: Hook マニフェストを作成し、Plan CR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to clipboard

   ここでは、以下のようになります。

   Playbook は、任意の Base64 でエンコードされた Ansible Playbook を参照します。Playbook を指定する場合は、image が hook-runner である必要があります。

   注記

   デフォルトの hook-runner イメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。

6. 移行の Plan マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 1
     namespace: <namespace>
     preserveClusterCpuModel: true 2
   spec:
     warm: false 3
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 4
       network: 5
         name: <network_map> 6
         namespace: <namespace>
       storage: 7
         name: <storage_map> 8
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms: 9
       - id: <source_vm> 10
       - name: <source_vm>
         hooks: 11
           - hook:
               namespace: <namespace>
               name: <hook> 12
             step: <step> 13
   EOF

   Copy to clipboard

   1

   Plan CR の名前を指定します。

   2

   以下の注を参照してください。

   3

   移行がウォームまたはコールドであるかどうかを指定します。Migration マニフェストで cutover パラメーターの値を指定せずにウォーム移行を指定すると、プレコピーステージのみが実行します。

   4

   プランごとにネットワークマップとストレージマップを 1 つだけ指定します。

   5

   移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。

   6

   NetworkMap CR の名前を指定します。

   7

   移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。

   8

   StorageMap CR の名前を指定します。

   9

   id パラメーター または name パラメーターのいずれかを使用して、ソース仮想マシンを指定できます。

   10

   RHV 仮想マシンの UUID を指定します。

   11

   オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。

   12

   Hook CR の名前を指定します。

   13

   使用できる値は、移行計画が開始される前の PreHook、または移行が完了した後の PostHook です。

   注記
   • 移行されたマシンにカスタム CPU モデルが設定されている場合、preserveClusterCpuModel の設定に関係なく、移行先クラスターでもその CPU モデルが設定されます。

   • 移行されたマシンにカスタム CPU モデルが 設定されていない 場合:

     • preserveClusterCpuModel が 'true` に設定されている場合、MTV はクラスターの設定に基づいて、RHV で実行されている仮想マシンの CPU モデルをチェックし、移行された仮想マシンをその CPU モデルに設定します。
     • preserveClusterCpuModel が 'false` に設定されている場合、MTV は CPU タイプを設定せず、仮想マシンが移行先クラスターのデフォルトの CPU モデルで設定されます。

7. Plan CR を実行するための Migration マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <name_of_migration_cr>
     namespace: <namespace>
   spec:
     plan:
       name: <name_of_plan_cr>
       namespace: <namespace>
     cutover: <optional_cutover_time>
   EOF

   Copy to clipboard
   注記

   カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例: 2024-04-04T01:23:45.678+09:00)。

手順

1. 移行元プロバイダーの認証情報の Secret マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: <namespace>
     ownerReferences: 1
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: openstack
       createdForResourceType: providers
   type: Opaque
   stringData:
     user: <user> 2
     password: <password> 3
     insecureSkipVerify: <"true"/"false"> 4
     domainName: <domain_name>
     projectName: <project_name>
     regionName: <region_name>
     cacert: | 5
       <ca_certificate>
     url: <api_end_point> 6
   EOF

   Copy to clipboard

   1

   ownerReferences セクションはオプションです。

   2

   OpenStack ユーザーを指定します。

   3

   OpenStack ユーザーのパスワードを指定します。

   4

   "true" を指定して証明書の検証を省略し、"false" を指定して証明書を検証します。指定されていない場合はデフォルトで "false" になります。証明書の検証をスキップすると、安全でない移行が続行され、証明書は不要になります。セキュアではない移行とは、転送されたデータがセキュアではない接続を介して送信され、機密性の高いデータが公開される可能性があることを意味します。

   5

   このフィールドが設定されておらず、skip certificate verification が無効になっている場合、MTV はシステム CA の使用を試みます。

   6

   API エンドポイント URL を指定します (例: https://<identity_service>/v3)。

2. 移行元プロバイダーの Provider マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: openstack
     url: <api_end_point> 1
     secret:
       name: <secret> 2
       namespace: <namespace>
   EOF

   Copy to clipboard

   1

   API エンドポイントの URL を指定します。

   2

   プロバイダー Secret CR の名前を指定します。

3. 移行元ネットワークと移行先ネットワークをマッピングする NetworkMap マニフェストを作成します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           name: <network_name>
           type: pod 1
         source:2
           id: <source_network_id>
           name: <source_network_name>
       - destination:
           name: <network_attachment_definition> 3
           namespace: <network_attachment_definition_namespace> 4
           type: multus
         source:
           id: <source_network_id>
           name: <source_network_name>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は Pod および multus です。

   2

   id パラメーター または name パラメーターのいずれかを使用して、ソースネットワークを指定できます。id には、OpenStack ネットワークの UUID を指定します。

   3

   追加の OpenShift Virtualization ネットワークごとにネットワークアタッチメント定義を指定します。

   4

   type が multus の場合に限り必要です。OpenShift Virtualization のネットワークアタッチメント定義の namespace を指定します。

4. StorageMap マニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode> 1
         source:
           id: <source_volume_type> 2
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は ReadWriteOnce および ReadWriteMany です。

   2

   OpenStack volume_type UUID を指定します。たとえば、f2737930-b567-451a-9ceb-2887f6207009 です。

5. オプション: Hook マニフェストを作成し、Plan CR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to clipboard

   ここでは、以下のようになります。

   Playbook は、任意の Base64 でエンコードされた Ansible Playbook を参照します。Playbook を指定する場合は、image が hook-runner である必要があります。

   注記

   デフォルトの hook-runner イメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。

6. 移行の Plan マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 1
     namespace: <namespace>
   spec:
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 2
       network: 3
         name: <network_map> 4
         namespace: <namespace>
       storage: 5
         name: <storage_map> 6
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms: 7
       - id: <source_vm> 8
       - name: <source_vm>
         hooks: 9
           - hook:
               namespace: <namespace>
               name: <hook> 10
             step: <step> 11
   EOF

   Copy to clipboard

   1

   Plan CR の名前を指定します。

   2

   プランごとにネットワークマップとストレージマップを 1 つだけ指定します。

   3

   移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。

   4

   NetworkMap CR の名前を指定します。

   5

   移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。

   6

   StorageMap CR の名前を指定します。

   7

   id パラメーター または name パラメーターのいずれかを使用して、ソース仮想マシンを指定できます。

   8

   OpenStack 仮想マシン UUID を指定します。

   9

   オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。

   10

   Hook CR の名前を指定します。

   11

   使用できる値は、移行計画が開始される前の PreHook、または移行が完了した後の PostHook です。

7. Plan CR を実行するための Migration マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <name_of_migration_cr>
     namespace: <namespace>
   spec:
     plan:
       name: <name_of_plan_cr>
       namespace: <namespace>
     cutover: <optional_cutover_time>
   EOF

   Copy to clipboard
   注記

   カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例: 2024-04-04T01:23:45.678+09:00)。

手順

1. 移行元プロバイダーの認証情報の Secret マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: <namespace>
     ownerReferences: 1
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: ova
       createdForResourceType: providers
   type: Opaque
   stringData:
     url: <nfs_server:/nfs_path> 2
   EOF

   Copy to clipboard

   1

   ownerReferences セクションはオプションです。

   2

   ここで、nfs_server は、共有が作成されたサーバーの IP またはホスト名、nfs_path は OVA ファイルが保存されているサーバー上のパスに置き換えます。

2. 移行元プロバイダーの Provider マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: ova
     url:  <nfs_server:/nfs_path> 1
     secret:
       name: <secret> 2
       namespace: <namespace>
   EOF

   Copy to clipboard

   1

   ここで、nfs_server は、共有が作成されたサーバーの IP またはホスト名、nfs_path は OVA ファイルが保存されているサーバー上のパスに置き換えます。

   2

   プロバイダー Secret CR の名前を指定します。

3. 移行元ネットワークと移行先ネットワークをマッピングする NetworkMap マニフェストを作成します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           name: <network_name>
           type: pod 1
         source:
           id: <source_network_id> 2
       - destination:
           name: <network_attachment_definition> 3
           namespace: <network_attachment_definition_namespace> 4
           type: multus
         source:
           id: <source_network_id>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は Pod および multus です。

   2

   OVA ネットワーク Universal Unique ID (UUID) を指定します。

   3

   追加の OpenShift Virtualization ネットワークごとにネットワークアタッチメント定義を指定します。

   4

   type が multus の場合に限り必要です。OpenShift Virtualization のネットワークアタッチメント定義の namespace を指定します。

4. StorageMap マニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode> 1
         source:
           name:  Dummy storage for source provider <provider_name> 2
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は ReadWriteOnce および ReadWriteMany です。

   2

   OVA の場合、StorageMap は、OVA のすべてのディスクが関連付けられている単一のストレージのみを移行先のストレージクラスにマップできます。このため、ストレージは UI では "Dummy storage for source provider <provider_name>" と呼ばれます。YAML では、引用符なしで上記のフレーズを記述し、<provider_name> をプロバイダーの実際の名前に置き換えます。

5. オプション: Hook マニフェストを作成し、Plan CR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to clipboard

   ここでは、以下のようになります。

   Playbook は、任意の Base64 でエンコードされた Ansible Playbook を参照します。Playbook を指定する場合は、image が hook-runner である必要があります。

   注記

   デフォルトの hook-runner イメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。

6. 移行の Plan マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 1
     namespace: <namespace>
   spec:
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 2
       network: 3
         name: <network_map> 4
         namespace: <namespace>
       storage: 5
         name: <storage_map> 6
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms: 7
       - id: <source_vm> 8
       - name: <source_vm>
         hooks: 9
           - hook:
               namespace: <namespace>
               name: <hook> 10
             step: <step> 11
   EOF

   Copy to clipboard

   1

   Plan CR の名前を指定します。

   2

   プランごとにネットワークマップとストレージマップを 1 つだけ指定します。

   3

   移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。

   4

   NetworkMap CR の名前を指定します。

   5

   移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。

   6

   StorageMap CR の名前を指定します。

   7

   id パラメーター または name パラメーターのいずれかを使用して、ソース仮想マシンを指定できます。

   8

   OVA 仮想マシン UUID を指定します。

   9

   オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。

   10

   Hook CR の名前を指定します。

   11

   使用できる値は、移行計画が開始される前の PreHook、または移行が完了した後の PostHook です。

7. Plan CR を実行するための Migration マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <name_of_migration_cr>
     namespace: <namespace>
   spec:
     plan:
       name: <name_of_plan_cr>
       namespace: <namespace>
     cutover: <optional_cutover_time>
   EOF

   Copy to clipboard
   注記

   カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例: 2024-04-04T01:23:45.678+09:00)。

手順

1. 移行元プロバイダーの認証情報の Secret マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: <namespace>
     ownerReferences: 1
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: openshift
       createdForResourceType: providers
   type: Opaque
   stringData:
     token: <token> 2
     password: <password> 3
     insecureSkipVerify: <"true"/"false"> 4
     cacert: | 5
       <ca_certificate>
     url: <api_end_point> 6
   EOF

   Copy to clipboard

   1

   ownerReferences セクションはオプションです。

   2

   cluster-admin 権限でサービスアカウントのトークンを指定します。トークン と URL の両方が空白のままの場合、ローカル OpenShift クラスターが使用されます。

   3

   ユーザーパスワードを指定します。

   4

   "true" を指定して証明書の検証を省略し、"false" を指定して証明書を検証します。指定されていない場合はデフォルトで "false" になります。証明書の検証をスキップすると、安全でない移行が続行され、証明書は不要になります。セキュアではない移行とは、転送されたデータがセキュアではない接続を介して送信され、機密性の高いデータが公開される可能性があることを意味します。

   5

   このフィールドが設定されておらず、skip certificate verification が無効になっている場合、MTV はシステム CA の使用を試みます。

   6

   API サーバーのエンドポイントの URL を指定します。

2. 移行元プロバイダーの Provider マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: openshift
     url: <api_end_point> 1
     secret:
       name: <secret> 2
       namespace: <namespace>
   EOF

   Copy to clipboard

   1

   API サーバーのエンドポイントの URL を指定します。

   2

   プロバイダー Secret CR の名前を指定します。

3. 移行元ネットワークと移行先ネットワークをマッピングする NetworkMap マニフェストを作成します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           name: <network_name>
           type: pod 1
         source:
           name: <network_name>
           type: pod
       - destination:
           name: <network_attachment_definition> 2
           namespace: <network_attachment_definition_namespace> 3
           type: multus
         source:
           name: <network_attachment_definition>
           namespace: <network_attachment_definition_namespace>
           type: multus
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は Pod および multus です。

   2

   追加の OpenShift Virtualization ネットワークごとにネットワークアタッチメント定義を指定します。namespace property を使用するか、<network_namespace>/<network_name> のように構築された名前で namespace を指定します。

   3

   type が multus の場合に限り必要です。OpenShift Virtualization のネットワークアタッチメント定義の namespace を指定します。

4. StorageMap マニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode> 1
         source:
           name: <storage_class>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to clipboard

   1

   使用できる値は ReadWriteOnce および ReadWriteMany です。

5. オプション: Hook マニフェストを作成し、Plan CR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to clipboard

   ここでは、以下のようになります。

   Playbook は、任意の Base64 でエンコードされた Ansible Playbook を参照します。Playbook を指定する場合は、image が hook-runner である必要があります。

   注記

   デフォルトの hook-runner イメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。

6. 移行の Plan マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 1
     namespace: <namespace>
   spec:
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 2
       network: 3
         name: <network_map> 4
         namespace: <namespace>
       storage: 5
         name: <storage_map> 6
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms:
       - name: <source_vm>
         namespace: <namespace>
         hooks: 7
           - hook:
               namespace: <namespace>
               name: <hook> 8
             step: <step> 9
   EOF

   Copy to clipboard

   1

   Plan CR の名前を指定します。

   2

   プランごとにネットワークマップとストレージマップを 1 つだけ指定します。

   3

   移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。

   4

   NetworkMap CR の名前を指定します。

   5

   移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。

   6

   StorageMap CR の名前を指定します。

   7

   オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。

   8

   Hook CR の名前を指定します。

   9

   使用できる値は、移行計画が開始される前の PreHook、または移行が完了した後の PostHook です。

7. Plan CR を実行するための Migration マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <name_of_migration_cr>
     namespace: <namespace>
   spec:
     plan:
       name: <name_of_plan_cr>
       namespace: <namespace>
     cutover: <optional_cutover_time>
   EOF

   Copy to clipboard
   注記

   カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例: 2024-04-04T01:23:45.678+09:00)。

手順

1. Validation Pod のターミナルに接続します。

   $ oc rsh <validation_pod>

   Copy to clipboard

2. プロバイダーの OPA ポリシーディレクトリーに移動します。

   $ cd /usr/share/opa/policies/io/konveyor/forklift/<provider> 1

   Copy to clipboard

   1

   vmware または ovirt を指定します。

3. デフォルトポリシーを検索します。

   $ grep -R "default" *

   Copy to clipboard

手順

1. 以下の例に従って設定マップ CR を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: <forklift-validation-config>
     namespace: openshift-mtv
   data:
     vmware_multiple_disks.rego: |-
       package <provider_package> 1
   
       has_multiple_disks { 2
         count(input.disks) > 1
       }
   
       concerns[flag] {
         has_multiple_disks 3
           flag := {
             "category": "<Information>", 4
             "label": "Multiple disks detected",
             "assessment": "Multiple disks detected on this VM."
           }
       }
   EOF

   Copy to clipboard

   1

   プロバイダーパッケージ名を指定します。使用できる値は、VMware の場合が io.konveyor.forklift.vmware、Red Hat Virtualization の場合が io.konveyor.forklift.ovirt です。

   2

   concerns の名前と Rego クエリーを指定します。

   3

   concerns の名前と flag パラメーターの値を指定します。

   4

   使用できる値は Critical、Warning、および Information です。

2. forklift-controller デプロイメントを 0 にスケーリングして、Validation Pod を停止します。

   $ oc scale -n openshift-mtv --replicas=0 deployment/forklift-controller

   Copy to clipboard

3. forklift-controller デプロイメントを 1 にスケーリングして、Validation Pod を起動します。

   $ oc scale -n openshift-mtv --replicas=1 deployment/forklift-controller

   Copy to clipboard

4. Validation Pod ログをチェックして、Pod が起動したことを確認します。

   $ oc logs -f <validation_pod>

   Copy to clipboard

   カスタムルールがデフォルトのルールと競合する場合、Validation Pod は起動しません。

5. 移行元プロバイダーを削除します。

   $ oc delete provider <provider> -n openshift-mtv

   Copy to clipboard

6. 移行元プロバイダーを追加して、新規ルールを適用します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <provider>
     namespace: openshift-mtv
   spec:
     type: <provider_type> 1
     url: <api_end_point> 2
     secret:
       name: <secret> 3
       namespace: openshift-mtv
   EOF

   Copy to clipboard

   1

   使用できる値は、ovirt、vsphere、および openstack です。

   2

   API エンドポイント URL を指定します。たとえば、vSphere の場合は https://<vCenter_host>/sdk、RHV の場合は https://<engine_host>/ovirt-engine/api、OpenStack の場合は https://<identity_service>/v3 です。

   3

   プロバイダーの Secret CR の名前を指定します。

手順

1. 現在のルールバージョンを取得します。

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 1

   Copy to clipboard

   出力例

   {
      "result": {
          "rules_version": 5
      }
   }

   Copy to clipboard

2. Validation Pod のターミナルに接続します。

   $ oc rsh <validation_pod>

   Copy to clipboard
3. /usr/share/opa/policies/io/konveyor/forklift/<provider>/rules_version.rego ファイルでルールバージョンを更新します。
4. Validation Pod ターミナルからログアウトします。

5. 更新されたルールバージョンを検証します。

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 1

   Copy to clipboard

   出力例

   {
      "result": {
          "rules_version": 6
      }
   }

   Copy to clipboard