评估和迁移

本文档介绍如何对现有 Cloud Foundry (CF) Foundation 执行评估，以及如何将 CF Foundation、组织、空间或应用迁移到 Kf。

迁移拟合评估

使用 kf migrate scan-cf-cluster 命令生成包含 CF Foundation 迁移就绪性评估的报告。您可以将报告的格式设置为电子表格（推荐）或文本文件。

前提条件

  • Kf CLI。如需了解安装说明，请参阅安装 Kf CLI。
  • cf CLI 安装为 cf。
  • cf CLI 必须位于相应路径上。
  • 必须使用 CF Foundation 的管理员只读权限或更高级别的权限对 cf CLI 进行身份验证。

执行评估

  1. 验证要对其执行评估的 Foundation。

    cf curl /v2/info

  2. 运行该命令可生成包含评估报告的电子表格。

    kf migrate scan-cf-cluster report.xlsx

  3. 查看评估。

    如果您打算共享评估，则可以隐去不想共享的任何信息。

迁移

执行以下步骤来从 CF 迁移实体：

  1. 创建迁移计划以描述迁移过程。

  2. 修改迁移计划以自定义迁移。

  3. 应用迁移计划以执行迁移。

下面几个部分将详细介绍这些步骤。

迁移范围

执行迁移时，您所做的第一个决策便是确定迁移范围。该范围决定了您要迁移的 CF 实体以及执行迁移所需的权限：

  • 整个 Foundation 或组织：您必须拥有 CF Foundation 的管理员只读权限或更高级别的权限。

  • 单个空间或应用：您必须拥有空间开发者权限或更高级别的权限。

前提条件

如需执行迁移，您需要：

  • 创建迁移计划：Kf CLI。如需了解安装说明，请参阅安装 Kf CLI。
  • 应用迁移计划：运行 Kf 的 GKE 集群。如需了解安装说明，请参阅安装 Kf。
  • 拥有对已安装 Cloud Foundry 的集群的访问权限。
  • 以 CF Foundation 为目标的 CF CLI。
  • 所需迁移范围必须具备的 CF Foundation 权限，如上所示。

创建迁移计划

使用 kf migrate plan 命令创建迁移计划。

默认情况下，该命令会将迁移计划写入标准输出。您通常会将输出重定向到 yaml 文件，以便在应用计划之前对其进行自定义。例如，以下命令会将输出写入标准输出：

kf migrate plan

将输出重定向到 yaml 文件：

kf migrate plan > plan.yaml

运行 kf migrate plan 命令时，您应该会在命令窗口中看到以下形式的输出，其中列出了该命令执行的步骤以及任何警告或迁移问题：

kf migrate plan > plan.yaml

    Checking CF CLI is available
    Checking CF CLI is authenticated
    ...

    WARNING: plan has issues
    Issues with domain "apps.internal" in space "kf-team-acceptance":
        E04 - internal domains are not supported

    Issues with application "spring-music" in space "kf-team-app":
        E14 - app manifest must have a single process

    Issues with service instance "logspinner-1" in space "kf-team-app":
        E10 - syslog drain configuration is not supported
    ...

如需生成迁移计划，请执行以下操作：

  1. 确保您已使用 CF CLI 登录 CF Foundation。

  2. 根据所需的迁移范围执行迁移，其中：

    • MY_ORG 指定组织的名称。
    • MY_SPACE 指定空间的名称。
    • MY_APP 指定应用的名称。

    1. 为整个 CF Foundation 生成迁移计划。

      kf migrate plan > plan.yaml

    2. 为组织生成迁移计划。

      kf migrate plan --cf-org MY_ORG > plan.yaml

    3. 为空间生成迁移计划

      kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE > plan.yaml

    4. 为应用生成迁移计划。

      kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE --cf-app MY_APP > plan.yaml

如果您在运行上述任一命令后看到以下错误：

You are not authorized to perform the requested action CF-NotAuthorized 10003

则表示您没有读取必要的 CAPI 端点所需的权限。

修改迁移计划

查看并视需要修改生成的迁移计划以解决出现的任何错误。

应用迁移计划

使用 kf migrate apply 命令应用迁移计划并迁移 CF 实体。

如需应用迁移，请执行以下操作：

  1. 确保您已设置 .kubeconfig 以定位 Kf 集群。

  2. 确保您有权访问运行完整 Kf 安装的 GKE 集群。这意味着您已运行以下命令连接到集群：

    gcloud container clusters get-credentials CLUSTER_NAME \
   --project=CLUSTER_PROJECT_ID \
   --zone=CLUSTER_LOCATION

  3. 确保 Kf 集群上没有将与迁移计划中引用的空间发生冲突的现有空间名称。

    空间名称的格式为 cf-org-cf-space。例如，如果组织名称为 myorg，空间名称为 myspace，则 Kf 空间将为 myorg-myspace。

  4. 应用迁移计划。

    kf migrate apply -v --plan plan.yaml

    建议使用详细标志 -v，但不强制要求。此标志会使该命令输出用于执行迁移的 Kf 命令。