Implementa una app de Kubernetes con desarrollo remoto

Implementa una app de Kubernetes con desarrollo remoto

En esta página, se muestra cómo comenzar a usar Cloud Code para VS Code con rapidez mediante un entorno de desarrollo remoto en Cloud Shell.

En esta guía de inicio rápido, omitirás la configuración y clonarás un proyecto en tu lugar de trabajo de desarrollo remoto con un clic, crearás un clúster, ejecutarás una app de Kubernetes en él, depurarás el código en ejecución, verás los registros de tu aplicación activa y conectarás una terminal a tu contenedor en ejecución.

Nota: Para conocer los pasos para configurar la depuración remota en el Sistema operativo Chrome, consulta Crea un flujo de trabajo de desarrollo con Cloud Code en una Pixelbook.

Antes de comenzar

Para configurar los recursos de asistencia y acceder a Cloud Shell, el entorno de desarrollo remoto en que usas en esta guía de inicio rápido, Google Cloud dentro de VS Code, completa los siguientes pasos:

Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. Si aún no lo hiciste, instala Visual Studio Code en tu máquina.
2. Instala la Remote - SSH extensión de Visual Studio Code.
3. Instala Git. Se requiere Git para copiar muestras en tu máquina.
4. Instala el complemento de Cloud Code si aún no lo hiciste.

Inicia Cloud Code

Cuando abres Visual Studio Code conectado a un entorno de desarrollo remoto en Cloud Shell, el entorno tiene todas las herramientas que necesitas para desarrollar aplicaciones de Kubernetes.

1. Para comenzar a trabajar en tu lugar de trabajo de desarrollo remoto, elige el lenguaje que prefieras para el proyecto clonado y, luego, haz clic en el botón Abrir con Cloud Code:

   Node.js

   Abrir con Cloud Code

   Java

   Abrir con Cloud Code

   Python

   Abrir con Cloud Code

   Comienza a usarlo

   Abrir con Cloud Code

   VS Code se inicia y clona un proyecto en tu lugar de trabajo de desarrollo remoto.

2. Si aún no estableciste los requisitos previos, se te solicitará que los instales.

Crea un clúster de GKE

Para crear un clúster estándar de Google Kubernetes Engine (GKE), sigue estos pasos:

1. Haz clic en Cloud Code y expande la sección Kubernetes.

2. Haz clic en add Agregar un clúster a KubeConfig y, luego, en Google Kubernetes Engine en el menú Selección rápida.

3. Cuando se te solicite habilitar la API de Container, selecciona Sí.

4. Haz clic en + Crear un clúster nuevo de GKE.

5. Elige Estándar como el tipo de clúster.

6. Haz clic en Abrir para permitir que Cloud Code abra la Google Cloud consola.

7. En la Google Cloud consola, asegúrate de que el proyecto seleccionado sea el que creaste o elegiste antes.

8. Establece el nombre del clúster como my-first-cluster.

9. Selecciona Zonal como el tipo de ubicación y establece la zona en us-central1-a.

10. Haz clic en Crear. La creación del clúster tarda unos minutos.

11. Después de crear el clúster, vuelve a hacer clic en Agregar un clúster a KubeConfig y selecciona de la lista el clúster que acabas de crear.

12. El clúster nuevo se agrega a la configuración y se configura para ser el contexto activo.

Ejecuta y visualiza tu app

Ahora que ya tienes todo 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 casi 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 Ejecutar en Kubernetes. Cuando se te solicite de nuevo, selecciona Ejecutar en 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 creas 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.

5. Después de que tu aplicación se ejecute en Kubernetes, haz clic en la entrada Estado de la tarea Ejecutar en Kubernetes en la sección Sesiones de desarrollo. Se abrirá una ventana con una pestaña Salida que incluye la URL de tu aplicación. Para abrir esta URL, presiona Control (o Command en macOS) y haz clic en la dirección.

   También puedes encontrar tu aplicación en la descripción general de cargas de trabajo en la Google Cloud consola. Para obtener más información sobre tu aplicación en ejecución, incluida su dirección IP externa y número de puerto, haz clic en su nombre en la lista.

Sugerencias para solucionar problemas

Si usas un clúster preexistente, sigue estos pasos para establecer tu clúster como activo y obtener las credenciales del clúster:

1. En VS Code, haz clic en Cloud Code y expande la sección Kubernetes.

2. Haz clic con el botón derecho en el nombre del clúster y, luego, en Configurar como clúster activo.

Depurar tu app

Para depurar 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 Depurar en Kubernetes.

3. Si se te solicita, autentica tus credenciales para ejecutar y depurar una aplicación de forma local.

4. Si se te solicita, confirma si deseas usar el contexto del clúster actual o cambiar a uno que prefieras.

   En Cloud Code, se usa la configuración cloudcode.kubernetes en tu .vscode/launch.json archivo para ejecutar la aplicación y adjuntarle una sesión de depurador.

   Luego, Cloud Code compila tus contenedores, los envía al registro, aplica configuraciones de Kubernetes al clúster y muestra la dirección IP que puedes usar para explorar tu aplicación activa.

5. Antes de adjuntar la sesión del depurador, se te pedirá que confirmes o ingreses el directorio en el contenedor remoto en el que se encuentra el programa que deseas depurar (o presiona Esc para omitir la depuración del contenedor).

6. Para agregar una interrupción a la línea 9, abre src/app.js y, luego, haz clic en el margen del editor.

   Los círculos rellenos de color rojo indican las interrupciones activas, mientras que los círculos vacíos de color gris indican las interrupciones inhabilitadas. Para un control de interrupciones más preciso, puedes usar la sección de interrupciones en la vista de depuración de VS Code.

   

   Cada vez que envíes una solicitud nueva a tu aplicación, el depurador se detendrá en la primera interrupción activa.

   En el siguiente ejemplo, en Local en la sección Variables, observa que el valor de res._contentLength; para Hello, world! es 13.

   

7. Edita la cadena que se envía en la línea 8 a Hello, goodbye! y, luego, reinicia la acción Depurar en Kubernetes.

   Después de que se vuelva a compilar y a implementar la app, observa el valor actualizado de res._contentLength.

   

Después de que se inicia la sesión de depuración, el panel Sesiones de desarrollo muestra la vista de registro estructurado. Cuando comienza una tarea, 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 Sesión de desarrollo. El panel Salida muestra el paso en el resultado del registro.

Abre una terminal en tu contenedor

Para abrir una terminal en tu contenedor, sigue estas instrucciones:

1. Haz clic en Cloud Code y expande la sección Kubernetes.

2. Expande las siguientes secciones:

   • La sección de tu clúster preferido
   • La sección Espacios de nombres y, luego, la sección de tu espacio de nombres preferido
   • La sección Pods y, luego, la sección de tu pod preferido

   • La sección Contenedores

     

3. Haz clic con el botón derecho en el contenedor en el que deseas abrir una terminal y, luego, haz clic en Obtener terminal.

   Con esto se abrirá una terminal. Ahora tendrás acceso a una shell dentro del contenedor en ejecución.

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 deseas volver a usar el proyecto.

Para borrar el clúster, sigue estos pasos:

1. Haz clic en Cloud Code y, luego, expande el explorador de Kubernetes.
2. Mantén el puntero sobre el nombre del clúster y, luego, haz clic en open_in_new Abrir en la Google Cloud consola.
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 estas consecuencias:

• Se borra todo su contenido. 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 IDs personalizados de los proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID personalizado del proyecto que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto, en lugar de todo el proyecto.

Si planeas explorar varios instructivos, arquitecturas o guías de inicio rápido, reutilizar proyectos puede ser útil para no exceder los límites de cuota de los proyectos.

1. En la Google Cloud consola, ve a la página Administrar recursos.

   Ir a Administrar recursos

2. En la lista de proyectos, elige el proyecto que tú quieres borrar y haz clic en Borrar.
3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.

¿Qué sigue?

• Considera importar una aplicación existente a VS Code y configurar Cloud Code.
• Aborda la configuración más avanzada Google Cloud de Kubernetes con la asistencia de edición de YAML de Cloud Code.
• Descubre la asistencia para la depuración específica del lenguaje que proporciona Cloud Code.
• Acelera tu desarrollo con la sincronización de archivos y la recarga en caliente.
• Crea y configura un clúster de GKE
• Configura clústeres privados
• Para personalizar tu experiencia en Cloud Code, establece los parámetros de la configuración relevante.