Guía de inicio rápido: Ejecuta una app de Kubernetes con Cloud Code

En esta página, se muestra cómo comenzar a usar Cloud Code.

En esta guía de inicio rápido, configurarás una aplicación nueva de Kubernetes mediante una plantilla de inicio de Hello World, ejecutarás la app en un clúster que elijas, iniciarás la recompilación continua para desarrollar la app de forma iterativa y depurarás ejecutar código, relajarte y ver transmisiones de registros desde tu aplicación activa.

Antes de comenzar

Si deseas usar Google Cloud, deberás crear o seleccionar un proyecto de Google Cloud y habilitar la facturación en tu proyecto.

Como alternativa, puedes usar un clúster alojado en cualquier otra plataforma en la nube o un clúster de Kubernetes local con herramientas como minikube y Docker Desktop.

Instala el complemento

Para instalar el complemento de Cloud Code, haz lo siguiente:

  1. Instala la versión 2020.3 o posterior del IDE de JetBrains (como IntelliJ Ultimate/Comunidad, PyCharm Professional/Community), WebStorm, GoLand), si aún no lo has hecho.

  2. Si ejecutas Cloud Code en Apple Si-Series silicon, se te solicitará que instales Rosetta 2. Esto permite que Cloud Code instale kubectl como una dependencia administrada.

    Si prefieres no instalar Rosetta 2, desactiva las dependencias administradas (IntelliJ IDEA > Preferencias > Herramientas > Cloud Code.) > Dependencias) e instalar tu propia versión de ARM de kubectl como se describe en Versiones personalizadas de dependencias.

  3. Para todas las plataformas de nube, asegúrate de que el cliente Docker (autenticado con tu registro de Docker) esté instalado en la PATH de tu máquina (su carpeta debe estar visible en un directorio en tu PATH). Para verificar si ya tienes Docker instalado, ejecuta docker -v.

    Cloud Code instala y administra automáticamente las siguientes dependencias en tu IDE: minikube, kubectl, Skaffold y el SDK de Cloud.

  4. Abre IntelliJ IDEA (o cualquier IDE de JetBrains admitido).

  5. Cuando tu IDE esté abierto, actualiza esta página.

    Ahora puedes instalar el complemento de Cloud Code directamente; para ello, haz clic en el siguiente botón:

    El botón iniciará un diálogo de instalación dentro de tu IDE abierto. Haz clic en Aceptar para configurar Cloud Code.

Crea una aplicación

Para crear una aplicación nueva mediante una muestra existente sigue estos pasos:

  1. En tu IDE, abre File > New Project y, luego, selecciona Cloud Code: Kubernetes.

  2. Selecciona una plantilla de Hello World de la lista de aplicaciones de inicio.Lista de plantillas disponibles: Python, Go, NodeJS, aplicaciones del libro de visitas de Hello World de Java

  3. Elige un nombre para el proyecto.

    Después de hacer clic en Finalizar, Cloud Code clona la plantilla elegida y abre el proyecto recién creado para su uso.

    En las plantillas de Java, se te solicita que importes los proyectos de Maven necesarios para sincronizar tu pom.xml. Haz clic en Agregar como proyecto de Maven (Add as Maven project) y, luego, en Importar cambios (Import Changes).

Elige un clúster

Para desarrollar la aplicación, necesitarás un clúster de Kubernetes asociado (alojado de forma local con minikube o mediante una plataforma en la nube, como un clúster de Google Kubernetes Engine).

Clúster local

Si aún no tienes un clúster para esta guía de inicio rápido, puedes elegir ejecutar tu aplicación con un clúster de Minikube local administrado por Cloud Code. Cloud Code inicia un clúster de Minikube para ejecutar tu aplicación y detiene el clúster cuando se detiene la implementación. Si un clúster de Minikube ya está en ejecución, Cloud Code reutiliza el clúster de Minikube existente para la implementación.

Puedes optar por usar este clúster de Minikube administrado por Cloud Code en el siguiente paso, desarrollar tu aplicación, si lo configuras como tu preferencia de implementación.

Clúster basado en la plataforma de Cloud

