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

手順

1. Red Hat OpenShift Web コンソールで、Operators → OperatorHub をクリックします。
2. Filter by keyword フィールドを使用して mtv-operator を検索します。
3. Migration Toolkit for Virtualization Operator をクリックしてから Install をクリックします。
4. ボタンがアクティブになったら、Create ForkliftController をクリックします。

5. Create をクリックします。

   ForkliftController が表示されるリストに表示されます。

6. Workloads → Pods をクリックし、MTV Pod が実行されていることを確認します。

7. Operators → Installed Operators をクリックして、Migration Toolkit for Virtualization Operator が Succeeded のステータスで openshift-mtv プロジェクトに表示されることを確認します。

   プラグインの準備が整ったら、ページのリロードが求められます。Migration メニュー項目は、Red Hat OpenShift Web コンソールの左側に表示されるナビゲーションバーに自動的に追加されます。

手順

1. openshift-mtv プロジェクトを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: openshift-mtv
   EOF

2. 名前が migration の OperatorGroup CR を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: migration
     namespace: openshift-mtv
   spec:
     targetNamespaces:
       - openshift-mtv
   EOF

3. Operator の Subscription CR を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: mtv-operator
     namespace: openshift-mtv
   spec:
     channel: release-v2.8
     installPlanApproval: Automatic
     name: mtv-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     startingCSV: "mtv-operator.v2.8.3"
   EOF

4. ForkliftController CR を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: ForkliftController
   metadata:
     name: forklift-controller
     namespace: openshift-mtv
   spec:
     olm_managed: true
   EOF

5. MTV Pod が実行していることを確認します。

   $ oc get pods -n openshift-mtv

   出力例

   NAME                                                    READY   STATUS    RESTARTS   AGE
   forklift-api-bb45b8db4-cpzlg                            1/1     Running   0          6m34s
   forklift-controller-7649db6845-zd25p                    2/2     Running   0          6m38s
   forklift-must-gather-api-78fb4bcdf6-h2r4m               1/1     Running   0          6m28s
   forklift-operator-59c87cfbdc-pmkfc                      1/1     Running   0          28m
   forklift-ui-plugin-5c5564f6d6-zpd85                     1/1     Running   0          6m24s
   forklift-validation-7d84c74c6f-fj9xg                    1/1     Running   0          6m30s
   forklift-volume-populator-controller-85d5cb64b6-mrlmc   1/1     Running   0          6m36s

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. vSphere をクリックします。

4. 次のフィールドを指定します。

   Provider details

   • Provider resource name: 移行元プロバイダーの名前。
   • Endpoint type: vSphere プロバイダーエンドポイントタイプを選択します。オプション: vCenter または ESXi。仮想マシンは、vCenter、vCenter によって管理されていない ESX/ESXi サーバー、または vCenter によって管理されているが vCenter を経由しない ESX/ESXi サーバーから移行できます。
   • URL: ソース仮想マシンがマウントされている vCenter の SDK エンドポイントの URL。URL に sdk パス (通常は /sdk) が含まれていることを確認してください。たとえば、https://vCenter-host-example.com/sdk です。FQDN の証明書が指定されている場合、このフィールドの値は証明書内の FQDN と一致する必要があります。
   • VDDK init image: VDDKInitImage パス。移行を加速するために、VDDK init イメージの作成が強く推奨されます。詳細は、VDDK イメージの作成 を参照してください。

   プロバイダー認証情報

   • Username: vCenter ユーザーまたは ESXi ユーザー。たとえば、user@vsphere.local です。
   • Password: vCenter ユーザーパスワードまたは ESXi ユーザーパスワード。

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

   注記

   プロバイダーのステータスが Ready になるまでには数分かかる場合があります。

8. オプション: プロバイダーの UI へのアクセスを追加します。

   1. Providers ページで、プロバイダーをクリックします。

      Provider details ページが開きます。

   2. External UI web link の下の Edit アイコンをクリックします。

   3. リンクを入力して Save をクリックします。

      注記

      リンクを入力しない場合、MTV によって正しいリンクの計算が試行されます。

      • MTV が成功した場合、フィールドのハイパーリンクの参照先が計算されたリンクになります。
      • MTV が成功しなかった場合、フィールドは空のままになります。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. プロバイダーの横にある Hosts 列のホスト番号をクリックし、ホストのリストを表示します。
3. 1 つまたは複数のホストを選択し、Select migration network をクリックします。

4. 次のフィールドを指定します。

   • Network: ネットワーク名
   • ESXi host admin username: 例: root
   • ESXi host admin password: パスワード
5. Save をクリックします。

6. 各ホストのステータスが Ready であることを確認します。

   ホストのステータスが Ready でない場合、移行ネットワーク上でホストに到達できないか、クレデンシャルが正しくない可能性があります。ホスト設定を変更して、変更を保存できます。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. OpenShift Virtualization をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前
   • URL: API サーバーのエンドポイントの URL

   • Service account bearer token: cluster-admin 権限を持つサービスアカウントのトークン

     URL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

手順

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

2. 変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。

   Providers detail ページが表示されたら:

3. Networks タブをクリックします。
4. Set default transfer network をクリックします。
5. リストからデフォルトの転送ネットワークを選択し、Save をクリックします。

6. 次の手順を実行して、MTV 移行に使用するネットワーク内のゲートウェイを設定します。

   1. Red Hat OpenShift Web コンソールで、Networking > NetworkAttachmentDefinitions をクリックします。
   2. 適切なデフォルトの転送ネットワーク NAD を選択します。
   3. YAML タブをクリックします。

   4. 次の例のように、YAML の metadata:annotations セクションに forklift.konveyor.io/route を追加します。

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 1

      1

      インターフェイスの IP アドレスを、Dynamic Host Configuration Protocol (DHCP) から設定する、または静的に設定するには、NetworkAttachmentDefinition パラメーターが必要です。IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   5. Save をクリックします。

