12.4. MTV 移行計画へのフックの追加

手順

1. Red Hat OpenShift Web コンソールで、Migration > Plans for virtualization をクリックし、フックを追加する移行計画をクリックします。
2. Hooks をクリックします。

3. 移行前のフックの場合は、以下の手順を実行します。

   1. Pre migration hook セクションで、Enable hook スイッチを Enable pre migration hook に切り替えます。
   2. Hook ランナーイメージ を入力します。spec.playbook を指定する場合は、ansible-runner が含まれるイメージを使用する必要があります。
   3. Ansible Playbook テキストボックスにフックを YAML ファイルとして貼り付けます。

4. 移行後のフックの場合は、以下の手順を実行します。

   1. Post migration hook で、Enable hook を Enable post migration hook に切り替えます。
   2. Hook ランナーイメージ を入力します。spec.playbook を指定する場合は、ansible-runner が含まれるイメージを使用する必要があります。
   3. Ansible Playbook テキストボックスにフックを YAML ファイルとして貼り付けます。
5. タブの上部にある Update hooks をクリックします。

6. ターミナルで以下のコマンドを実行し、各フックを Red Hat OpenShift サービスアカウントに関連付けます。

   $ oc -n openshift-mtv patch hook <name_of_hook> \
     -p '{"spec":{"serviceAccount":"<service_account>"}}' --type merge

手順

1. 必要に応じて、仮想マシンの SSH 秘密鍵でシークレットを作成します。

   1. 既存のキーを選択するか、キーペアを生成します。
   2. 仮想マシンに公開鍵をインストールします。

   3. シークレット内の秘密鍵を base64 でエンコードします。

      apiVersion: v1
      data:
        key: VGhpcyB3YXMgZ2Vu...
      kind: Secret
      metadata:
        name: ssh-credentials
        namespace: openshift-mtv
      type: Opaque

2. ファイルを連結し、Base64 エンコード用にパイプすることで、Playbook をエンコードします。次に例を示します。

   $ cat playbook.yml | base64 -w0

3. Hook 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 を指定する必要はありません。

   注記

   アタッチされた Playbook をデコードするには、カスタム出力でリソースを取得して base64 にパイプします。以下に例を示します。

   $ oc get -n konveyor-forklift hook playbook -o \
       go-template='{{ .spec.playbook }}' | base64 -d

4. 移行の Plan CR で、仮想マシンごとに、CR の末尾に次のセクションを追加します。

     vms:
       - id: <vm_id>
         hooks:
           - hook:
               namespace: <namespace>
               name: <name_of_hook>
             step: <type_of_hook> 

   1

   1

   オプションは、移行前にフックを実行する PreHook と、移行後にフックを実行する PostHook です。