Evaluación y migración

En este documento se describe cómo evaluar tu Foundation de Cloud Foundry (CF) y cómo migrar la Foundation, la organización, el espacio o la aplicación de CF a Kf.

Evaluación de la idoneidad de la migración

Usa el comando kf migrate scan-cf-cluster para generar un informe que contenga una evaluación de la preparación para la migración de una fundación de CF. Puedes darle formato de hoja de cálculo (opción recomendada) o de archivo de texto.

Requisitos previos

Realizar una evaluación

  1. Valida la base que se va a segmentar.

    cf curl /v2/info

  2. Ejecuta el comando para generar una hoja de cálculo que contenga el informe de evaluación.

    kf migrate scan-cf-cluster report.xlsx

  3. Revisa la evaluación.

    Si tienes previsto compartir la evaluación, puedes ocultar la información que no quieras compartir.

Migración

Sigue estos pasos para migrar entidades de CF:

  1. Crea un plan de migración que describa la migración.

  2. Edita el plan de migración para personalizar la migración.

  3. Aplica el plan de migración para llevar a cabo la migración.

En las siguientes secciones se describen estos pasos en detalle.

Ámbitos de migración

Lo primero que debes decidir al realizar una migración es el ámbito de la migración. El ámbito determina la entidad de CF que quieres migrar y los privilegios que necesitas para llevar a cabo la migración:

  • Toda la fundación o la organización: debes tener privilegios de administrador de solo lectura o superiores en la Fundación CF.

  • Un solo espacio o aplicación: debes tener privilegios de desarrollador de espacio o superiores.

Requisitos previos

Para realizar una migración, necesitas lo siguiente:

  • Para crear el plan de migración: la CLI de Kf. Consulta las instrucciones de instalación en Instalar la CLI de Kf.
  • Para aplicar el plan de migración: un clúster de GKE que ejecute Kf. Consulta las instrucciones de instalación en Instalar Kf.
  • Acceso a un clúster con una instalación de Cloud Foundry.
  • CLI de CF que se ha orientado a la fundación de CF.
  • Los privilegios de la fundación CF que requiere el ámbito de migración que quieras, tal como se muestra arriba.

Crear un plan de migración

Usa el comando kf migrate plan para crear el plan de migración.

De forma predeterminada, el comando escribe el plan de migración en la salida estándar. Normalmente, se redirige la salida a un archivo YAML para poder personalizar el plan antes de aplicarlo. Por ejemplo, el siguiente comando escribe el resultado en la salida estándar:

kf migrate plan

Redirige el resultado a un archivo YAML:

kf migrate plan > plan.yaml

Cuando ejecutes el comando kf migrate plan, deberías ver en la ventana de comandos una salida con el formato que se muestra a continuación, en la que se indican los pasos que ha realizado el comando y los problemas de migración o las advertencias:

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

Para generar un plan de migración, sigue estos pasos:

  1. Asegúrate de haber iniciado sesión en tu CF Foundation con la interfaz de línea de comandos de CF.

  2. Realiza la migración según el ámbito que quieras migrar.

    • MY_ORG especifica el nombre de la organización.
    • MY_SPACE especifica el nombre del espacio.
    • MY_APP especifica el nombre de la aplicación.

    1. Generar un plan de migración para toda una fundación de CF.

      kf migrate plan > plan.yaml

    2. Generar un plan de migración para una organización.

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

    3. Generar un plan de migración para un espacio

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

    4. Genera un plan de migración para una aplicación.

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

Si aparece el siguiente error después de ejecutar alguno de estos comandos:

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

No tienes los privilegios necesarios para leer los endpoints de la API CAPI.

Editar el plan de migración

Revisa y, si quieres, modifica el plan de migración generado para corregir los errores.

Aplicar el plan de migración

Usa el comando kf migrate apply para aplicar el plan de migración y migrar la entidad de CF.

Para aplicar una migración:

  1. Asegúrate de que has configurado .kubeconfig para orientar a tu clúster de Kf.

  2. Asegúrate de que tienes acceso a un clúster de GKE que ejecute una instalación completa de Kf. Esto significa que has ejecutado el siguiente comando para conectarte al clúster:

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

  3. Asegúrate de que no haya nombres de espacios en tu clúster de Kf que coincidan con un espacio al que se haga referencia en el plan de migración.

    Los nombres de los espacios tienen el formato cf-org-cf-space. Por ejemplo, si el nombre de la organización es myorg y el nombre del espacio es myspace, el espacio de Kf será myorg-myspace.

  4. Aplica el plan de migración.

    kf migrate apply -v --plan plan.yaml

    Se recomienda usar la marca detallada -v, pero no es obligatorio. Esta marca hace que el comando muestre los comandos de Kf que se han usado para realizar la migración.