Si ya tienes un clúster configurado para trabajar con herramientas de Kubernetes (como kubectl) que puedes usar en esta guía de inicio rápido, Cloud Code se implementa en él de manera automática. Puedes avanzar al desarrollo de tu aplicación en el que puedes confirmar que tu clúster preferido esté configurado como tu contexto actual.

De lo contrario, puedes crear una mediante las instrucciones específicas de la plataforma de Cloud. En GKE, puedes seguir la guía Crea un clúster.

Desarrolla tu aplicación

Para iniciar el desarrollo de tu aplicación en Kubernetes, sigue estos pasos:

  1. Si ejecutas en un clúster alojado en una plataforma en la nube, asegúrate de definir dónde se almacenan las imágenes de contenedor para Desarrolla en Kubernetes.

    Si accediste a Google Cloud en tu IDE y tienes un proyecto predeterminado definido, Cloud Code usa de forma automática el repositorio de imágenes de contenedor predeterminado (gcr.io/{project_id}, en el que {project_id} hace referencia a tu {101) }proyecto predeterminado).

    El repositorio de imágenes predeterminado en la configuración de ejecución se establece con el formato “gcr.io/” y se presentan opciones de autocompletado según el proyecto actual y el clúster activo

  2. Asegúrate de que esté configurado el contexto de Kubernetes que prefieras. Esto se puede especificar en tu configuración de desarrollo en Kubernetes (a la que se puede acceder desde Run > Edit Configurations...) > Desarrolla en Kubernetes), en la pestaña Ejecutar y en la sección Preferencias de implementación.

    Puedes implementar en un contexto actual (predeterminado), de forma local en un clúster de Minikube o en otro contexto disponible.

    Selecciona el contexto de implementación de Kubernetes en una configuración de Kubernetes de Cloud Code

  3. Elige el objetivo de ejecución Desarrolla en Kubernetes desde el selector de configuración de ejecución y depuración de la barra de navegación.

    Esto garantiza que los cambios de código se compilen, se envíen y se implementen de forma automática en una versión nueva de tu aplicación.

    Configuraciones de ejecución para la implementación en Kubernetes

  4. Para iniciar el ciclo de desarrollo en tu clúster de Kubernetes, haz clic en la acción de ejecución en Desarrolla en Kubernetes.

    ícono de acción de ejecutar para iniciar el ciclo de desarrollo en tu clúster de Kubernetes.

  5. En la ventana de salida, en la pestaña Registros, consulta los registros de la aplicación entrantes.

    Cuando comience la implementación, verás la lista de puertos reenviados para la aplicación implementada.

  6. Cuando la implementación se realiza de forma correcta, se te notifica que hay nuevas URL de servicio disponibles. Haz clic en la pestaña URL de servicio para ver las URL y, luego, haz clic en el vínculo de URL a fin de abrir el navegador con la aplicación en ejecución.

    Visualiza servicios reenviados de puertos en la pestaña URL de servicio

    De manera alternativa, puedes abrir el Registro de eventos y, luego, hacer clic en el vínculo para abrir tu navegador con la aplicación en ejecución.

Depura tu aplicación

Para depurar tu aplicación, haz lo siguiente:

  1. Haz clic en la acción de depuración ícono de acción de ejecutar para Develop on Kubernetes (Desarrollar en Kubernetes) a fin de iniciar el ciclo de desarrollo en modo de depuración en tu clúster de Kubernetes.

    Iniciar el ciclo de desarrollo del clúster de Kubernetes en modo de depuración

  2. Cloud Code adjuntará una sesión de depuración. Cuando se ejecuta de forma correcta, se abre la ventana "Debug Tool" y se confirma la conexión (en la pestaña Console).

    Ahora puedes depurar en tu clúster activo de Kubernetes.

  3. Haz clic en el margen en la línea ejecutable del código en el que deseas agregar una interrupción.

    Los círculos rellenos de color rojo indican las interrupciones activas, mientras que los círculos vacíos con contornos rojos indican las interrupciones inhabilitadas.

  4. Cuando envíes una solicitud nueva a la aplicación, se detendrá en la línea deseada.

    Sesión del depurador de Kubernetes

  5. Si deseas finalizar la sesión de depuración, haz clic en el ícono de detención en la configuración de ejecución Develop on Kubernetes.