手順

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. Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
6. Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。

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

   MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。

   プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。

8. このページの Settings セクションで、以下の項目を確認します。

   • Migration type: 移行のタイプ。デフォルトでは、MTV は移行タイプを cold に設定します。

     • ウォーム移行の場合は、次の手順を実行します。

       • Edit アイコンをクリックします。
       • Whether this is a warm migration スイッチを切り替えます。
       • Save をクリックします。

   • Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。プロバイダーのデフォルトの転送ネットワークです。転送ネットワークが選択したターゲット namespace にあることを確認します。

     • 転送ネットワークを編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • リストから別の転送ネットワークを選択します。
       • Save をクリックします。

     • オプション: OpenShift Web コンソールで OpenShift ネットワークを設定するには、Networking > NetworkAttachmentDefinitions をクリックします。

       OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。

     • オプション: OpenShift 転送ネットワークの最大転送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。

   • Target namespace: 移行されたすべての仮想マシンの宛先 namespace。デフォルトでは、宛先 namespace は現在の、またはアクティブな namespace です。

     • namespace を編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • 開いたウィンドウのリストから別のターゲット namespace を選択します。
       • Save をクリックします。

   • Preserve static IPs: デフォルトでは、仮想ネットワークインターフェイスコントローラー (vNIC) は移行プロセス中に変更されます。その結果、ゲスト仮想マシンのインターフェイス名にリンクされた静的 IP で設定された vNIC は移行中に IP を失います。

     • 静的 IP を保持するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • Whether to preserve the static IPs スイッチを切り替えます。

       • Save をクリックします。

         その後、MTV は、vNIC プロパティーが欠落している仮想マシンに関する警告メッセージを発行します。欠落している vNIC プロパティーを取得するには、vSphere でそれらの仮想マシンを実行します。これにより、vNIC プロパティーが MTV に報告されます。

   • Disk decryption passphrases: Linux Unified Key Setup (LUKS) を使用して暗号化されたディスクの場合。

     • LUKS で暗号化されたデバイスの復号パスフレーズのリストを入力するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • パスフレーズを入力します。

       • Save をクリックします。

         パスフレーズは特定の順序で入力する必要はありません。LUKS 暗号化デバイスごとに、MTV はデバイスのロックを解除するまで各パスフレーズを試みます。

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

     • 別の root デバイスを指定するには、次の手順を実行します。

       • Root device の横にある Edit アイコンをクリックします。
       • リストからデバイスを選択するか、テキストボックスにデバイスを入力します。

       • Save をクリックします。

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

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

   • Shared disks: コールド移行にのみ適用されます。共有ディスクは、複数の仮想マシンにアタッチされ、multi-writer オプションを使用するディスクです。これらの特性があるため、共有ディスクの移行は困難です。デフォルトでは、MTV は共有ディスクを移行しません。

     注記

     共有ディスクを移行すると、移行プロセスが遅くなる可能性があります。

     • 移行計画で共有ディスクを移行するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • Migrate shared disks スイッチを切り替えます。
       • Save をクリックします。

   • オプション: PVC name template: 計画に含まれる仮想マシンの永続ボリューム要求 (PVC) の名前テンプレートを指定します。

     テンプレートは Go テンプレート構文に準拠し、次の変数にアクセスできます。

     • .VnName: 仮想マシンの名前
     • .PlanName: 移行計画の名前
     • .DiskIndex: ディスクの初期ボリュームインデックス

     • .RootDiskIndex: ルートディスクのインデックス

       例

     • "{{.VmName}}-disk-{{.DiskIndex}}"

     • "{{if eq .DiskIndex .RootDiskIndex}}root{{else}}data{{end}}-{{.DiskIndex}}"

       変数名は 63 文字以内でなければなりません。

     • 計画に含まれるすべての仮想マシンの PVC 名テンプレートを指定するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • Enter custom naming template をクリックします。
       • 指示に従ってテンプレートを入力します。
       • Save をクリックします。

     • 特定の仮想マシンに対してのみ PVC 名テンプレートを指定するには、次の手順を実行します。

       • Virtual Machines タブをクリックします。
       • 仮想マシンを選択します。
       • 仮想マシンの Options メニュー をクリックします。
       • Edit PVC name template を選択します。
       • 指示に従ってテンプレートを入力します。

       • Save をクリックします。

         重要

         Virtual Machines タブで行った変更は、Plan details ページで行った変更をオーバーライドします。

   • オプション: Volume name template: 計画に含まれる仮想マシンのボリュームインターフェイス名のテンプレートを指定します。

     テンプレートは Go テンプレート構文に準拠し、次の変数にアクセスできます。

     • .PVCName: このボリュームを使用して仮想マシンにマウントされた PVC の名前

     • .VolumeIndex: ボリュームインターフェイスの連続インデックス (0-based)

       例

     • "disk-{{.VolumeIndex}}"

     • "pvc-{{.PVCName}}"

       変数名は 63 文字以内でなければなりません。

     • 計画内のすべての仮想マシンのボリューム名テンプレートを指定するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • Enter custom naming template をクリックします。
       • 指示に従ってテンプレートを入力します。
       • Save をクリックします。

     • 特定の仮想マシンに対してのみ異なるボリューム名テンプレートを指定するには、次の手順を実行します。

       • Virtual Machines タブをクリックします。
       • 仮想マシンを選択します。
       • 仮想マシンの Options メニュー をクリックします。
       • Edit Volume name template を選択します。
       • 指示に従ってテンプレートを入力します。

       • Save をクリックします。

         重要

         Virtual Machines タブで行った変更は、Plan details ページで行った変更をオーバーライドします。

   • オプション: Network name template: 計画に含まれる仮想マシンのネットワークインターフェイス名のテンプレートを指定します。

     テンプレートは Go テンプレート構文に準拠し、次の変数にアクセスできます。

     • .NetworkName: ターゲットネットワークが multus の場合は、Multus ネットワーク接続定義の名前を追加します。それ以外の場合は、この変数を空のままにします。
     • .NetworkNamespace: ターゲットネットワークが multus の場合、Multus ネットワーク接続定義が配置されている namespace を追加します。
     • .NetworkType: ネットワークタイプ。オプション: multus または pod。

     • .NetworkIndex: ネットワークインターフェイスの連続インデックス (0-based)。

       例

     • "net-{{.NetworkIndex}}"

     • {{if eq .NetworkType "pod"}}pod{{else}}multus-{{.NetworkIndex}}{{end}}"

       変数名は 63 文字以内でなければなりません。

     • 計画に含まれるすべての仮想マシンのネットワーク名テンプレートを指定するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • Enter custom naming template をクリックします。
       • 指示に従ってテンプレートを入力します。
       • Save をクリックします。

     • 特定の仮想マシンに対してのみ異なるネットワーク名テンプレートを指定するには、次の手順を実行します。

       • Virtual Machines タブをクリックします。
       • 仮想マシンを選択します。
       • 仮想マシンの Options メニュー をクリックします。
       • Edit Network name template を選択します。
       • 指示に従ってテンプレートを入力します。

       • Save をクリックします。

         重要

         Virtual Machines タブで行った変更は、Plan details ページで行った変更をオーバーライドします。

