Cambia de plataforma las aplicaciones de Linux a contenedores

La integración de Migrate to Containers con Cloud Code te permite modernizar los componentes de la aplicación de Linux que se ejecutan en máquinas virtuales (VMs) y generar artefactos que se pueden implementar en Google Kubernetes Engine y Cloud Run, directamente en tu IDE, con una máquina Linux.

En esta guía, aprenderás a cambiar la plataforma de una aplicación existente a un contenedor de GKE con la extensión de Cloud Code en tu IDE en una máquina Linux.

Esta guía está dirigida a desarrolladores que usan una máquina Linux y que tienen conocimiento operativo de VS Code, están familiarizados con Google Cloudy tienen una VM que ejecuta el componente de su aplicación.

Nota: Para realizar los pasos de esta guía, debes usar una máquina Linux. Cloud Code no admite la migración de aplicaciones a contenedores con Windows o macOS.

Antes de comenzar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Google Kubernetes Engine API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Google Kubernetes Engine API.

   Enable the API

8. Instala la extensión de Cloud Code si aún no lo has hecho.
9. Crea y configura un clúster de GKE.
10. Asegúrate de saber qué tipo de migración quieres realizar. Para obtener más información sobre las cargas de trabajo compatibles, consulta Revisa las cargas de trabajo, el SO y las versiones de Kubernetes compatibles.
11. Prepara tus máquinas locales y de origen para la modernización. Cloud Code solo admite Linux para la modernización.

Agrega una fuente de cambio de plataforma

En esta sección, instalarás la CLI del cliente de descubrimiento de Migration Center (mcdc) y otras herramientas de Migrate to Containers en tu máquina local, si aún no lo has hecho, y agregarás una fuente de cambio de plataforma siguiendo estos pasos:

1. En la barra de actividades de tu IDE, haz clic en Cloud Code y, luego, expande el explorador de Replatform Apps.

2. Si es la primera vez que usas Migrate to Containers en Cloud Code, deberás instalar la CLI de mcdc y otras herramientas de Migrate to Containers en tu máquina local. Para ello, haz clic en Install tools. De lo contrario, continúa con el paso siguiente.

3. Haz clic en Editar fuentes. Se abrirá un archivo mcdc-sources.json vacío. Agrega tus fuentes en el siguiente formato:

   [
     {
       "title": "SOURCE_NAME",
       "host": "HOSTNAME",
       "user": "USER",
       "identityFile":"IDENTITY-FILE-PATH"
     }
   ]
   

   Nota: Puedes usar las mismas variables host, user y identityFile en un comando SSH.

4. Para ver las fuentes que aparecen en el explorador Replatform Apps, mantén el puntero sobre el explorador Replatform Apps y haz clic en el botón Reload sources almacenado en caché que aparece.

Opcional: Genera una evaluación de idoneidad

Antes de intentar cambiar la plataforma de tu aplicación a un contenedor, te recomendamos que generes una evaluación de ajuste de tu fuente, que te notificará si es capaz de cambiar la plataforma de un contenedor.

Para generar una evaluación de la idoneidad de tu fuente, haz clic con el botón derecho en ella y selecciona Evaluar fuente. Se abrirá la terminal en tu IDE y se mostrarán los registros de la evaluación de tu fuente.

Cuando se complete la evaluación, mcdc generará un informe de evaluación de ajuste en tu IDE.

Si se informa que tus fuentes son una Buena opción, puedes cambiar la plataforma de tu aplicación.

Cambia la plataforma de tu aplicación

Cloud Code crea un espacio de trabajo dedicado para cada migración de plataforma y te permite ejecutar las tareas Copiar, Analizar y Generar en el espacio de trabajo para automatizar los pasos de migración de plataforma. Si ejecutas la tarea Generate sin ejecutar primero las tareas Copy y Analyze, estas se ejecutarán automáticamente antes de generar artefactos.