Ejecuta tu aplicación

Para ejecutar una aplicación en Kubernetes, sigue estos pasos:

  1. Asegúrate de haber definido la ubicación en la que se almacenarán tus imágenes de contenedor para Run on Kubernetes (Ejecutar en Kubernetes).

    Si accediste a Google Cloud en tu IDE y tienes un proyecto predeterminado definido, Cloud Code usa de forma automática el repositorio de imágenes de contenedor predeterminado (gcr.io/{project_id}, en el que {project_id} hace referencia a tu {101) }proyecto predeterminado).

  2. Asegúrate de tener todo listo para implementar tu app en el contexto de Kubernetes que prefieras.

    Elige Edit Configurations... en el selector de configuración de ejecución y depuración de la barra de navegación. En la pestaña Ejecutar de la configuración de ejecución en Kubernetes, puedes especificar tu preferencia de implementación.

  3. Ahora que tu aplicación está lista para la implementación, elige Run on Kubernetes en el selector de configuración de ejecución y depuración de la barra de navegación a fin de implementar la aplicación.

    Configuraciones de ejecución para la implementación en Kubernetes

  4. Haz clic en Run on Kubernetes ícono de acción de ejecutar.

  5. Al igual que con el desarrollo en Kubernetes, puedes ver los registros de aplicaciones entrantes en la ventana de salida de la pestaña Registros.

  6. Cuando la implementación se realiza de forma correcta, se te notifica que hay nuevas URL de servicio disponibles. Haz clic en la pestaña URL de servicio para ver las URL y, luego, haz clic en el vínculo de URL a fin de abrir el navegador con la aplicación en ejecución.

    De manera alternativa, puedes abrir el registro de eventos y, luego, hacer clic en el vínculo para abrir tu navegador con la aplicación en ejecución o visitar http://localhost:{port-number} para acceder. Tu aplicación recién implementada.

    Aplicación en http://localhost:{port-number} que muestra “Hello World!”

Visualiza los registros

Además de ver una transmisión en vivo de los registros de los Pods en ejecución en el resultado de la terminal mientras desarrollas y ejecutas la aplicación, puedes ver los registros de un Pod específico si navegas hasta Kubernetes Explorer.

Para ver los registros de un pod específico, sigue estos pasos:

  1. Navega a Kubernetes Explorer. Se puede acceder desde el panel lateral de la derecha oHerramientas >Cloud Code >Kubernetes >Ver el Explorador de clústeres ,

    Panel de Kubernetes Explorer abierto mediante la pestaña que se encuentra en la barra de tareas del lado derecho

  2. Selecciona el pod del que deseas ver los registros.

  3. Haz clic derecho en el Pod y, luego, selecciona Stream Logs (Transmitir registros). Como alternativa, puedes transmitir registros para contenedores individuales que se ejecutan en pods.

    Esto genera registros en la consola de Kubernetes Explorer.

    Transmite registros desde un pod mediante el menú que aparece cuando se hace clic con el botón derecho para generar registros en la consola de Kubernetes Explorer

Realiza una limpieza

Para evitar que se apliquen cargos en tu cuenta por los recursos que se usan en esta guía de inicio rápido, asegúrate de borrar el clúster y el proyecto que creaste.

Si usas Google Cloud y deseas borrar tu proyecto (y los recursos asociados, que se incluyen los clústeres de GKE), sigue estos pasos:

  1. Ve a la página Proyectos en Cloud Console:

    Ir a la página Proyectos

  2. Selecciona el proyecto que creaste para esta guía de inicio rápido y haz clic en el ícono de la papelera al lado para borrarlo.

    Esta acción cierra el proyecto y programa su eliminación.

¿Qué sigue?

Obtén asistencia

Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve a Tools > Cloud Code > Help / About > . Envía comentarios o informa un problema para informar un error en GitHub o hacer una pregunta en Stack Overflow.

También puedes unirte al canal #cloud-code, que forma parte de la comunidad de Slack de Google Cloud.