1.8. 故障排除

流程

1. 获取 CR 名称：

   $ oc get <migration_cr> -n openshift-migration 1

   1

   指定迁移 CR，如 migmigration。

   输出结果类似以下：

   NAME                                   AGE
   88435fe0-c9f8-11e9-85e6-5d593ce65e10   6m42s

2. 查看 CR：

   $ oc describe <migration_cr> <88435fe0-c9f8-11e9-85e6-5d593ce65e10> -n openshift-migration

   输出结果类似以下示例。

流程

1. 登录到 CAM 控制台。
2. 点击 Plans 查看迁移计划列表。
3. 点击特定迁移计划 的 Options 菜单并选择 Logs。
4. 点 Download Logs 为所有集群下载迁移控制器、Velero 和 Restic 的日志。

5. 要下载特定的日志：

   1. 指定日志选项：

      • Cluster：选择源、目标或 CAM 主机集群。
      • Log source：选择 Velero、Restic 或 Controller。

      • Pod source：选择 Pod 名称，例如：controller-manager-78c469849c-v6wcf

        此时会显示所选日志。

        您可以通过更改您的选择来清除日志选择设置。

   2. 点 Download Selected 下载所选日志。

流程

1. 运行迁移计划

2. 查看 MigPlan CR:

   $ oc describe migplan <migplan_name> -n openshift-migration 1

   1

   指定迁移计划的名称。

   输出结果类似以下：

   metadata:
     ...
     uid: 79509e05-61d6-11e9-bc55-02ce4781844a 1
   status:
     ...
     conditions:
     - category: Warn
       lastTransitionTime: 2020-04-30T17:16:23Z
       message: 'Some namespaces contain GVKs incompatible with destination cluster.
         See: `incompatibleNamespaces` for details'
       status: "True"
       type: GVKsIncompatible
     incompatibleNamespaces:
     - gvks:
       - group: batch
         kind: cronjobs 2
         version: v2alpha1
       - group: batch
         kind: scheduledjobs 3
         version: v2alpha1

   1

   记录 MigPlan UID。

   2 3

   记录已弃用的 GVK。

3. 获取与 MigPlan UID 关联的 MigMigration 名称：

   $ oc get migmigration -o json | jq -r '.items[] | select(.metadata.ownerReferences[].uid=="<migplan_uid>") | .metadata.name' 1

   1

   指定 MigPlan UID。

4. 获取与 MigMigration 名称关联的 MigMigration UID:

   $ oc get migmigration <migmigration_name> -o jsonpath='{.metadata.uid}' 1

   1

   指定 MigMigration 名称。

5. 获取与 MigMigration UID 关联的 Velero 备份名称：

   $ oc get backup.velero.io --selector migration-initial-backup="<migmigration_uid>" -o jsonpath={.items[*].metadata.name} 1

   1

   指定 MigMigration UID。

6. 在您的本地机器中下载 Velero 备份内容：

   • 对于 AWS S3:

     $ aws s3 cp s3://<bucket_name>/velero/backups/<backup_name> <backup_local_dir> --recursive 1

     1

     指定存储桶、备份名称和您的本地备份目录名称。

   • 对于GCP：

     $ gsutil cp gs://<bucket_name>/velero/backups/<backup_name> <backup_local_dir> --recursive 1

     1

     指定存储桶、备份名称和您的本地备份目录名称。

   • 对于 Azure:

     $ azcopy copy 'https://velerobackups.blob.core.windows.net/velero/backups/<backup_name>' '<backup_local_dir>' --recursive 1

     1

     指定备份名称和您的本地备份目录名称。

7. 解压 Velero 备份归档文件：

   $ tar -xfv <backup_local_dir>/<backup_name>.tar.gz -C <backup_local_dir>

8. 在每个已弃用的 GVK 中以离线模式运行 oc convert:

   $ oc convert -f <backup_local_dir>/resources/<gvk>.yaml 1

   1

   指定已弃用的 GVK。

9. 在目标集群中创建转换的 GVK:

   $ oc create -f <gvk>.yaml 1

   1

   指定转换的 GVK。

流程

1. 在目标集群中，切换到迁移的项目：

   $ oc project <project>

2. 获取部署的资源：

   $ oc get all

3. 删除部署的资源以确保应用程序没有在目标集群中运行，并访问 PVC 上的数据：

   $ oc delete <resource_type>

4. 要停止 DaemonSet 而不删除它，在 YAML 文件中更新 nodeSelector ：

   apiVersion: apps/v1
   kind: DaemonSet
   metadata:
     name: hello-daemonset
   spec:
     selector:
         matchLabels:
           name: hello-daemonset
     template:
       metadata:
         labels:
           name: hello-daemonset
       spec:
         nodeSelector:
           role: worker 1

   1

   指定一个没有存在于任何节点上的nodeSelector 值。

5. 更新每个 PV 的重新声明策略，以便删除不必要的数据。在迁移过程中，绑定 PV 的重新声明策略是reclaim，以确保应用程序从源集群中被删除时不会丢失数据。您可以在回滚过程中删除这些 PV。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: pv0001
   spec:
     capacity:
       storage: 5Gi
     accessModes:
       - ReadWriteOnce
     persistentVolumeReclaimPolicy: Retain 1
     ...
   status:
     ...

   1

   指定 Recycle 或 Delete。

6. 在源集群中，切换到迁移的项目：

   $ oc project <project_name>

7. 获取项目部署的资源：

   $ oc get all

8. 启动每个部署资源的一个或多个副本：

   $ oc scale --replicas=1 <resource_type>/<resource_name>

9. 如果在操作中被更改了，把 DaemonSet 的 nodeSelector 改回其原始值。

流程

1. 进入要存储 must-gather 数据的目录。

2. 运行 oc adm must-gather 命令：

   $ oc adm must-gather --image=registry.redhat.io/rhcam-1-2/openshift-migration-must-gather-rhel8

   must-gather 工具程序收集集群数据，并把它保存在 must-gather.local.<uid> 目录中。

3. 从 must-gather 数据中删除验证密钥和其他敏感信息。

4. 创建一个包含 must-gather.local.<uid> 目录内容的归档文件：

   $ tar cvaf must-gather.tar.gz must-gather.local.<uid>/

   在红帽客户门户中，为您的问题单附上这个压缩文件。