Trabaja con YAML de Kubernetes y Google Cloud en Cloud Code para VS Code

Cloud Code para VS Code está diseñado a fin de facilitar la configuración de Kubernetes y Cloud Build mediante el análisis del esquema de lint para valores estructurados y válidos, con errores descriptivos. Cloud Code incluye soluciones listas para usar con esquemas comunes, finalizaciones inteligentes y documentación cuando se coloca el cursor sobre un elemento.

Archivos de configuración YAML compatibles

Cloud Code también admite definiciones de recursos personalizados (CRD) de Kubernetes, como Kubeflow, listas para usar.

Usa el esquema personalizado

Con Cloud Code, puedes proporcionar tu propio esquema de CRD con la configuración cloudcode.yaml.crdSchemaLocations en tu archivo settings.json. Puedes apuntar a un archivo local o a una URL. Las URL que apuntan a github.com se convierten automáticamente en raw.githubusercontent.com.

Extrae el esquema de un clúster

Cuando cambias a un clúster que ejecuta Kubernetes v1.16 y versiones posteriores en Kubernetes Explorer, Cloud Code extrae automáticamente el esquema de todas las CRD instaladas.

Configura con fragmentos

Los fragmentos listos para usar del esquema YAML común (con Command/Ctrl+Space a fin de ver las opciones) facilitan el inicio de un archivo YAML nuevo o lo agregan a uno existente sin errores, sin dejar de seguir las prácticas recomendadas. Cloud Code facilita el trabajo con campos repetitivos, ya que completa las instancias restantes después de completar el primer campo.

Cloud Code ofrece los siguientes fragmentos:

  • Anthos Config Management - Cluster
  • Anthos Config Management - Cluster Selector
  • Anthos Config Management - Config Management
  • Anthos Config Management - Namespace Selector
  • Cloud Build - Cloud Run deployment
  • Cloud Build - Docker container build
  • Cloud Build - GKE deployment
  • Cloud Build - GKE Skaffold deployment
  • Cloud Build - Go build
  • Cloud Build - Terraform plan + apply
  • Config Connector - BigQueryDataset
  • Config Connector - BigQueryTable
  • Config Connector - BigtableCluster
  • Config Connector - BigtableInstance
  • Config Connector - PubSubSubscription
  • Config Connector - PubSubTopic
  • Config Connector - RedisInstance
  • Config Connector - SpannerInstance
  • Kubernetes - ConfigMap
  • Kubernetes - Deployment
  • Kubernetes - Ingress
  • Kubernetes - Pod
  • Kubernetes - Secret
  • Kubernetes - Service
  • Migrate for Anthos - Export
  • Migrate for Anthos - PersistentVolumeClaim
  • Migrate for Anthos - StatefulSet
  • Skaffold - Bazel
  • Skaffold - Getting-started
  • Skaffold - Helm deployment
  • Skaffold - Kaniko

Completa con contexto

Cloud Code te proporcionará finalizaciones contextuales y documentos relevantes que te ayudarán a elegir la opción correcta según el esquema actual.

Parámetros contextuales para el esquema de Kubernetes

Valida el esquema YAML

Cloud Code ofrece asistencia para la validación de esquemas mediante la marcación con etiquetas no válidas y valores en tus archivos YAML, y sugiere correcciones cuando sea posible.

Valor rojo del campo de nombre subrayado para destacar un valor no válido de “1234”; coloca el cursor sobre los estados de texto: "Tipo incorrecto. Se esperaba string”.

Descubre documentación con solo desplazarte sobre un elemento

Cloud Code muestra la documentación relevante cuando mantienes el puntero sobre un valor en el esquema.

Información de la documentación cuando se mantiene el puntero sobre un valor en el esquema

Accede a las definiciones de recursos

Para ver las definiciones de un recurso, haz clic con el botón derecho en el recurso y, luego, elige Go to Definition o Peek Definition.

Aplica un archivo YAML

Para aplicar un cambio de configuración con el archivo actual, abre la Paleta de comandos (haz clic en Ícono Administrar Administrar > Paleta de comandos) y ejecuta Cloud Code: Apply Current/JSON File to K8s Deployed Resource.

Este comando muestra una vista de diferencias para revisar los cambios. Haz clic en Apply cuando se te pregunte si deseas aplicar este cambio. Esto ejecuta kubectl apply -f.

Visualizar las diferencias entre los archivos YAML

Para ver las diferencias entre un archivo YAML en el control de código fuente y uno implementado, abre la Paleta de comandos (haz clic en Ícono Administrar Administrar, Paleta de comandos) y ejecuta Cloud Code: Diff Current JSON/YAML File with K8s Implemented Resource.

Realiza la prueba de validación de un archivo YAML

Para realizar una ejecución de prueba de tu configuración y verificar su validez, abre la Paleta de comandos (haz clic en Ícono Administrar Administrar > Paleta de comandos) y ejecuta Cloud Code: Ejecución de configuración de prueba en el servidor y Cloud Code: Configuración en ejecución de prueba para la validación del cliente.

Esto ejecuta kubectl apply -f dry-run=server (o kubectl apply -f dry-run=client, para la opción cliente) y muestra una validación correcta (o un mensaje de error si tu archivo de configuración no es válido) como una notificación de aviso.

En el siguiente ejemplo, la validación de ejecución de prueba del servidor, hello.deployment.yaml, que se muestra en un servidor y en ejecución, muestra un error cuando se intenta crear una implementación porque el espacio de nombres especificado, random-namespace, no existe.

La validación de la ejecución de prueba del servidor falla en “hello.deployment.yaml” con un mensaje de error como un aviso Los detalles del error se encuentran en el canal de salida; el espacio de nombres (no existe)

Trabaja con secretos

Usar mapas de configuración y secretos es una parte clave de trabajar con Kubernetes. Para ver el contexto de un secreto base64 con Cloud Code, mantén el puntero sobre el secreto a fin de decodificarlo.

Para decodificar el secreto, mantén el puntero sobre el secreto

Obtener asistencia

Para enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.