Empezar a usar Cloud Code for IntelliJ para Kubernetes

Cloud Code te permite crear una aplicación de Kubernetes basada en un ejemplo o a partir de un proyecto.

Crear una aplicación a partir de una plantilla

Cloud Code incluye una colección de plantillas de ejemplos de código para que puedas empezar rápidamente. Para crear una aplicación de Kubernetes con un ejemplo, sigue estos pasos:

  1. Abre Archivo > Nuevo proyecto.
  2. Selecciona Cloud Code: Kubernetes.
  3. Selecciona una plantilla de la lista de aplicaciones de inicio.

  4. Elige un nombre para el proyecto.

    Cuando hagas clic en Finalizar, Cloud Code clonará la plantilla que hayas elegido y abrirá el proyecto que acabas de crear para que puedas usarlo.

    En el caso de las plantillas de Java, se te pedirá que importes proyectos de Maven para sincronizar tu archivo pom.xml. Haz clic en Añadir como proyecto de Maven. Además, importa los proyectos de Maven necesarios haciendo clic en Import Changes (Importar cambios).

  5. Los destinos de ejecución de desarrollo y ejecución de Kubernetes del proyecto se crean automáticamente y están listos para ejecutarse.

    Opcional: También puedes crear destinos de ejecución manualmente:

    1. Selecciona el menú desplegable Run Configuration (Configuración de ejecución) y haz clic en Edit Configurations (Editar configuraciones).
    2. Haz clic en + Add New Configuration (Añadir nueva configuración) para añadir una nueva configuración de ejecución.
    3. Ve a Cloud Code: Kubernetes .
    4. Escribe un nombre para la nueva configuración (el predeterminado es "Sin nombre").
    5. Haz clic en Aceptar para crear el objetivo de la carrera.

Usar tu propia aplicación

Para ver los pasos que debes seguir para usar un proyecto, consulta Usar Cloud Code con una aplicación de Kubernetes.

Definir el contexto de Kubernetes

Antes de ejecutar tu aplicación, asegúrate de que está configurada para desplegarla en el contexto de Kubernetes que prefieras. Puedes especificarlo en tu configuración.

Si quieres cambiar el contexto actual, puedes hacerlo con el explorador de Kubernetes, al que puedes acceder desde el panel de la barra lateral de la derecha o mediante Herramientas > Cloud Code > Kubernetes > Ver explorador de clústeres.

Para optimizar el bucle de desarrollo recogiendo rápidamente los cambios de archivo de un tipo concreto sin tener que volver a compilar una imagen, puedes habilitar la sincronización de archivos y la recarga activa.

Configuración

Cuando usas la configuración de ejecución Cloud Code: Develop on Kubernetes (Cloud Code: desarrollar en Kubernetes), puedes personalizar tu implementación configurando los ajustes disponibles.

Para añadir o editar configuraciones, ve a Ejecutar > Editar configuraciones.

Opciones de almacenamiento de imágenes de contenedor

Si has elegido un clúster remoto como contexto, elige un registro de imágenes al que enviar las imágenes. Vaya a Ejecutar > Editar configuraciones para definir el registro de imágenes en Configuraciones de ejecución/depuración.

Consulta la guía sobre cómo almacenar tu imagen de contenedor para obtener más información.

Configuración de compilación

Cloud Code admite los tipos de artefactos Docker, Jib y Buildpacks. Consulta la guía para configurar las preferencias de compilación de imágenes de contenedor para saber cómo definir el compilador que prefieras y sus ajustes correspondientes.

Personalizar la configuración de lanzamiento

Para configurar cómo se ejecuta tu aplicación, puedes personalizar el archivo skaffold.yaml.

También puedes configurar el lanzamiento en Configuraciones de ejecución/depuración. Para editar tus configuraciones, ve a Ejecutar > Editar configuraciones.

Para obtener más información sobre cómo personalizar la configuración de lanzamiento, consulta Kubernetes en Cloud Code.

Ejecutar la aplicación

Una vez que hayas configurado una aplicación, podrás ejecutarla en un clúster de Kubernetes y verla en directo con skaffold dev. Puedes ejecutar tu aplicación en un clúster local (como minikube o Docker Desktop), Google Kubernetes Engine o cualquier otro proveedor de servicios en la nube.

  1. Haz clic en el icono Ejecutar de la acción que prefieras. A continuación, puedes ver los registros de aplicaciones entrantes en la ventana de salida de la pestaña Registros.

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

  2. Una vez que la implementación se haya completado correctamente, recibirás una notificación indicando que hay nuevas URLs de servicio disponibles. Haga clic en la pestaña URLs de servicio para ver las URLs y, a continuación, haga clic en el enlace de la URL para abrir el navegador con la aplicación en ejecución.

    También puedes abrir el Registro de eventos y, a continuación, hacer clic en el enlace para abrir el navegador con la aplicación en ejecución.

    El panel Recursos desplegados muestra lo que has desplegado durante la sesión de desarrollo.

Ver registros

Además de ver los registros de los pods en ejecución como una emisión en directo en la salida del terminal mientras desarrollas y ejecutas tu aplicación, puedes ver los registros de un pod específico desplazándote hasta el Explorador de Kubernetes.

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

  1. Ve al explorador de Kubernetes. Se puede acceder a él desde el panel lateral de la derecha o mediante Herramientas > Cloud Code > Kubernetes > Ver Explorador de clústeres.

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

  3. Haz clic con el botón derecho en el pod y, a continuación, en Registros de la emisión. También puedes transmitir registros de contenedores concretos que se ejecutan en pods.

    La consola del explorador de Kubernetes muestra los registros.

Hacer cambios, recompilar y limpiar

Si el modo de reloj está configurado como Bajo demanda en la configuración de inicio y quieres hacer cambios en la aplicación, volver a compilarla y volver a implementarla, sigue estos pasos:

  1. Haz los cambios y guárdalos.

  2. Haz clic en el icono Activar compilación e implementación o pulsa Option + Ctrl/Cmd + Comma para volver a compilar e implementar la aplicación.

  3. Para detener la ejecución de la aplicación, haz clic en el icono Detener o pulsa Ctrl/Cmd + F2.

Cuando detengas la aplicación, todos los recursos de Kubernetes implementados se eliminarán del clúster. Puedes cambiar este comportamiento con la marca cleanUp en la configuración de inicio.

Almacenar secretos

Si tu código incluye datos potencialmente sensibles, como claves de API, contraseñas y certificados, te recomendamos que los almacenes como secretos. Con Cloud Code, puedes almacenar estos secretos de forma segura en Secret Manager y obtenerlos de forma programática cuando los necesites.

Para obtener información detallada sobre cómo crear y gestionar secretos con Cloud Code, consulta la guía de Secret Manager.

Ver detalles del recurso

El Explorador de Kubernetes muestra clústeres, espacios de nombres, nodos, cargas de trabajo (como despliegues, conjuntos de réplicas, pods y contenedores), servicios y entradas, configuraciones (como secretos y mapas de configuración) y almacenamiento (como volúmenes). Con el explorador de Kubernetes, puedes realizar acciones únicas en algunos de estos recursos.

Consulta la descripción general de Kubernetes para obtener más información sobre cómo ver los detalles de los recursos.

Siguientes pasos

Obtener asistencia

Para enviar comentarios o informar de un problema en tu IDE de IntelliJ, ve a Herramientas > Cloud Code > Ayuda o información > Enviar comentarios o informar de un problema para informar de un problema en GitHub.