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 desde tu IDE. También puedes configurar un contexto actual, transmitir y ver registros, abrir una terminal interactiva y buscar descripciones de recursos con la sección de Kubernetes.
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 Kubeconfig
desde la sección de Kubernetes. 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, 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 debas autenticar tus credenciales para ejecutar y depurar una aplicación de forma local.
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 ejemplo mediante una plantilla.
Cuando inicias una sesión de desarrollo o depuración, la sección Development sessions muestra la vista de registro estructurada.
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 cuenta con la tecnología de kubectl
. Siempre y cuando hayas configurado tu archivo de configuración kubectl
para acceder a tus clústeres, puedes usar la sección Kubernetes a fin de agregar clústeres y explorar todos los espacios de nombres, recursos y nodos disponibles para tus clústeres, sin importar si se encuentran en el contexto activo o inactivo.
Sección de Kubernetes
Las acciones generales de Kubernetes disponibles, a las que se puede acceder mediante sus íconos en la sección de Kubernetes, son las siguientes:
- add KubeConfig
- Actualizar: Actualiza la sección de 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 Development sessions, son las siguientes:
- Abrir una aplicación de muestra de Kubernetes
- play_arrow Ejecuta tu aplicación.
- 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.
Actualizar recursos
La sección Kubernetes observa los cambios y se actualiza automáticamente para reflejar los cambios. Para forzar la actualización de cualquier recurso de Kubernetes con el fin de recuperar la información más reciente, haz clic con el botón derecho en el recurso y selecciona Actualizar.
También puedes forzar la actualización de toda la sección de Kubernetes con el botón de actualización de la sección 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 abrirá una terminal en la que se mostrará la información del recurso.Personaliza tu configuración de inicio
Para configurar la forma en que se ejecuta tu aplicación, puedes personalizar el archivo skaffold.yaml
.
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 se observarán cambios en el lugar de trabajo y se 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 finalice la aplicación. A menos que se establezca en falso de forma explícita, el valor predeterminado es verdadero.
- portForward: Especifica si deseas reenviar puertos para los recursos expuestos de Kubernetes 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 tu clúster, selecciona el recurso o coloca el cursor sobre él de modo que se muestren 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.Ver registros
Puedes transmitir y ver los registros desde los recursos de Kubernetes hacia la consola de secciones de Kubernetes para supervisar su progreso.
Para abrir el visor de registros, presionaCtrl/Cmd+Shift+P
o haz clic en Ver > Paleta de comandos para abrir la paleta de comandos y, luego, selecciona Cloud Code: View Logs.
El visor de registros se abrirá en una nueva pestaña del editor.
Para ver los registros de un Pod o un contenedor, haz clic con el botón derecho en el recurso y selecciona Ver registros.
Inicia 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 Obtener terminal.
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), servicios y entradas, configuraciones (como secretos y mapas de configuración) y almacenamiento (como volúmenes). Mediante la sección de 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 Agregar clúster y podrás elegir el proyecto y el clúster que te gustaría usar o crear uno nuevo.
Configurar como clúster activo (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.
La sección 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
Establecer 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.
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 Set as current context de un espacio de nombres determinado y quieres crear un contexto para él, usa el comando kubectl config set-context
en la terminal a fin de establecer un contexto con el clúster, el usuario y el espacio de nombres que prefieras.
Pods
- Ver registros: Visualiza los registros de un Pod en la consola de la sección de Kubernetes.
Obtener terminal: Obtén la terminal de un Pod en la sección de Kubernetes de la consola.
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
Contenedores
- Ver registros: Visualiza los registros de un contenedor en la consola de secciones de Kubernetes.
- Obtener terminal: Obtén la terminal de un contenedor en la consola de secciones de Kubernetes.
Implementaciones
Ver registros: Visualiza los registros de una implementación en la consola de secciones de 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.
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:
¿Qué sigue?
- Comienza a usar Cloud Code para VS Code para Kubernetes. Para ello, crea e implementa una aplicación de Kubernetes a partir de una muestra de código.
- Usa la sincronización de archivos y la recarga en caliente para acelerar el desarrollo.
- Depura tu aplicación en Cloud Code