12.4. 在 MTV 迁移计划中添加 hook

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Plans for virtualization，然后点击您要将 hook 添加到的迁移计划。
2. 点 Hook。

3. 对于 pre-migration hook，请执行以下步骤：

   1. 在 Pre migration hook 部分中，将 Enable hook 开关切换为 Enable pre migration hook。
   2. 输入 Hook 运行程序镜像。如果要指定 spec.playbook，则需要使用具有 ansible-runner 的镜像。
   3. 将 hook 粘贴到 Ansible playbook 文本框中的 YAML 文件。

4. 对于迁移后 hook，请执行以下步骤：

   1. 在 Post migration hook 中，切换 Enable hook 开关 启用后迁移 hook。
   2. 输入 Hook 运行程序镜像。如果要指定 spec.playbook，则需要使用具有 ansible-runner 的镜像。
   3. 将 hook 粘贴到 Ansible playbook 文本框中的 YAML 文件。
5. 在选项卡的顶部，单击 Update hook。

6. 在终端中，输入以下命令将每个 hook 与 Red Hat OpenShift 服务帐户关联：

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

流程

1. 如果需要，为虚拟机创建一个具有 SSH 私钥的 Secret。

   1. 选择现有密钥或生成密钥对。
   2. 在虚拟机上安装公钥。

   3. 将 Secret 中的私钥编码为 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，镜像 必须包含 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，可在迁移前运行 hook，以及 PostHook 以在迁移后运行 hook。