Comienza a usar Cloud Code para IntelliJ para Kubernetes

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

Crea una aplicación a partir de una plantilla

Cloud Code incluye una colección de muestra de código plantillas para comenzar rápidamente. Para crear una aplicación de Kubernetes con una muestra existente, sigue estos pasos:

1. Abre File (Archivo) > New Project (Proyecto nuevo).
2. Selecciona Cloud Code: Kubernetes (Cloud Code: Kubernetes).
3. Selecciona una plantilla de la lista de aplicaciones de inicio.

4. Elige un nombre para el 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 el pom.xml. Haz clic en Add as Maven project (Agregar como proyecto de Maven). Además, si deseas importar los proyectos de Maven necesarios, haz clic en Import Changes (Importar cambios).

5. Los objetivos de ejecución de Kubernetes y del IDE de desarrollo del proyecto se crean de forma automática y están listos para ejecutarse.

   Opcional: También puedes crear los objetivos de ejecución de forma manual.

   1. Haz clic en el menú desplegable Configuración de ejecución” (Run Configuration) y selecciona Editar configuraciones (Edit Configurations).
   2. Haz clic en + Add New Configuration para agregar una configuración de ejecución nueva.
   3. Navega a Cloud Code: Kubernetes
   4. Ingresa un nombre para la configuración nueva (el valor predeterminado es "Sin nombre").
   5. Haz clic en OK (Aceptar) para crear el objetivo de ejecución.
   Nota: Si accediste a Google Cloud en tu IDE y tienes el proyecto predeterminado, Cloud Code usa tu imagen de contenedor en un repositorio de confianza. Para especificar una imagen de contenedor diferente, sigue las instrucciones de Configura la imagen de contenedor.

Usa tu propia aplicación

Si quieres conocer los pasos para usar un proyecto existente, consulta Usar Cloud Code con una aplicación existente de Kubernetes

Nota: Para desarrollar y probar una app, crea y ejecutar la aplicación en un clúster que no sea de producción.
Para los cambios que se lanzarán a la producción, usa un flujo de trabajo automatizado de CI/CD.

Establece el contexto de Kubernetes

Antes de ejecutar la aplicación, asegúrate de realizar la configuración a fin de implementar tu app en el contexto de Kubernetes que prefieras. Puedes especificar esto en tu configuración.

Si deseas cambiar tu contexto actual, puedes hacerlo con Kubernetes Explorer, al que se puede acceder desde el panel de la barra lateral a la derecha o mediante Herramientas >Cloud Code >Kubernetes >Ver el Explorador de clústeres.

Para optimizar el bucle de desarrollo mediante la obtención rápida de cambios de archivos de un determinado tipo sin tener que realizar una recompilación de imágenes, puedes habilitar la sincronización de archivos y la carga en caliente.

Configuración

Cuando usas la configuración de ejecución Cloud Code: Develop on Kubernetes, puedes personalizar tu implementación mediante la configuración disponible.

Para agregar o editar configuraciones, ve a Ejecutar > Edita los parámetros de configuración.

Opciones de almacenamiento de imágenes de contenedor

Si elegiste un clúster remoto como contexto, elige un registro de imágenes para enviar las imágenes. Ve a Run > Edit Configurations para configurar el registro de imágenes en Run/Debug Configurations.

Consulta la guía sobre el almacenamiento de tu imagen de contenedor para obtener más detalles.

Parámetros de configuración de compilación

Cloud Code es compatible con los tipos de artefactos Docker, Jib y Buildpacks. Consulta la guía de configuración de las preferencias de compilación de la imagen del contenedor para obtener información sobre cómo establecer tu compilador preferido y su configuración relevante.

Personaliza la configuración de inicio

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

También puedes configurar el lanzamiento en tus configuraciones de Run/Debug. Para editar tus configuraciones, ve a Run > Edit configurations.

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

Nota: Cloud Code se diseñó para trabajar con Cloud Build. Para compilar una aplicación existente usando infraestructura de Google Cloud, consulta la Documentación de Skaffold para Cloud Build.

Ejecuta tu aplicación

Una vez que hayas configurado una aplicación, puedes ejecutarla en un clúster de Kubernetes y y verlo en vivo, aprovechando 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.

Nota: Si trabajas con un clúster privado de Autopilot, es posible que encuentres un Error de extracción de imagen cuando se extrae una imagen fuera del registro de imágenes para tu proyecto, por ejemplo, mediante Docker Hub. Para resolver este problema, puedes hacer lo siguiente: alojar la imagen en Container Registry o proporcionan acceso a Internet saliente para los nodos privados.

1. Haz clic en el ícono Ejecutar en tu acción de ejecución preferida. Entonces, puedes ver los registros de aplicaciones entrantes en la ventana de salida en la pestaña Registros.

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

2. Una vez que la implementación se complete de forma correcta, se te notificará que las URL de servicio nuevas están disponibles. Haz clic en la pestaña URLs del servicio para ver las URLs y, luego, en el URL para abrir el navegador con la aplicación en ejecución.

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

   En el panel Deployed Resources, se muestra lo que implementaste durante la sesión de desarrollo.

Visualiza registros

Además de ver los registros de los Pods en ejecución como una transmisión en vivo en el resultado de la terminal mientras desarrollas y ejecutas la aplicació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 Herramientas > Cloud Code > Kubernetes > Ver explorador de clústeres.

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

3. Haz clic con el botón derecho en el Pod y, luego, en Transmitir registros (Stream Logs). Como alternativa, puedes transmitir registros para contenedores individuales que se ejecutan en Pods.

   La consola de Kubernetes Explorer muestra los registros.

Realizar cambios, volver a compilar y realizar una limpieza

Si el modo de observación está establecido en A pedido en la configuración de inicio y quieres para realizar cambios en tu aplicación y, luego, volver a compilar e implementar aplicación:

1. Realiza y guarda los cambios.

2. Haz clic en el ícono Trigger Build and Deploy o presiona Option + Ctrl/Cmd + Comma para volver a compilar y a implementar la aplicación.

3. Para dejar de ejecutar la aplicación, haz clic en el ícono Stop o presiona Ctrl/Cmd + F2.

Después de detener la aplicación, todos los recursos de Kubernetes implementados del clúster. Puedes cambiar este comportamiento mediante la marca cleanUp en la configuración de lanzamiento.

Almacena secretos

Si el código incluye datos potencialmente sensibles, como claves de API, contraseñas y certificados, se recomienda almacenarlos como secretos. Con Cloud Code, puedes almacenar estos secretos de forma segura en Secret Manager y recuperarlos de manera programática cuando los necesites.

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

Ver detalles del recurso

Kubernetes Explorer muestra clústeres, espacios de nombres, nodos y cargas de trabajo (como Deployments, ReplicaSets, Pods y contenedores), objetos Service y Ingress parámetros de configuración (como Secrets y ConfigMaps) y almacenamiento (como volúmenes). Con Kubernetes Explorer, puede realizar acciones únicas en algunos de estos recursos.

Consulta la Descripción general de Kubernetes para obtener más información información sobre la visualización de los detalles de los recursos.

¿Qué sigue?

• Explora tus opciones de compilación con paquetes de compilación, Jib o Docker.
• Usa la sincronización de archivos y la recarga en caliente para acelerar el desarrollo.
• Obtén más información sobre Cloud Code's Edición de YAML y asistencia.

Obtenga asistencia

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