Evaluación y migración

En este documento, se describe cómo realizar una evaluación de la Fundación Cloud Foundry (CF) existente y cómo migrar la fundación, la organización, el espacio o la app de CF a Kf.

Evaluación de idoneidad para la migración

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

Requisitos previos

La CLI de Kf. Consulta Instala la CLI de Kf para obtener las instrucciones de instalación.
La CLI de cf se instaló como cf.
La CLI de cf que estará en tu ruta de acceso.
La CLI de cf debe autenticarse con privilegios de solo lectura de administrador o superior en la base de CF.

Realiza una evaluación

Valida la base a la que se orientará.
```
cf curl /v2/info
```
Ejecuta el comando para generar una hoja de cálculo que contenga el informe de evaluación.

Nota: La evaluación se ejecuta de forma local en tu estación de trabajo mediante la CLI de Kf y no se envían datos a Google.
```
kf migrate scan-cf-cluster report.xlsx
```
Revisa la evaluación.

Si planeas compartir la evaluación, puedes ocultar cualquier información que no desees compartir.

Migración

Sigue estos pasos para migrar entidades desde CF:

Crea un plan de migración que describa la migración.
Edita el plan de migración para personalizar la migración.
Aplica el plan de migración para realizar la migración.

En las siguientes secciones, se describen esos pasos con más detalle.

Permisos de migración

Tu primera decisión cuando realizas una migración es decidir sobre el permiso de la migración. El permiso determina la entidad de CF que deseas migrar y los privilegios que necesitas para realizar la migración:

Organización o fundación completa: Debes tener privilegios de solo lectura de administrador o una base superior en CF.
Espacio o app únicos: Debes tener privilegios de desarrollador de espacios o versiones posteriores.

Nota: Si tienes permisos scim.read y cloud_controller.admin_read_only, también puedes consultar todas las apps en todos los espacios de una organización.

Requisitos previos

Para realizar una migración, necesitarás lo siguiente:

La CLI de Kf para crear el plan de migración. Consulta Instala la CLI de Kf para obtener las instrucciones de instalación.
Un clúster de GKE que ejecuta Kf para aplicar el plan de migración. Consulta Instala Kf para obtener instrucciones de instalación.
Acceso a un clúster con la instalación de Cloud Foundry.
CLI de CF orientada a la Fundación de CF.
Los privilegios en la Fundación de CF que requiere tu permiso de migración deseado, como se muestra arriba.

Crea 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 salida estándar. Por lo general, debes redireccionar el resultado a un archivo yaml para que puedas personalizar el plan antes de aplicarlo. Por ejemplo, el siguiente comando escribe el resultado en la salida estándar:

kf migrate plan

Redirecciona el resultado a un archivo yaml:

kf migrate plan > plan.yaml

Cuando ejecutes el comando kf migrate plan, deberías ver un resultado en la ventana del comando con el siguiente formato en el que se enumeran los pasos que realizó el comando y cualquier problema de advertencia o migración:

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, haz lo siguiente:

Asegúrate de haber accedido a la Fundación de CF mediante la CLI de CF.
Realiza la migración en función del permiso de migración que desees, en el que:
- MY_ORG especifica el nombre de la organización.
- MY_SPACE especifica el nombre del espacio.
- MY_APP especifica el nombre de la app.
1. Genera un plan de migración para una Fundación de CF completa.
```
kf migrate plan > plan.yaml
```
2. Genera un plan de migración para una organización.
```
kf migrate plan --cf-org MY_ORG > plan.yaml
```
3. Genera 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 app.
```
kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE --cf-app MY_APP > plan.yaml
```

Si ves el siguiente error después de ejecutar alguno de estos comandos, ejecuta el siguiente comando:

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

No tienes los privilegios necesarios para leer los extremos de CAPI necesarios.

Edita el plan de migración

Revisa y, de manera opcional, modifica el plan de migración generado para resolver cualquier error.

Aplica 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, sigue estos pasos:

Asegúrate de haber configurado .kubeconfig para orientar el clúster de Kf.
Asegúrate de tener acceso a un clúster de GKE que ejecute una instalación de Kf completa. Esto significa que ejecutaste el siguiente comando para conectarte al clúster:
```
gcloud container clusters get-credentials CLUSTER_NAME \
   --project=CLUSTER_PROJECT_ID \
   --zone=CLUSTER_LOCATION
```
Asegúrate de que no haya nombres de espacios en tu clúster de Kf que choquen 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.
Aplica el plan de migración.
```
kf migrate apply -v --plan plan.yaml
```
Se recomienda la marca de verbosidad -v, pero no es obligatoria. Esta marca hace que el comando genere los comandos de Kf que se usaron para realizar la migración.

Nota: Es posible que veas errores del paso de aplicación. Por ejemplo, E04 - internal domains are not supported. En algunos casos, puedes ignorar estos errores si especificas la marca --allow-issues. De forma alternativa, puedes editar el plan de migración para abordar el error.