9. 計画が有効な場合、以下のいずれかを実行できます。

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

手順

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

   Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。

2. 移行計画の横にある Start をクリックして移行を開始します。

3. 開いた確認ウィンドウで Start をクリックします。

   プランの Status が Running に変更され、移行の進捗が表示されます。

   ウォーム移行のみ:

   • プレコピー段階が開始します。

   • Cutover クリックして移行を完了します。

     警告

     移行の開始後に仮想マシンのスナップショットを作成しないでください。移行の開始後にスナップショットを作成すると、移行が失敗する可能性があります。

4. オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。

   • 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。

   • 右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。

     • 仮想マシンの名前
     • 移行の開始時間と終了時間
     • コピーされたデータ量

     • 仮想マシンの移行の進捗パイプライン

       警告

       データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。

5. オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。

   1. Virtual Machines タブをクリックします。

   2. 移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。

      仮想マシンの詳細が表示されます。

   3. Pods セクションの Pod links 列で、Logs リンクをクリックします。

      Logs タブが開きます。

      注記

      ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。

      • OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、virt-v2v は関係しないため、Pod は必要ありません。
      • Pod が作成されなかった。
      • Pod が削除された。
      • Pod を実行する前に移行に失敗した。
   4. Raw ログを表示するには、Raw リンクをクリックします。
   5. ログをダウンロードするには、Download リンクをクリックします。

手順

1. Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
2. 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
3. 1 つ以上の仮想マシンを選択し、Cancel をクリックします。

4. Yes, cancel をクリックしてキャンセルを確定します。

   Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. Red Hat Virtualization をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前。
   • URL: ソース仮想マシンがマウントされている Red Hat Virtualization Manager (RHVM) の API エンドポイントの URL。URL に、RHVM API サーバーへのパス (通常は /ovirt-engine/api) が含まれていることを確認してください。たとえば、https://rhv-host-example.com/ovirt-engine/api です。
   • Username: ユーザー名。
   • Password: パスワード。

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

8. オプション: プロバイダーの UI へのアクセスを追加します。

   1. Providers ページで、プロバイダーをクリックします。

      Provider details ページが開きます。

   2. External UI web link の下の Edit アイコンをクリックします。

   3. リンクを入力して Save をクリックします。

      注記

      リンクを入力しない場合、MTV によって正しいリンクの計算が試行されます。

      • MTV が成功した場合、フィールドのハイパーリンクの参照先が計算されたリンクになります。
      • MTV が成功しなかった場合、フィールドは空のままになります。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. OpenShift Virtualization をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前
   • URL: API サーバーのエンドポイントの URL

   • Service account bearer token: cluster-admin 権限を持つサービスアカウントのトークン

     URL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

手順

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

2. 変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。

   Providers detail ページが表示されたら:

3. Networks タブをクリックします。
4. Set default transfer network をクリックします。
5. リストからデフォルトの転送ネットワークを選択し、Save をクリックします。

6. 次の手順を実行して、MTV 移行に使用するネットワーク内のゲートウェイを設定します。

   1. Red Hat OpenShift Web コンソールで、Networking > NetworkAttachmentDefinitions をクリックします。
   2. 適切なデフォルトの転送ネットワーク NAD を選択します。
   3. YAML タブをクリックします。

   4. 次の例のように、YAML の metadata:annotations セクションに forklift.konveyor.io/route を追加します。

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 1

      1

      インターフェイスの IP アドレスを、Dynamic Host Configuration Protocol (DHCP) から設定する、または静的に設定するには、NetworkAttachmentDefinition パラメーターが必要です。IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   5. Save をクリックします。

手順

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. Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
6. Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。

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

   MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。

   プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。