En las siguientes secciones, se te guiará para realizar cada una de estas tareas y cambiar la plataforma de tu aplicación a un contenedor con Cloud Code.

Para obtener más información sobre el ciclo de vida de una migración, consulta Arquitectura de la CLI de Migrate to Containers.

Crea un nuevo lugar de trabajo de migración de plataforma

Antes de crear un nuevo lugar de trabajo de cambio de plataforma, deberás saber qué parámetros de migración debes seleccionar para tu tipo de migración. Para obtener más información sobre los parámetros de cada tipo de migración, consulta Crea un plan de migración.

Para crear un nuevo lugar de trabajo de cambio de plataforma con artefactos en tu IDE, sigue estos pasos:

1. En el explorador Replatform Apps, haz clic con el botón derecho en la fuente que deseas cambiar de plataforma y, luego, en Replatform.

2. En la lista de opciones que aparece en el menú, selecciona un recorrido de cambio de plataforma.

3. Selecciona un nuevo directorio de lugar de trabajo para cambiar la plataforma de tu aplicación, haz clic en Aceptar y, luego, en Create replatform workspace.

4. Selecciona los parámetros de migración para tu tipo de migración.

5. Opcional: Si seleccionaste el tipo de migración de WebSphere y deseas usar un escáner binario, selecciona el archivo binaryAppScanner.jar.

   La generación del lugar de trabajo tarda unos segundos. Se abrirá el directorio del nuevo espacio de trabajo en una ventana nueva del IDE.

Cómo copiar archivos de tu VM a tu lugar de trabajo

Para copiar los archivos de la VM a tu lugar de trabajo en el IDE, sigue estos pasos:

1. Opcional: La CLI de mcdc aplica filtros para reducir el tamaño de la copia, pero puedes modificar el archivo filters.txt para reducir aún más el tamaño de la copia. Para obtener información sobre cómo reducir el tamaño de la copia, consulta Reduce el tamaño del sistema de archivos copiado.

2. Presiona Ctrl + Mayúsculas + P para abrir la paleta de comandos.

3. Busca y selecciona Tasks: Run Task y, luego, m2c: Copy. La copia de archivos puede tardar unos minutos.

Analiza el sistema de archivos de la VM y genera un plan de migración

Para analizar el sistema de archivos de la VM y generar un plan de migración, sigue estos pasos:

1. Presiona Ctrl + Mayúsculas + P para abrir la paleta de comandos.

2. Busca y selecciona Tasks: Run Task y, luego, m2c: Analyze.

   Si la tarea de análisis falla, debes modificar los parámetros de migración a través del archivo analyze-args.ini. Este archivo tiene una línea por parámetro con documentación complementaria sobre el parámetro.

   Cuando el análisis se realiza correctamente, Cloud Code crea un directorio llamado migration-plan que contiene los resultados del análisis en forma de un archivo config.yaml. Puedes editar este archivo para cambiar la forma en que se generan los artefactos.

   La estructura del archivo config.yaml difiere según el tipo de migración. Para obtener más información sobre los tipos de migración compatibles, consulta las siguientes páginas:

   • VM de Linux
   • Servidores de Tomcat
   • Cargas de trabajo de WebSphere
   • Servidores JBoss
   • Servidores Apache
   • Sitios de WordPress

Generar artefactos

Para generar artefactos, debes ejecutar la tarea Generate en tu IDE. Si aún no ejecutaste las tareas Copy y Analyze en las secciones anteriores, la tarea Generate las ejecutará automáticamente antes de generar artefactos.

Para generar los artefactos, sigue estos pasos:

1. Presiona Ctrl + Mayúsculas + P para abrir la paleta de comandos.

2. Busca y selecciona Tasks: Run Task y, luego, m2c: Generate. Esto genera los artefactos en el directorio src, que contiene un archivo skaffold.yaml que se usa para compilar e implementar una imagen de contenedor. Cada tipo de migración genera artefactos diferentes, pero todos los tipos de migración suelen crear uno o más archivos Docker y una especificación de implementación de GKE a la que hace referencia skaffold.yaml.

   Cuando se complete la generación de artefactos, habrás terminado de cambiar la plataforma de tu aplicación.

