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”, crearás un clúster, ejecutarás tu app en él, iniciarás la recompilación continua para desarrollar la app de forma iterativa, depurarás código de ejecución y verás los registros que se transmiten desde tu aplicación en vivo.

Crea una app nueva de Hello World con Cloud Code

Antes de comenzar

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

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

Instala el complemento

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

  1. Si aún no lo hiciste, instala el IDE de JetBrains versión 2019.2+ (como IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand).
  2. Para todas las plataformas de Cloud, asegúrate de que el cliente Docker (autenticado con tu registro de Docker) esté instalado en la PATH de tu máquina (su carpeta respectiva debe estar visible en un directorio dentro de tu PATH).

    Cloud Code instalará de forma automática las otras dependencias necesarias.

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

  4. Busca el complemento “Cloud Code” en el mercado de complementos (Archivo > Parámetros de configuración > Complementos o, para macOS, IntelliJ IDEA > Preferencias > Complementos) y, luego, instálalo.

    Es posible que debas reiniciar tu IDE para activar el complemento.

Crea un clúster

Antes de crear tu aplicación, necesitarás un clúster de Kubernetes asociado (alojado de forma local con Minikube o con Cloud Platform, como un clúster de Google Kubernetes Engine). Si aún no tienes un clúster para esta guía de inicio rápido, crea uno.

Si eliges usar Google Cloud, sigue estos pasos para crear un clúster de GKE:

  1. Crea un clúster nuevo en GKE, ya sea desde tu terminal o desde Cloud Console.

    • Para crear un clúster mediante la terminal (accesible dentro de tu IDE, mediante la barra de tareas inferior), ejecuta el siguiente comando:

       gcloud container clusters create [CLUSTER_NAME] --zone [COMPUTE_ZONE]
      
    • Para crear un clúster con Cloud Console, visita el menú de Google Kubernetes Engine y haz clic en Crear clúster.

      Ir al menú Google Kubernetes Engine

      Consulta la guía de GKE para obtener más detalles sobre la personalización de campos.

  2. Después de crear el clúster, debes agregarlo a tu archivo kubeconfig local. Para realizar esta acción debes ejecutar lo siguiente:

     gcloud container clusters get-credentials [CLUSTER_NAME]
    

    Así también se establece el clúster especificado en el contexto activo.

Crea una aplicación

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

  1. En tu IDE, abre File (Archivo) New Project (Proyecto nuevo) y selecciona Cloud Code: Kubernetes (Cloud Code: Kubernetes).
  2. Selecciona una plantilla “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. Especifica la ubicación en la que se almacenará tu imagen de contenedor.

    Especifica tu repositorio de imágenes predeterminado en el campo mediante el formato gcr.io/{gcp-project-name} o docker.io/{account}.

    Según el registro de contenedores que elijas, selecciona un formato adecuado:

    • Si usas GKE, puedes almacenar tus imágenes en Google Container Repository.

      Además, el campo incluye la función de autocompletado para que puedas buscar con facilidad la imagen asociada con tu proyecto de Google Cloud preferido y tu clúster actual activo. Usa el siguiente formato:

      gcr.io/{project-name} en el que {project-name} es el nombre del proyecto de GCP que contiene tu clúster.

    • Si eliges almacenar tus imágenes en Docker Hub, usa el siguiente formato (asegúrate de estar autenticado de forma correcta si usas un repositorio privado de Docker Hub):

      docker.io/{account} en el que {account} es el nombre de tu cuenta de Docker Hub.

    • Si ejecutas en un clúster local, como Minikube o Docker Desktop, puedes omitir este paso y hacer clic en “Next” (Siguiente).

  4. Elige un nombre para tu proyecto.

    Una vez que hagas clic en Finish (Finalizar), Cloud Code clonará la plantilla que elegiste y abrirá el proyecto que recién creaste para usarlo.

    • En el caso de las plantillas de Java, se te solicitará que importes proyectos de Maven para sincronizar tu pom.xml. Haz clic en “Add as Maven project” (Agregar como proyecto de Maven).

      Notificación de pom.xml no administrada

      Además, si deseas importar los proyectos de Maven necesarios, haz clic en “Import Changes” (Importar cambios).

      Importa las notificaciones de cambios de Maven