8. このページの Settings セクションで、以下の項目を確認します。

   • Migration type: 移行のタイプ。デフォルトでは、MTV は移行タイプを cold に設定します。

     • ウォーム移行の場合は、次の手順を実行します。

       • Edit アイコンをクリックします。
       • Whether this is a warm migration スイッチを切り替えます。
       • Save をクリックします。

   • Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。プロバイダーのデフォルトの転送ネットワークです。転送ネットワークが選択したターゲット namespace にあることを確認します。

     • 転送ネットワークを編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • リストから別の転送ネットワークを選択します。
       • Save をクリックします。

     • オプション: OpenShift Web コンソールで OpenShift ネットワークを設定するには、Networking > NetworkAttachmentDefinitions をクリックします。

       OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。

     • オプション: OpenShift 転送ネットワークの最大転送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。

   • Target namespace: 移行されたすべての仮想マシンの宛先 namespace。デフォルトでは、宛先 namespace は現在の、またはアクティブな namespace です。

     • namespace を編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • 開いたウィンドウのリストから別のターゲット namespace を選択します。
       • Save をクリックします。

   • Preserving the CPU model of VMs that are migrated from RHV: 通常、RHV 仮想マシンの CPU モデル (タイプ) はクラスターレベルで設定されます。ただし、CPU モデルは仮想マシンレベルで設定でき、これをカスタム CPU モデルと呼びます。

     デフォルトでは、MTV は宛先クラスターの CPU モデルを次のように設定します: MTV preserves custom CPU settings for VMs that have them。カスタム CPU 設定のない仮想マシンの場合、MTV は CPU モデルを設定しません。代わりに、CPU モデルは OpenShift Virtualization によって後で設定されます。

     • RHV 仮想マシンのクラスターレベルの CPU モデルを保持するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • Whether to preserve the CPU model スイッチを切り替えます。
       • Save をクリックします。

9. 計画が有効な場合、以下のいずれかを実行できます。

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

手順

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

   Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。

2. 移行計画の横にある Start をクリックして移行を開始します。

3. 開いた確認ウィンドウで Start をクリックします。

   プランの Status が Running に変更され、移行の進捗が表示されます。

   ウォーム移行のみ:

   • プレコピー段階が開始します。

   • Cutover クリックして移行を完了します。

     警告

     移行の開始後に仮想マシンのスナップショットを作成しないでください。移行の開始後にスナップショットを作成すると、移行が失敗する可能性があります。

4. オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。

   • 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。

   • 右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。

     • 仮想マシンの名前
     • 移行の開始時間と終了時間
     • コピーされたデータ量

     • 仮想マシンの移行の進捗パイプライン

       警告

       データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。

5. オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。

   1. Virtual Machines タブをクリックします。

   2. 移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。

      仮想マシンの詳細が表示されます。

   3. Pods セクションの Pod links 列で、Logs リンクをクリックします。

      Logs タブが開きます。

      注記

      ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。

      • OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、virt-v2v は関係しないため、Pod は必要ありません。
      • Pod が作成されなかった。
      • Pod が削除された。
      • Pod を実行する前に移行に失敗した。
   4. Raw ログを表示するには、Raw リンクをクリックします。
   5. ログをダウンロードするには、Download リンクをクリックします。

手順

1. Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
2. 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
3. 1 つ以上の仮想マシンを選択し、Cancel をクリックします。

4. Yes, cancel をクリックしてキャンセルを確定します。

   Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. OpenStack をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前。
   • URL: OpenStack Identity (Keystone) エンドポイントの URL。たとえば、http://controller:5000/v3 です。

   • Authentication type: 次の認証方法のいずれかを選択し、選択した内容に関連する情報を入力します。たとえば、認証タイプとして Application credential ID を選択した場合は、Application credential ID と Application credential secret フィールドがアクティブになり、ID とシークレットを指定する必要があります。

     • Application credential ID

       • Application credential ID: OpenStack アプリケーション認証情報 ID
       • Application credential secret: OpenStack アプリケーション認証情報の Secret

     • Application credential name

       • Application credential name: OpenStack アプリケーションの認証情報名
       • Application credential secret: OpenStack アプリケーション認証情報の Secret
       • Username: OpenStack ユーザー名
       • Domain: OpenStack ドメイン名

     • Token with user ID

       • Token: OpenStack トークン
       • User ID: OpenStack ユーザー ID
       • Project ID: OpenStack プロジェクト ID

     • ユーザー名のトークン

       • Token: OpenStack トークン
       • Username: OpenStack ユーザー名
       • Project: OpenStack プロジェクト
       • Domain name: OpenStack ドメイン名

     • Password

       • Username: OpenStack ユーザー名
       • Password: OpenStack パスワード
       • Project: OpenStack プロジェクト
       • Domain: OpenStack ドメイン名

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

8. オプション: プロバイダーの UI へのアクセスを追加します。

   1. Providers ページで、プロバイダーをクリックします。

      Provider details ページが開きます。

   2. External UI web link の下の Edit アイコンをクリックします。

   3. リンクを入力して Save をクリックします。

      注記

      リンクを入力しない場合、MTV によって正しいリンクの計算が試行されます。

      • MTV が成功した場合、フィールドのハイパーリンクの参照先が計算されたリンクになります。
      • MTV が成功しなかった場合、フィールドは空のままになります。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. OpenShift Virtualization をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前
   • URL: API サーバーのエンドポイントの URL

   • Service account bearer token: cluster-admin 権限を持つサービスアカウントのトークン

     URL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

手順

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

2. 変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。

   Providers detail ページが表示されたら:

3. Networks タブをクリックします。
4. Set default transfer network をクリックします。
5. リストからデフォルトの転送ネットワークを選択し、Save をクリックします。

6. 次の手順を実行して、MTV 移行に使用するネットワーク内のゲートウェイを設定します。

   1. Red Hat OpenShift Web コンソールで、Networking > NetworkAttachmentDefinitions をクリックします。
   2. 適切なデフォルトの転送ネットワーク NAD を選択します。
   3. YAML タブをクリックします。

   4. 次の例のように、YAML の metadata:annotations セクションに forklift.konveyor.io/route を追加します。

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 1

      1

      インターフェイスの IP アドレスを、Dynamic Host Configuration Protocol (DHCP) から設定する、または静的に設定するには、NetworkAttachmentDefinition パラメーターが必要です。IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   5. Save をクリックします。

手順

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. Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
6. Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。

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

   MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。

   プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。

8. このページの Settings セクションで、以下の項目を確認します。

   • Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。プロバイダーのデフォルトの転送ネットワークです。転送ネットワークが選択したターゲット namespace にあることを確認します。

     • 転送ネットワークを編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • リストから別の転送ネットワークを選択します。
       • Save をクリックします。

     • オプション: OpenShift Web コンソールで OpenShift ネットワークを設定するには、Networking > NetworkAttachmentDefinitions をクリックします。

       OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。

     • オプション: OpenShift 転送ネットワークの最大転送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。

   • Target namespace: 移行されたすべての仮想マシンの宛先 namespace。デフォルトでは、宛先 namespace は現在の、またはアクティブな namespace です。

     • namespace を編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • 開いたウィンドウのリストから別のターゲット namespace を選択します。
       • Save をクリックします。

9. 計画が有効な場合、以下のいずれかを実行できます。

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

手順

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

   Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。

2. 移行計画の横にある Start をクリックして移行を開始します。

3. 開いた確認ウィンドウで Start をクリックします。

   プランの Status が Running に変更され、移行の進捗が表示されます。

   警告

   移行の開始後に仮想マシンのスナップショットを作成しないでください。移行の開始後にスナップショットを作成すると、移行が失敗する可能性があります。

4. オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。

   • 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。

   • 右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。

     • 仮想マシンの名前
     • 移行の開始時間と終了時間
     • コピーされたデータ量

     • 仮想マシンの移行の進捗パイプライン

       警告

       データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。

5. オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。

   1. Virtual Machines タブをクリックします。

   2. 移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。

      仮想マシンの詳細が表示されます。

   3. Pods セクションの Pod links 列で、Logs リンクをクリックします。

      Logs タブが開きます。

      注記

      ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。

      • OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、virt-v2v は関係しないため、Pod は必要ありません。
      • Pod が作成されなかった。
      • Pod が削除された。
      • Pod を実行する前に移行に失敗した。
   4. Raw ログを表示するには、Raw リンクをクリックします。
   5. ログをダウンロードするには、Download リンクをクリックします。

手順

1. Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
2. 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
3. 1 つ以上の仮想マシンを選択し、Cancel をクリックします。

4. Yes, cancel をクリックしてキャンセルを確定します。

   Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. Open Virtual Appliance (OVA) をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前
   • URL: OVA を提供する NFS ファイル共有の URL

5. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

   注記

   エラーが発生したことを示すエラーメッセージが表示される場合があります。このメッセージは無視しても問題ありません。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. OpenShift Virtualization をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前
   • URL: API サーバーのエンドポイントの URL

   • Service account bearer token: cluster-admin 権限を持つサービスアカウントのトークン

     URL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

手順

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

2. 変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。

   Providers detail ページが表示されたら:

3. Networks タブをクリックします。
4. Set default transfer network をクリックします。
5. リストからデフォルトの転送ネットワークを選択し、Save をクリックします。

6. 次の手順を実行して、MTV 移行に使用するネットワーク内のゲートウェイを設定します。

   1. Red Hat OpenShift Web コンソールで、Networking > NetworkAttachmentDefinitions をクリックします。
   2. 適切なデフォルトの転送ネットワーク NAD を選択します。
   3. YAML タブをクリックします。

   4. 次の例のように、YAML の metadata:annotations セクションに forklift.konveyor.io/route を追加します。

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 1

      1

      インターフェイスの IP アドレスを、Dynamic Host Configuration Protocol (DHCP) から設定する、または静的に設定するには、NetworkAttachmentDefinition パラメーターが必要です。IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   5. Save をクリックします。

手順

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. Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
6. Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。

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

   MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。

   プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。

8. このページの Settings セクションで、以下の項目を確認します。

   • Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。プロバイダーのデフォルトの転送ネットワークです。転送ネットワークが選択したターゲット namespace にあることを確認します。

     • 転送ネットワークを編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • リストから別の転送ネットワークを選択します。
       • Save をクリックします。

     • オプション: OpenShift Web コンソールで OpenShift ネットワークを設定するには、Networking > NetworkAttachmentDefinitions をクリックします。

       OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。

     • オプション: OpenShift 転送ネットワークの最大転送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。

   • Target namespace: 移行されたすべての仮想マシンの宛先 namespace。デフォルトでは、宛先 namespace は現在の、またはアクティブな namespace です。

     • namespace を編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • 開いたウィンドウのリストから別のターゲット namespace を選択します。
       • Save をクリックします。

9. 計画が有効な場合、以下のいずれかを実行できます。

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

手順

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

   Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。

2. 移行計画の横にある Start をクリックして移行を開始します。

3. 開いた確認ウィンドウで Start をクリックします。

   プランの Status が Running に変更され、移行の進捗が表示されます。

   警告

   移行の開始後に仮想マシンのスナップショットを作成しないでください。移行の開始後にスナップショットを作成すると、移行が失敗する可能性があります。

4. オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。

   • 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。

   • 右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。

     • 仮想マシンの名前
     • 移行の開始時間と終了時間
     • コピーされたデータ量

     • 仮想マシンの移行の進捗パイプライン

       警告

       データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。

5. オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。

   1. Virtual Machines タブをクリックします。

   2. 移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。

      仮想マシンの詳細が表示されます。

   3. Pods セクションの Pod links 列で、Logs リンクをクリックします。

      Logs タブが開きます。

      注記

      ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。

      • OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、virt-v2v は関係しないため、Pod は必要ありません。
      • Pod が作成されなかった。
      • Pod が削除された。
      • Pod を実行する前に移行に失敗した。
   4. Raw ログを表示するには、Raw リンクをクリックします。
   5. ログをダウンロードするには、Download リンクをクリックします。

手順

1. Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
2. 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
3. 1 つ以上の仮想マシンを選択し、Cancel をクリックします。

4. Yes, cancel をクリックしてキャンセルを確定します。

   Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. OpenShift Virtualization をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前
   • URL: API サーバーのエンドポイントの URL

   • Service account bearer token: cluster-admin 権限を持つサービスアカウントのトークン

     URL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

8. オプション: プロバイダーの UI へのアクセスを追加します。

   1. Providers ページで、プロバイダーをクリックします。

      Provider details ページが開きます。

   2. External UI web link の下の Edit アイコンをクリックします。

   3. リンクを入力して Save をクリックします。

      注記

      リンクを入力しない場合、MTV によって正しいリンクの計算が試行されます。

      • MTV が成功した場合、フィールドのハイパーリンクの参照先が計算されたリンクになります。
      • MTV が成功しなかった場合、フィールドは空のままになります。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
2. Create Provider をクリックします。
3. OpenShift Virtualization をクリックします。

4. 次のフィールドを指定します。

   • Provider resource name: 移行元プロバイダーの名前
   • URL: API サーバーのエンドポイントの URL

   • Service account bearer token: cluster-admin 権限を持つサービスアカウントのトークン

     URL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。

5. CA 証明書を検証するには、以下のいずれかのオプションを選択します。

   • Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
   • Use the system CA certificate: システム CA 証明書を検証した後に移行します。

   • Skip certificate validation: CA 証明書を検証せずに移行します。

     1. カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
     2. システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
     3. 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。

6. オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。

   1. Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。

   2. 詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。

      確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。

7. プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。

   プロバイダーがプロバイダーのリストに表示されます。

手順

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

2. 変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。

   Providers detail ページが表示されたら:

3. Networks タブをクリックします。
4. Set default transfer network をクリックします。
5. リストからデフォルトの転送ネットワークを選択し、Save をクリックします。

6. 次の手順を実行して、MTV 移行に使用するネットワーク内のゲートウェイを設定します。

   1. Red Hat OpenShift Web コンソールで、Networking > NetworkAttachmentDefinitions をクリックします。
   2. 適切なデフォルトの転送ネットワーク NAD を選択します。
   3. YAML タブをクリックします。

   4. 次の例のように、YAML の metadata:annotations セクションに forklift.konveyor.io/route を追加します。

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 1

      1

      インターフェイスの IP アドレスを、Dynamic Host Configuration Protocol (DHCP) から設定する、または静的に設定するには、NetworkAttachmentDefinition パラメーターが必要です。IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   5. Save をクリックします。

手順

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. Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
6. Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。

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

   MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。

   プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。

8. このページの Settings セクションで、以下の項目を確認します。

   • Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。プロバイダーのデフォルトの転送ネットワークです。転送ネットワークが選択したターゲット namespace にあることを確認します。

     • 転送ネットワークを編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • リストから別の転送ネットワークを選択します。
       • Save をクリックします。

     • オプション: OpenShift Web コンソールで OpenShift ネットワークを設定するには、Networking > NetworkAttachmentDefinitions をクリックします。

       OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。

     • オプション: OpenShift 転送ネットワークの最大転送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。

   • Target namespace: 移行されたすべての仮想マシンの宛先 namespace。デフォルトでは、宛先 namespace は現在の、またはアクティブな namespace です。

     • namespace を編集するには、次の手順を実行します。

       • Edit アイコンをクリックします。
       • 開いたウィンドウのリストから別のターゲット namespace を選択します。
       • Save をクリックします。

9. 計画が有効な場合、以下のいずれかを実行できます。

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

手順

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

   Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。

2. 移行計画の横にある Start をクリックして移行を開始します。

3. 開いた確認ウィンドウで Start をクリックします。

   プランの Status が Running に変更され、移行の進捗が表示されます。

   警告

   移行の開始後に仮想マシンのスナップショットを作成しないでください。移行の開始後にスナップショットを作成すると、移行が失敗する可能性があります。

4. オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。

   • 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。

   • 右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。

     • 仮想マシンの名前
     • 移行の開始時間と終了時間
     • コピーされたデータ量

     • 仮想マシンの移行の進捗パイプライン

       警告

       データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。

5. オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。

   1. Virtual Machines タブをクリックします。

   2. 移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。

      仮想マシンの詳細が表示されます。

   3. Pods セクションの Pod links 列で、Logs リンクをクリックします。

      Logs タブが開きます。

      注記

      ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。

      • OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、virt-v2v は関係しないため、Pod は必要ありません。
      • Pod が作成されなかった。
      • Pod が削除された。
      • Pod を実行する前に移行に失敗した。
   4. Raw ログを表示するには、Raw リンクをクリックします。
   5. ログをダウンロードするには、Download リンクをクリックします。

