Descripción general de Cloud Code para VS Code Kubernetes

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

Usa la sección Kubernetes en Cloud Code

En la sección Kubernetes, puedes acceder a información sobre tus clústeres, nodos, cargas de trabajo y mucho 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 en 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 nuevos archivos de Kubeconfig desde la sección de Kubernetes. Los archivos de kubectl 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, consulta la guía Trabaja con archivos kubeconfig.

Accede a la sección 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 las sesiones de depuración o crear una app de ejemplo, expande la sección Development sessions.

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

Accede a la sección Sesiones de desarrollo

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

Cuando inicias una sesión de desarrollo o depuración, la sección Development sessions 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 cuenta con la tecnología de kubectl. Siempre y cuando hayas configurado el archivo de configuración kubectl para acceder a los clústeres, puedes usar la sección Kubernetes para agregar clústeres y explorar todos los espacios de nombres, recursos y nodos disponibles para los clústeres, sin importar si están en el contexto activo o inactivo.

Sección de Kubernetes

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

  • add 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 disponibles de Kubernetes, a las que se puede acceder a través de los íconos en la sección Development sessions, de Kubernetes, son las siguientes:

  • Ícono de Abrir muestra de Kubernetes Abrir 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 elige Copiar nombre del recurso.

Copia el nombre del recurso mediante el menú que aparece cuando se hace clic con el botón derecho

Actualizar recursos

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

Actualiza los Pods usando el menú contextual

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

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

Personaliza la configuración de inicio

Para configurar la ejecución de la aplicación, puedes personalizar el archivo skaffold.yaml.

También puedes configurar el inicio si especificas los siguientes campos en la configuración de cloudcode.kubernetes del 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 deseas detectar cambios en el lugar 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 deseas borrar los recursos de Kubernetes implementados en el clúster después de que se cierre la aplicación. A menos que se configure explícitamente como falso, 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.

Ver YAML remoto

Para ver el YAML de un recurso en el clúster, selecciona o coloca el cursor sobre el recurso para ver 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 registros de los recursos de Kubernetes en la consola de la sección de Kubernetes para supervisar su progreso.

Si quieres abrir el visor de registros, abre la paleta de comandos presionando Ctrl/Cmd+Shift+P o haciendo clic en View > Command Palette y, luego, selecciona Cloud Code: View Logs.

Diálogo View logs en la paleta de comandos

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

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

Visualiza los registros de un Pod

Inicia una terminal

Para los pods y los contenedores, puedes abrir una terminal interactiva si haces clic con el botón derecho en el pod o el contenedor y seleccionas Obtener terminal.

Abre una terminal interactiva

Acciones específicas del recurso

En la sección Kubernetes, se muestran clústeres, espacios de nombres, nodos, cargas de trabajo (como implementaciones, conjuntos de réplicas, pods y contenedores), los servicios y las entradas, los parámetros de configuración (como los secretos y los mapas de configuración) y el almacenamiento (como los volúmenes). En la sección Kubernetes, 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 crear un clúster 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.

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

La sección Kubernetes se actualiza de forma automática 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 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 con el menú contextual

Si esta acción se realiza correctamente, la sección Kubernetes se actualiza 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 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 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 para establecer un contexto con el clúster, el usuario y el espacio de nombres que prefieras.

Pods

  • Visualizar registros: Visualiza los registros de un Pod en la sección Console de Kubernetes.
  • Obtener terminal: Obtén la terminal de un Pod en la consola de la sección 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
Una marca de verificación verde junto al Pod que indica un buen estado

Contenedores

Implementaciones

  • Visualiza registros: Visualiza los registros de una implementación en la consola de la sección 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 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)

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

Lista de definiciones de recursos personalizados en la sección

¿Qué sigue?