3. Opcional: Si deseas modificar el plan de migración, edita el archivo config.yaml y vuelve a ejecutar la tarea m2c: Generate.

   De lo contrario, si estás conforme con los resultados de la migración de plataforma, puedes continuar para ejecutar tu aplicación en un contenedor de GKE.

Ejecuta tu aplicación en un contenedor de GKE

En esta sección, ejecutarás tu aplicación con la plataforma cambiada en un contenedor de GKE, verás los registros de la aplicación en ejecución y limpiarás los recursos.

Si aún no creaste ni configuraste un clúster de GKE, sigue las instrucciones en Crea y configura un clúster de GKE en Cloud Code para VS Code.

Para obtener más información sobre la depuración de aplicaciones de GKE, consulta Cómo depurar aplicaciones de Kubernetes con Cloud Code para VS Code.

Ejecuta y visualiza tu aplicación

Ahora que todo está configurado, puedes ejecutar tu aplicación y verla en vivo. Cloud Code inspecciona los cambios en tu sistema de archivos para que puedas editar y volver a ejecutar tu app en tiempo real.

Para ejecutar tu aplicación, sigue estos pasos:

1. En la barra de estado de Cloud Code, haz clic en el nombre del proyecto activo.

   

2. En el menú Selección rápida que aparece, selecciona Run on Kubernetes.

3. Confirma si deseas usar el contexto del clúster actual o cambiar a uno diferente.

4. Si se te solicita, elige un registro de imágenes para enviar las imágenes. Si vas a crear un registro de imágenes nuevo con gcr.io/PROJECT_ID, asegúrate de que el registro de imágenes esté en el mismo proyecto que tu clúster.

   Aparecerá una ventana de salida en la que podrás realizar un seguimiento del progreso de tu aplicación en ejecución. También verás una transmisión en vivo de los registros de los pods en ejecución en el resultado de la terminal.

5. Una vez que tu aplicación se ejecuta en Kubernetes, la ventana de resultados muestra una dirección IP. Para usar esta dirección IP vinculada y acceder a tu aplicación, presiona Ctrl y haz clic en la dirección.

Una vez que se inicia la sesión de depuración, el panel Sesiones de desarrollo muestra la vista de registro estructurado. Cuando comienza una tarea, esta aparece con un semicírculo giratorio progress_activity.

Si una tarea se realiza correctamente, aparecerá una marca de verificación check_circle junto al paso.

Para ver los detalles de un paso, haz clic en él en el panel Sessión de desarrollo. En el panel Salida, se muestra el paso en el resultado de registro.

Limpia

Después de detener la aplicación, todos los recursos de Kubernetes que implementaste durante la ejecución se borran de forma automática.

Para evitar que se apliquen cargos en tu cuenta por otros recursos que usaste en esta guía de inicio rápido, asegúrate de borrar el proyecto o el clúster que creaste si quieres volver a usarlo.

Para borrar el clúster, sigue estos pasos:

1. Haz clic en Cloud Code y, luego, expande el explorador de Kubernetes.
2. Coloca el puntero sobre el nombre de tu clúster y, luego, haz clic en open_in_new Abrir en la consola de Google Cloud.
3. Haz clic en Borrar y, luego, en Borrar.

Para borrar tu proyecto (y los recursos asociados, incluidos los clústeres), sigue estos pasos:

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• Se borra todo en el proyecto. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varias infraestructuras, instructivos y guías de inicio rápido la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Para borrar todos los archivos locales que se crearon durante el proceso de cambio de plataforma, haz lo siguiente:

1. Abre la paleta de comandos (Ctrl + Mayúsculas + P).
2. Busca y selecciona Tasks: Run Task y, luego, m2c: Cleanup.