手順

1. Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
2. 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
3. 1 つ以上の仮想マシンを選択し、Cancel をクリックします。

4. Yes, cancel をクリックしてキャンセルを確定します。

   Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。

手順

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

   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

   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

   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

   1

   許可される値は pod、multus、および ignore です。この移行では、このネットワークに仮想マシンをアタッチするのを避けるために、ignored を使用します。

   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

   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/kubev2v/hook-runner
     serviceAccount:<service account> 1
     playbook: |
       LS0tCi0gbm... 2
   EOF

   1

   オプション：Red Hat OpenShift サービスアカウントserviceAccount パラメーターを使用して、クラスターリソースを変更します。

   2

   Base64 でエンコードされた Ansible Playbook。Playbook を指定する場合、image には ansible-runner が含まれている必要があります。

   注記

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

7. 次のコマンドを入力して、MTV 移行に使用される転送ネットワークのネットワーク接続定義 (NAD) を作成します。

   この定義を使用して、Dynamic Host Configuration Protocol (DHCP) から、または静的に、インターフェイスの IP アドレスを設定します。

   IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   $ oc edit NetworkAttachmentDefinitions <name_of_the_NAD_to_edit>
   apiVersion: k8s.cni.cncf.io/v1
   kind: NetworkAttachmentDefinition
   metadata:
     name: <name_of_transfer_network>
     namespace: <namespace>
     annotations:
       forklift.konveyor.io/route: <IP_address>

8. 移行の 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>
     preserveStaticIPs: 8
     networkNameTemplate: <network_interface_template> 9
     pvcNameTemplate: <pvc_name_template> 10
     pvcNameTemplateUseGenerateName: true 11
     targetNamespace: <target_namespace>
     volumeNameTemplate: <volume_name_template> 12
     vms: 13
       - id: <source_vm1> 14
       - name: <source_vm2>
         networkNameTemplate: <network_interface_template_for_this_vm> 15
         pvcNameTemplate: <pvc_name_template_for_this_vm> 16
         volumeNameTemplate: <volume_name_template_for_this_vm> 17
         targetName: <target_name> 18
         hooks: 19
           - hook:
               namespace: <namespace>
               name: <hook> 20
             step: <step> 21
   
   EOF

   1

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

   2

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

   3

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

   4

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

   5

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

   6

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

   7

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

   8

   デフォルトでは、仮想ネットワークインターフェイスコントローラー (vNIC) は移行プロセス中に変更されます。その結果、ゲスト仮想マシンのインターフェイス名にリンクされた静的 IP アドレスで設定された vNIC は、IP アドレスを失います。
   これを回避するには、preserveStaticIPs を true に設定します。MTV は、vNIC プロパティーが欠落している仮想マシンに関する警告メッセージを発行します。不足している vNIC プロパティーを取得するには、vSphere で該当する仮想マシンを実行して、vNIC プロパティーが MTV に報告されるようにします。

   9

   オプション。計画に含まれる仮想マシンのネットワークインターフェイス名のテンプレートを指定します。テンプレートは Go テンプレート構文に準拠し、次の変数にアクセスできます。

   • .NetworkName: ターゲットネットワークが multus の場合は、Multus ネットワーク接続定義の名前を追加します。それ以外の場合は、この変数を空のままにします。
   • .NetworkNamespace: ターゲットネットワークが multus の場合、Multus ネットワーク接続定義が配置されている namespace を追加します。
   • .NetworkType: ネットワークタイプを指定します。オプション: multus または pod。

   • .NetworkIndex: ネットワークインターフェイスの連続インデックス (0-based)。

     例

   • "net-{{.NetworkIndex}}"

   • {{if eq .NetworkType "pod"}}pod{{else}}multus-{{.NetworkIndex}}{{end}}"

     変数名は 63 文字以内でなければなりません。このルールは、ネットワーク名ネットワークテンプレート、PVC 名テンプレート、仮想マシン名テンプレート、およびボリューム名テンプレートに適用されます。

   10

   オプション。計画の永続ボリューム要求 (PVC) 名のテンプレートを指定します。テンプレートは Go テンプレート構文に準拠し、次の変数にアクセスできます。

   • .VnName: 仮想マシンの名前。
   • .PlanName: 移行計画の名前。
   • .DiskIndex: ディスクの初期ボリュームインデックス。
   • .RootDiskIndex: ルートディスクのインデックス。

   • . shared : オプション： true （共有ボリュームの場合）、false （共有ボリューム）です。

     例

   • "{{.VmName}}-disk-{{.DiskIndex}}"
   • "{{if eq .DiskIndex .RootDiskIndex}}root{{else}}data{{end}}-{{.DiskIndex}}"
   • "{{if .Shared}}shared-{{end}}{{.VmName}}-{{.DiskIndex}}"

   11

   オプション:

   • true に設定すると、すべての PVC の名前が一意になるように、MTV によってランダムに生成された 1 つ以上の英数字が PVC の名前に追加されます。

   • false に設定すると、pvcNameTemplate を指定しても、そのような文字が MTV によって PVC の名前に追加されることはありません。

     警告

     pvcNameTemplateUseGenerateName を false に設定すると、生成された PVC 名が一意でなくなり、競合が発生する可能性があります。

   12

   オプション: 計画に含まれる仮想マシンのボリュームインターフェイス名のテンプレートを指定します。テンプレートは Go テンプレート構文に準拠し、次の変数にアクセスできます。

   • .PVCName: このボリュームを使用して仮想マシンにマウントされた PVC の名前。

   • .VolumeIndex: ボリュームインターフェイスの連続インデックス (0-based)。

     例

   • "disk-{{.VolumeIndex}}"
   • "pvc-{{.PVCName}}"

   13

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

   14

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

   15

   オプション: 特定の仮想マシンのネットワークインターフェイス名を指定します。spec:networkNameTemplate で設定された値をオーバーライドします。変数と例は callout 9 と同じです。

   16

   オプション: 特定の仮想マシンの PVC 名を指定します。spec:pvcNameTemplate で設定された値をオーバーライドします。変数と例は callout 10 と同じです。

   17

   オプション: 特定の仮想マシンのボリューム名を指定します。spec:volumeNameTemplate で設定された値をオーバーライドします。変数と例は callout 12 と同じです。

   18

   オプション: MTV はターゲット仮想マシンの名前を自動的に生成します。この名前は、このパラメーターを使用して新しい名前を入力すると、オーバーライドできます。入力する名前は一意であり、有効な Kubernetes サブドメインである必要があります。そうでない場合、移行が自動的に失敗します。

   19

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

   20

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

   21

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

   重要

   VMware 7 仮想マシンを CentOS 7.9 を使用する OpenShift 4.13+ プラットフォームに移行すると、ネットワークインターフェイスの名前が変更され、仮想マシンの静的 IP 設定が機能しなくなります。

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

   注記

   カットオーバー時間を指定する場合は、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

   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

   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

   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

   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/kubev2v/hook-runner
     serviceAccount:<service account> 1
     playbook: |
       LS0tCi0gbm... 2
   EOF

   1

   オプション：Red Hat OpenShift サービスアカウントserviceAccount パラメーターを使用して、クラスターリソースを変更します。

   2

   Base64 でエンコードされた Ansible Playbook。Playbook を指定する場合、image には ansible-runner が含まれている必要があります。

   注記

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

