Descripción general de Cloud Code para Kubernetes de Cloud Shell

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

Usa Kubernetes Explorer en Cloud Code

Kubernetes Explorer te permite acceder a información sobre tus clústeres, nodos, cargas de trabajo y más directamente desde tu IDE. También puedes configurar un contexto actual, transmitir y ver registros, abrir una terminal interactiva y buscar descripciones de recursos con Kubernetes Explorer.

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 los recursos de Kubernetes. Puedes cambiar o agregar archivos Kubeconfig nuevos desde Kubernetes Explorer. Los archivos kubeconfig son archivos YAML que contienen los detalles del clúster de Kubernetes, el certificado y el token secreto para autenticarse en el clúster.

Para usar un archivo kubeconfig que no sea el predeterminado kubeconfig, consulta la guía Trabaja con archivos kubeconfig.

Accede a Kubernetes Explorer

Para ver y administrar tus recursos de Kubernetes, accede a Kubernetes Explorer, haz clic en Cloud Code y expande la sección Kubernetes. Para ver las sesiones de depuración o crear una app de ejemplo, expande la sección Development sessions.

Accede a la sección Development sessions.

Usa las sesiones de desarrollo para ejecutar o depurar tu aplicación de Kubernetes o crear una aplicación de muestra mediante una plantilla.

Cuando inicias una sesión de desarrollo o depuración, la sección Development sessions (Sesiones de desarrollo) muestra la vista de registro estructurada.

Panel de sesiones de desarrollo

Para acceder a las sesiones de desarrollo, haz clic en Cloud Code y expande la sección Sesiones de desarrollo (Development sessions).

Acciones básicas

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

Sección de clústeres

Las acciones generales de Kubernetes disponibles, a las que se puede acceder a través de sus íconos en la sección Clústeres de Kubernetes Explorer, son las siguientes:

  • add Agrega un clúster a KubeConfig
  • refresh Actualiza Kubernetes Explorer.
  • question_mark Abre la documentación de Kubernetes de Cloud Code en un navegador web

Sección de sesiones de desarrollo

Las acciones de Kubernetes disponibles, a las que se puede acceder a través de sus íconos en la sección Development sessions, son las siguientes:

  • Ícono de Open Kubernetes sampleAbrir una aplicación de ejemplo de Kubernetes
  • play_arrow Ejecuta tu aplicación
  • Ícono Depurar Depura tu aplicación

Copia el nombre de un recurso

Puedes copiar cualquier nombre de recurso de Kubernetes en el portapapeles (incluidos los nombres de contenedores y clústeres). Para copiar el nombre de un recurso, haz clic con el botón derecho en el recurso y selecciona Copiar nombre del recurso.

Copia el nombre del recurso mediante el menú contextual

Actualizar recursos

Kubernetes Explorer observa los cambios y se actualiza de forma automática para reflejar los cambios. Para forzar una actualización de cualquier recurso de Kubernetes a fin de recuperar la información más reciente, haz clic con el botón derecho en el recurso y elige Actualizar.

Actualiza los Pods mediante el menú contextual

También puedes forzar la actualización de toda la sección Clústeres de Kubernetes Explorer con el botón de actualización de la sección Clústeres.

Botón para actualizar la sección de clústeres

Describir los 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 selecciona Describir. Se abrirá una terminal y se mostrará la información del recurso. Describe los detalles del recurso en el menú contextual

Personaliza la configuración de inicio

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

Ver YAML remoto

Para ver el archivo YAML de un recurso en tu clúster, selecciona el recurso o coloca el cursor sobre él para mostrar los íconos Editar YAML y Ver YAML. Selecciona el botón Ver YAML para abrir el archivo YAML correspondiente al recurso especificado en una pestaña nueva del editor.

Se abrió el YAML del servicio de Kubernetes con el ícono Ver YAML

Visualiza los registros

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

Para abrir el visor de registros, presiona Ctrl/Cmd+Shift+P o haz clic en View > Command Palette y, luego, selecciona Cloud Code: View Logs.

Diálogo Ver registros en la paleta de comandos

El visor de registros se abrirá en una nueva pestaña del editor.

Visor de registrosPara ver los registros de un Pod o contenedor, haz clic con el botón derecho en el recurso y selecciona Ver registros.

Visualiza los registros de un Pod

Iniciar una terminal

En el caso de los pods y los contenedores, puedes abrir una terminal interactiva si haces clic con el botón derecho en el pod o contenedor y seleccionas Get terminal (Obtener terminal).

Abrir una terminal interactiva

Acciones específicas del recurso

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

Clústeres

  • Agrega un clúster a Kubeconfig: Agrega un clúster de GKE o Minikube existente, o crea uno nuevo.

Aparecerá el diálogo Add Cluster y podrás elegir el proyecto y el clúster que quieras usar, o bien crear uno nuevo.

Elige la plataforma del clúster

Crea o elige un clúster de GKE

  • Configurar como clúster activo:Configura el clúster especificado como activo de modo que el contexto kubectl configurado acceda a este clúster de forma predeterminada.

    Configura el clúster como activo mediante el menú que aparece cuando se hace clic con el botón derecho.

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 establecerlo como el contexto actual.

Espacios de nombres

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

    Haz clic con el botón derecho en el espacio de nombres que deseas configurar como activo.

    Establece el espacio de nombres como el contexto actual a través del menú que aparece cuando se hace clic con el botón derecho

Si esta acción se realiza correctamente, Kubernetes Explorer se actualizará automáticamente y verás un asterisco junto al espacio de nombres para indicar que forma parte del contexto actual.

Ten en cuenta que un contexto de Kubernetes es un acceso directo 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 deseas crear un contexto para él, usa el comando kubectl config set-context en tu terminal a fin de configurar un contexto con tu clúster, usuario y espacio de nombres preferidos.

Pods

  • Ver registros: Visualiza registros desde 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
Una marca de verificación verde junto al Pod que indica un buen estado

Contenedores

  • Ver registros: Visualiza registros desde un contenedor en la consola de Kubernetes Explorer.
  • Obtener terminal: Obtén la terminal de un contenedor en la consola de Kubernetes Explorer.

Implementaciones

  • Ver registros: Visualiza registros de 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/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 buen estado

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) instaladas y disponibles en tu clúster:

Lista de definiciones de recursos personalizados en el Explorador

¿Qué sigue?