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

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

Usa la sección de Kubernetes en Cloud Code

La sección 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, abrir una terminal interactiva y buscar descripciones de recursos con la sección de Kubernetes.

Sección 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 la sección Kubernetes. 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 la sección de Kubernetes

Para ver y administrar tus recursos de Kubernetes, haz clic en Cloud Code y expande la sección Kubernetes para acceder a la sección Kubernetes. Para ver sesiones de depuración o crear una app de ejemplo, expande la sección Sesiones de desarrollo.

Cuando intentes depurar, es posible que se te solicite autenticar tus credenciales para ejecutar y depurar una aplicación de forma local.

Accede a la sección Sesiones de desarrollo

Usa las sesiones de desarrollo para ejecutar o depurar tu aplicación de Kubernetes, o bien crea una aplicación de ejemplo con una plantilla.

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

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

Acciones básicas

La sección Kubernetes se basa en kubectl. Siempre que hayas configurado el archivo de configuración kubectl para acceder a los clústeres, puedes usar la sección 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.

Sección de Kubernetes

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

  • Agrega KubeConfig
  • refresh Actualiza la sección Kubernetes.
  • 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 Sesiones de desarrollo de Kubernetes, son las siguientes:

  • Ícono de ejemplo de Kubernetes abierto Abre una aplicación de ejemplo de Kubernetes
  • play_arrow Ejecuta tu aplicación
  • Ícono Depurar Cómo depurar tu aplicación

Cómo copiar 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 él y elige Copiar nombre del recurso.

Cómo copiar el nombre del recurso con el menú que aparece cuando se hace clic con el botón derecho

Actualiza recursos

La sección Kubernetes detecta cambios y se actualiza automáticamente para reflejar las actualizaciones. 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ú contextual

También puedes forzar una actualización de toda la sección Kubernetes con el botón de actualización de la sección Kubernetes. Botón de actualización de la sección de Kubernetes

Describe recursos

Para mostrar los detalles de cualquier recurso que no sea de clúster, haz clic derecho en él y, luego, selecciona Describe. 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.

También puedes configurar el inicio especificando los siguientes campos en la configuración de cloudcode.kubernetes en el archivo .vscode/launch.json:

  • skaffoldConfig: Especifica el archivo de configuración de skaffold que contiene los parámetros de configuración de compilación y de implementación.
  • perfil: Especifica tu perfil de skaffold preferido. Si no está definido, se usa el perfil predeterminado.
  • imageRegistry: Especifica el registro de imágenes al que se enviarán las imágenes.
  • watch: Especifica si quieres observar los cambios en el espacio de trabajo y volver a ejecutar la aplicación. A menos que se establezca en falso de forma explícita, el valor predeterminado es verdadero.
  • cleanUp: Especifica si se deben borrar los recursos de Kubernetes implementados en el clúster después de que se cierre la aplicación. A menos que se establezca en falso de forma explícita, el valor predeterminado es verdadero.
  • portForward: Especifica si quieres reenviar puertos para los recursos de Kubernetes expuestos en el clúster a tu máquina local. A menos que se establezca en falso de forma explícita, el valor predeterminado es verdadero.

Cómo ver YAML remoto

Para ver el YAML de un recurso en tu clúster, selecciónalo 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 nueva pestaña del editor.

YAML del pod de Kubernetes abierto con el ícono Ver YAML

Ver registros

Puedes transmitir y ver los registros de los recursos de Kubernetes en la consola de la sección de Kubernetes para supervisar su progreso.

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

Diálogo View logs en la paleta de comandos

El visualizador de registros se abre en una nueva pestaña del editor.

Visor de registros Para 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

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.

Cómo abrir una terminal interactiva

Acciones específicas del recurso

En la sección de Kubernetes, se muestran 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). Con la sección de Kubernetes, puedes realizar acciones únicas en algunos de estos recursos.

Clústeres

  • Agrega un clúster al archivo Kubeconfig: Agrega un clúster de GKE o minikube existente o crea uno nuevo.

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

Cómo elegir la plataforma del clúster

Crea o elige un clúster de GKE

  • Set as active cluster: 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 con el menú contextual

La sección de Kubernetes 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 configurarlo como el contexto actual.

Espacios de nombres

  • Set as active namespace: (Establece 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 establecer como activo.

    Cómo establecer el espacio de nombres como el contexto actual con el menú que aparece cuando se hace clic con el botón derecho

Si esta acción se realiza correctamente, la sección de Kubernetes se actualizará automáticamente y verás un asterisco junto al espacio de nombres que indica que forma 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 deseas crear un contexto para él, usa el comando kubectl config set-context en la terminal para establecer un contexto con el clúster, el usuario y el espacio de nombres que prefieras.

Pods

  • Ver registros: Visualiza registros desde un pod en la sección de la consola de Kubernetes.
  • Obtén una terminal: Obtén una terminal para un pod en la consola de la sección de Kubernetes.

    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 pod que indica que está en buen estado

Contenedores

  • Ver registros: Visualiza registros desde un contenedor en la consola de la sección de Kubernetes.
  • Obtén una terminal: Obtén una terminal para un contenedor en la consola de la sección de Kubernetes.

Implementaciones

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

    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)

En la sección de Kubernetes, se enumeran todas las definiciones de recursos personalizados (CRD) instaladas y disponibles en el clúster:

Lista de definiciones de recursos personalizados en la sección

¿Qué sigue?