Descripción general de Cloud Code para IntelliJ Kubernetes

En esta página, se proporciona una descripción general del desarrollo de Kubernetes en Cloud Code.

Usa Kubernetes Explorer en Cloud Code

El explorador de Kubernetes te permite acceder a información sobre tus clústeres, nodos, cargas de trabajo y mucho más, directamente desde tu IDE. También puedes establecer un contexto actual, transmitir y ver registros, abre una terminal interactiva y buscar descripciones de recursos con el lenguaje un profesional de seguridad en la nube.

Explorador de Kubernetes de Cloud Code

Cloud Code usa el archivo kubeconfig predeterminado, ubicado en el directorio $HOME/.kube en MacOS/Linux o %USERPROFILE%\.kube en Windows para recuperar recursos de Kubernetes. Puedes cambiar o agregar nuevos archivos Kubeconfig desde Kubernetes Explorer. Los archivos kubeconfig son archivos YAML que contienen los detalles, el certificado y el token secreto de tu clúster de Kubernetes para autenticarse en él.

Para usar un archivo kubeconfig que no sea el predeterminado, consulta la guía Cómo trabajar con archivos kubeconfig.

Accede a Kubernetes Explorer

Para ver y administrar tus recursos de Kubernetes, usa Kubernetes Explorer, al que puedes acceder desde el panel lateral ubicado a la derecha. También puedes acceder a él mediante Herramientas > Cloud Code > Kubernetes > Ver explorador de clústeres.

Cuando inicias una sesión de desarrollo o depuración, la sección Sesiones de desarrollo muestra la vista de registro estructurado.

Panel de sesiones de desarrollo

Acciones básicas

Kubernetes Explorer cuenta con la tecnología de kubectl. Siempre que hayas configurado el archivo de configuración kubectl para acceder a los clústeres, puedes usar el explorador de Kubernetes para agregar clústeres, explorar todos los espacios de nombres, recursos y nodos disponibles, sin importar si están en el contexto activo o inactivo.

Las acciones generales disponibles de Kubernetes, a las que se puede acceder a través de sus íconos en la Kubernetes Explorer:

  • Nueva app de Kubernetes a partir de un ícono de muestra Crea una nueva aplicación de Kubernetes a partir de una muestra
  • Ícono de actuallizar explorador Actualiza el explorador
  • ícono de abrir documentos Abre la Documentación de Kubernetes de Cloud Code en un navegador web

Acciones comunes de depuración de Kubernetes adicionales, a las que se puede acceder a través de sus íconos en de Kubernetes Explorer, son las siguientes:

  • Ícono de Run Ejecuta el configuración actual de ejecución y depuración.
  • Ícono Depurar Inicia la configuración de ejecución en modo de depuración.
  • Ícono de detención de depuración Detener un sesión de depuración activa.

Copia el nombre de un recurso

Puedes copiar cualquier nombre de recurso de Kubernetes en el portapapeles (incluido el y nombres de clústeres). Para copiar el nombre de un recurso, haz clic con el botón derecho en él y elige Copiar nombre del recurso.

Cómo copiar el nombre de un recurso con el menú contextual

Actualizar recursos

Kubernetes Explorer detecta los cambios y automáticamente actualizaciones para reflejar los cambios. Para forzar la actualización de cualquier recurso de Kubernetes para recuperar su información más reciente, haz clic con el botón derecho en el recurso y elige Actualizar.

Actualiza los pods con el menú que aparece cuando haces clic con el botón derecho

También puedes forzar una actualización de todo Kubernetes Explorer con el botón de actualización de Kubernetes Explorer. Botón de actualización de Kubernetes Explorer

Describe recursos

Para mostrar los detalles de cualquier recurso que no sea de clúster, haz clic con el botón derecho en el recurso. y, luego, selecciona Describir. La información del recurso se presenta en el panel de la consola de Kubernetes Explorer.

La opción Describe (Describir) disponible cuando se hace clic con el botón derecho en un recurso adecuado dentro de Kubernetes Explorer y se selecciona Describe (Describir)

Para ver los detalles del recurso, también puedes hacer clic en cualquier recurso. Si tiene metadatos adjuntos, estos estarán disponibles en el panel Resource Details (Detalles del recurso) en Kubernetes Explorer.

Visualiza metadatos de recursos en el panel Detalles del recurso disponible en la segunda mitad de Kubernetes Explorer

