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

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, abre una terminal interactiva y buscar descripciones de recursos con el lenguaje sección.

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 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 el archivo Trabaja 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 las sesiones de depuración o crear un 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 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, el 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 Development sessions.

Acciones básicas

La sección Kubernetes se basa en kubectl. Siempre y cuando hayas configuraste tu archivo de configuración kubectl para acceder a tus clústeres, puedes usar En la sección de Kubernetes, para agregar clústeres, explora todos tus recursos espacios de nombres, recursos y nodos para tus clústeres, sin importar si están 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 sus íconos en la Kubernetes:

  • 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 Abrir muestra de Kubernetes Abre una aplicación de ejemplo de Kubernetes
  • play_arrow Ejecuta tu aplicación
  • Ícono Depurar Cómo depurar tu aplicación

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 del recurso con el menú que aparece cuando se hace clic con el botón derecho

Actualiza recursos

La sección Kubernetes detecta los cambios y automáticamente actualizaciones para reflejar los cambios. Forzar una actualización de cualquier recurso de Kubernetes para para recuperar la información más reciente, haz clic con el botón derecho en el recurso y elige Refresh.

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

También puedes forzar una actualización de toda la sección de Kubernetes con el botón para actualizar de la sección 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 Describir. Se abre una terminal y se muestra el recurso información. 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.

Para configurar el inicio, también puedes especificar el siguientes campos de la configuración de cloudcode.kubernetes en tu 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 y mantener la integridad de su 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 lo haga de forma explícita se configura en falso, verdadero de forma predeterminada.
  • portForward: Especifica si se debe redireccionar puertos para los recursos de Kubernetes expuestos en tu 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 tu clúster, selecciona o coloca el cursor recurso para mostrar el Editar YAML y Íconos 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

Visualiza 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 Visualiza los 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

  • Configurar como clúster activo: Configura el clúster especificado como activo de modo que tu el contexto kubectl configurado accede 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

  • Configurar como espacio de nombres activo: configura un espacio de nombres como activo, de modo que tu el contexto kubectl configurado accede 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 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 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

  • Visualizar registros: Visualiza los registros de un Pod en la sección Console 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.
  • Obtener terminal: Obtén la terminal de un contenedor en la consola de la sección de Kubernetes.

Implementaciones

  • Visualiza registros: Visualiza registros de Deployment 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/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 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?