6. 次のコマンドを入力して、MTV 移行に使用される転送ネットワークのネットワーク接続定義 (NAD) を作成します。

   この定義を使用して、Dynamic Host Configuration Protocol (DHCP) から、または静的に、インターフェイスの IP アドレスを設定します。

   IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   $ oc edit NetworkAttachmentDefinitions <name_of_the_NAD_to_edit>
   apiVersion: k8s.cni.cncf.io/v1
   kind: NetworkAttachmentDefinition
   metadata:
     name: <name_of_transfer_network>
     namespace: <namespace>
     annotations:
       forklift.konveyor.io/route: <IP_address>

7. 移行の 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_vm1> 10
       - name: <source_vm2>
         hooks: 11
           - hook:
               namespace: <namespace>
               name: <hook> 12
             step: <step> 13
   EOF

   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 モデルで設定されます。

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

   注記

   カットオーバー時間を指定する場合は、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

   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

   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

   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

   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/kubev2v/hook-runner
     serviceAccount:<service account> 1
     playbook: |
       LS0tCi0gbm... 2
   EOF

   1

   オプション：Red Hat OpenShift サービスアカウントserviceAccount パラメーターを使用して、クラスターリソースを変更します。

   2

   Base64 でエンコードされた Ansible Playbook。Playbook を指定する場合、image には ansible-runner が含まれている必要があります。

   注記

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

6. 次のコマンドを入力して、MTV 移行に使用される転送ネットワークのネットワーク接続定義 (NAD) を作成します。

   この定義を使用して、Dynamic Host Configuration Protocol (DHCP) から、または静的に、インターフェイスの IP アドレスを設定します。

   IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   $ oc edit NetworkAttachmentDefinitions <name_of_the_NAD_to_edit>
   apiVersion: k8s.cni.cncf.io/v1
   kind: NetworkAttachmentDefinition
   metadata:
     name: <name_of_transfer_network>
     namespace: <namespace>
     annotations:
       forklift.konveyor.io/route: <IP_address>

7. 移行の 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_vm1> 8
       - name: <source_vm2>
         hooks: 9
           - hook:
               namespace: <namespace>
               name: <hook> 10
             step: <step> 11
   EOF

   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 です。

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

   注記

   カットオーバー時間を指定する場合は、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

   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

   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

   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

   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/kubev2v/hook-runner
     serviceAccount:<service account> 1
     playbook: |
       LS0tCi0gbm... 2
   EOF

   1

   オプション：Red Hat OpenShift サービスアカウントserviceAccount パラメーターを使用して、クラスターリソースを変更します。

   2

   Base64 でエンコードされた Ansible Playbook。Playbook を指定する場合、image には ansible-runner が含まれている必要があります。

   注記

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

6. 次のコマンドを入力して、MTV 移行に使用される転送ネットワークのネットワーク接続定義 (NAD) を作成します。

   この定義を使用して、Dynamic Host Configuration Protocol (DHCP) から、または静的に、インターフェイスの IP アドレスを設定します。

   IP アドレスを設定すると、インターフェイスが設定されたゲートウェイに到達できるようになります。

   $ oc edit NetworkAttachmentDefinitions <name_of_the_NAD_to_edit>
   apiVersion: k8s.cni.cncf.io/v1
   kind: NetworkAttachmentDefinition
   metadata:
     name: <name_of_transfer_network>
     namespace: <namespace>
     annotations:
       forklift.konveyor.io/route: <IP_address>

7. 移行の 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_vm1> 8
       - name: <source_vm2>
         hooks: 9
           - hook:
               namespace: <namespace>
               name: <hook> 10
             step: <step> 11
   EOF

   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 です。

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

   注記

   カットオーバー時間を指定する場合は、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

   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

   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

   1

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

   2

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

   3

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