Opciones de Skaffold

  • Skaffold configuration (Configuración de Skaffold): Te permite seleccionar un archivo de configuración skaffold.yaml. Se detectará automáticamente si tienes un skaffold.yaml en tu proyecto.
  • Deployment profile: Selecciona un perfil. entre las opciones disponibles configuradas en tu archivo skaffold.yaml.
  • Environment variables (Variables de entorno): Te permite configurar variables del entorno adicionales que se pasarán al proceso de implementación de Skaffold. Las marcas de Skaffold también se pueden configurar como variables de entorno a fin de usarlas en este campo. Consulta la documentación de referencia de la CLI de Skaffold para obtener una lista completa de las variables de entorno de Skaffold disponibles.
  • Verbosity (Verbosidad): Te permite configurar el nivel de verbosidad de salida en trace, debug, info, warn, error o fatal. El nivel de verbosidad predeterminado es warn.

Opciones de Kubernetes

  • Development Context: Representa el contexto de Kubernetes con el que se implementa tu aplicación. El comportamiento predeterminado, si no se especifica un contexto de implementación, es implementar en el contexto del sistema actual, si existe uno.

    Si prefieres no implementar en el contexto actual, en la sección Deployment de la configuración de ejecución y depuración, puedes optar por lo siguiente:

    • Deploy locally to a minikube cluster: inicia un clúster de Minikube administrado por Cloud Code para ejecutar la app y detiene el clúster después de que se detiene la implementación. Si un clúster de Minikube ya se encuentra en ejecución, Cloud Code usa el clúster de Minikube existente para la implementación.
    • Cambiar contexto e implementar en: Cambia el contexto actual en tu sistema al contexto que se especifica en la implementación.

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

  • Delete deployments when finished (Borrar las implementaciones cuando se terminen): Borra las implementaciones de Kubernetes cuando finaliza el proceso. Este es el comportamiento predeterminado. Como alternativa, puedes desactivar esta configuración para evitar que se borren las implementaciones.

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 Ejecutar > Edita los parámetros de configuración.

Ver YAML remoto

Para ver el YAML de un recurso en tu clúster, directamente desde en Google Kubernetes Explorer. Navega a un recurso en Kubernetes Explorer, como un pod, haz clic con el botón derecho en el nombre del recurso y, luego, selecciona View Remote YAML.

Se abrirá el archivo YAML correspondiente al recurso especificado en una nueva pestaña del editor.

Para ver el YAML de un pod, haz clic con el botón derecho en su etiqueta en Kubernetes Explorer y selecciona “View Remote YAML” (“Ver YAML remoto”)

Visualiza registros

Puedes transmitir y visualizar registros de los recursos de Kubernetes a la de Cloud Explorer para supervisar su progreso.

Luego de que tu aplicación se compila y se ejecuta en modo de desarrollo o normal, puedes supervisar la transmisión de registros de la aplicación desde el IDE.

Visualiza registros transmitidos desde la aplicación de Hello World para Java

También puedes ver los registros de un servicio específico si navegas a la un profesional de seguridad en la nube.

Para seleccionar el recurso del que deseas ver los registros, como un Pod, un Deployment, o un servicio:

  1. Haz clic con el botón derecho en el recurso y selecciona Transmitir registros. Como alternativa, puedes transmitir registros para contenedores individuales que se ejecutan en Pods.

    Esto genera registros en la consola de Kubernetes Explorer.

Para ver el estado de los recursos en tu implementación, haz lo siguiente:

  • Estados del Pod, la implementación y el nodo: Estos recursos de Kubernetes tienen marcas de estado de color junto a sus etiquetas. El color rojo indica un estado de error, el amarillo indica inicio, finalización o advertencia y el verde, un buen estado.

    La marca de verificación verde junto a la etiqueta del pod indica que está en buen estado

  • Descripciones de recursos implementados: Puedes ejecutar un kubectl describe en tu los recursos implementados para mostrar los detalles haciendo clic con el botón derecho y eligiendo Describir.

    Opción de descripción disponible cuando se hace clic con el botón derecho en un recurso apropiado dentro del panel de Kubernetes Explorer y se selecciona Describe

Cómo iniciar una terminal

En el caso de los pods y contenedores, puedes abrir una terminal interactiva haciendo clic con el botón derecho en el pod o contenedor y seleccionando Get terminal.

Abre una terminal interactiva

Acciones específicas del recurso

Kubernetes Explorer muestra clústeres, espacios de nombres, nodos y cargas de trabajo (como implementaciones, conjuntos de réplicas, pods y contenedores), servicios y entradas 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.