Desarrolla tu aplicación

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

  1. Asegúrate de haber definido la ubicación en la que se almacenan tus imágenes de contenedor para Develop on Kubernetes (Desarrollar en Kubernetes).
  2. Elige el objetivo de ejecución Develop on Kubernetes (Desarrollar en Kubernetes) en el cuadro de diálogo Run/Debug configurations (Configuración de ejecución y depuración) en la barra de tareas superior.

    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

  3. En la ventana de salida, consulta los registros de aplicaciones entrantes.

    Cuando se inicie la implementación, verás la lista de puertos redireccionados de la aplicación implementada.

    Visualizar registros transmitidos desde la aplicación de Kubernetes

  4. En el Registro de acontecimientos del IDE, haz clic en el vínculo para abrir el navegador con la aplicación en ejecución.

    Usa el registro de acontecimientos para buscar servicios con redirección de puertos

Depura tu aplicación

Para depurar tu aplicación, haz lo siguiente:

  1. Asegúrate de haber definido la ubicación en la que se almacenan tus imágenes de contenedor para Develop on Kubernetes (Desarrollar en Kubernetes).
  2. 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

  3. Cloud Code adjuntará una sesión de depuración. Una vez que se complete de forma correcta, se abrirá la ventana de la Herramienta de depuración para confirmar la conexión (dentro de la pestaña Console).

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

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

  5. Cada vez que envíes una solicitud nueva a tu aplicación, se detendrá en la línea deseada.

    Sesión del depurador de Kubernetes

  6. 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).
  2. Ahora que tu aplicación está lista para la implementación, elige Run on Kubernetes (Ejecutar en Kubernetes) en el cuadro de diálogo Run/Debug configurations (Configuración de ejecución y depuración) en la barra de tareas superior para implementar la aplicación.

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

  3. Haz clic en “Run on Kubernetes” (Ejecutar en Kubernetes) ícono de acción de ejecutar.

  4. Al igual que con el desarrollo en Kubernetes, puedes ver los registros de las aplicaciones entrantes en la ventana de salida.

  5. En el Registro de acontecimientos del IDE, busca el puerto en el que se entrega tu aplicación. Haz clic en el vínculo para abrir el navegador con la aplicación en ejecución.

  6. Visita http://localhost:{port-number} para acceder a la aplicación nueva recién implementada.

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

Visualiza registros

Si bien puedes ver una transmisión en vivo de los registros de los pods en ejecución en la salida de la terminal mientras desarrollas y ejecutas la aplicación, también puedes ver los registros de un pod específico si navegas hacia el explorador de Kubernetes.

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

  1. Navega a Kubernetes Explorer. Se puede acceder desde el panel lateral ubicado a la derecha o mediante Tools (Herramientas) > Cloud Code (Cloud Code) > Kubernetes (Kubernetes) > View Cluster Explorer (Ver 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 con el botón derecho en el pod y selecciona Stream Logs (Transmitir registros). Como alternativa, puedes transmitir registros para contenedores individuales que se ejecutan en pods.

    Esto generará 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:

  • Ve a la página Proyectos en Cloud Console:

    Ir a la página Proyectos

  • Selecciona el proyecto que creaste para este inicio rápido y bórralo. Para ello, debes hacer clic en el ícono de la papelera que se encuentra al lado.

    Con esta acción, se cierra el proyecto y se programa su eliminación.

Próximos pasos

Obtén asistencia

Para enviar comentarios, informar problemas en GitHub o hacer preguntas en Stack Overflow.