Puedes acceder a Kubernetes Explorer desde el panel lateral o ir a Tools > Cloud Code > Kubernetes > View Cluster Explorer.

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

Para mostrar los detalles de los recursos implementados, haz clic con el botón derecho en una etiqueta de recurso. en Kubernetes Explorer y, luego, en Describir.

Opción Describe disponible cuando se hace clic con el botón derecho en un recurso determinado dentro del panel de Kubernetes Explorer y se selecciona Describe

Clústeres

  • Agrega un clúster de Google Kubernetes Engine: Agrega un clúster de GKE estándar o de Autopilot existente, o crea uno nuevo haciendo clic en + Add GKE Cluster en el explorador de Kubernetes.

Aparecerá el diálogo Add Cluster, en el que puedes elegir el proyecto y el clúster que deseas usar o crear uno nuevo.

Cuando termines, haz clic en Aceptar y accede al clúster que elegiste y a sus recursos subyacentes a través de Kubernetes Explorer.

Diálogo Agrega un clúster de GKE con Kubernetes Explorer con campos para nombres de proyectos y clústeres

  • Set as current context: (Establece como contexto actual) Configura el clúster especificado como activo de modo que el contexto kubectl configurado acceda a este clúster de forma predeterminada.

    Configura un clúster como el contexto actual con Kubernetes Explorer

Kubernetes Explorer se actualiza automáticamente y verás el símbolo de Kubernetes junto al clúster correspondiente.

Si un clúster tiene varios contextos configurados, podrás elegir uno de los contextos disponibles para establecer como contexto actual.

Elige y configura un clúster activo de una lista de varios contextos con Kubernetes Explorer

Espacios de nombres

  • Configurar como contexto actual: Configura un espacio de nombres como activo de modo que el contexto kubectl configurado acceda a este espacio de nombres de forma predeterminada.

    Establece el espacio de nombres como el contexto actual con el menú contextual

Si la acción se realiza correctamente, Kubernetes Explorer se actualiza automáticamente y verá un asterisco junto al espacio de nombres que indica que es parte del contexto actual.

Ten en cuenta que un contexto de Kubernetes es un atajo que te brinda acceso rápido a un espacio de nombres en tu clúster. Por lo general, los contextos se crean automáticamente cuando inicias un clúster de Minikube o GKE. Si no ves la opción Establecer como contexto actual para un espacio de nombres determinado y quieres crear un contexto para ello, usa el Comando kubectl config set-context en tu terminal para establecer un contexto con tu clúster, usuario y espacio de nombres.

Pods

  • Ver registros: Visualiza los registros de un Pod en la consola de Kubernetes Explorer.
  • Obtén una terminal: Obtén una terminal para un pod en la consola de Kubernetes Explorer.

    Además, los pods en ejecución tienen marcas de estado con colores junto a sus etiquetas:

    • Rojo: El pod está en estado de error
    • Amarillo: El pod se está iniciando o finalizando
    • Verde: El pod está en funcionamiento
Marca de verificación verde junto al estado en buen estado de la indicación del Pod

Contenedores

  • Ver registros: Visualiza registros desde un contenedor en la consola de Kubernetes Explorer.
  • Obtén una terminal: Obtén una terminal para un contenedor en la consola de Kubernetes Explorer.
Transmite registros desde un contenedor mediante el menú que aparece cuando se hace clic con el botón derecho para generar registros en la consola de Kubernetes Explorer

Implementaciones

  • Ver registros: Visualiza registros desde una implementación en la consola de Kubernetes Explorer.

    Las implementaciones en vivo tienen marcas de estado con colores junto a sus etiquetas y recuentos de réplicas actuales o totales:

    • Amarillo: La implementación no tiene una disponibilidad mínima o tiene problemas con las imágenes.
    • Verde: La implementación está en buen estado y tiene una disponibilidad mínima.
Íconos de implementación verdes que indican un estado correcto

Nodos

Los nodos del clúster tienen marcas de estado con colores junto a sus nombres:

  • Amarillo: El nodo tiene un problema de recursos, como la disponibilidad del disco o la memoria.
  • Verde: El nodo está en buen estado.

Definiciones de recursos personalizados (CRD)

Kubernetes Explorer enumera todas las definiciones de recursos personalizados (CRD) estén instalados y disponibles en tu clúster:

Lista de definiciones de recursos personalizadas en Explorer

¿Qué sigue?

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.