Trabaja con archivos YAML de Google Cloud y Kubernetes en Cloud Code para IntelliJ

Cloud Code está diseñado para ayudar a editar archivos de configuración relacionados con Google Cloud y Kubernetes, incluidos los diagnósticos, la validación basada en esquemas y la documentación rápida.

Nota: Por razones de compatibilidad, las funciones de edición de Kubernetes se inhabilitan de forma automática si se detecta el complemento de Kubernetes para JetBrains. Anula esto de forma manual en el menú de configuración de Cloud Code. Para ello, navega a Cloud Code > Kubernetes > Funciones de edición de Kubernetes y activa o desactiva la configuración Habilitar las funciones de edición de configuración YAML de Kubernetes. Estas medidas de compatibilidad solo afectan a los archivos YAML de Kubernetes. La compatibilidad con otros tipos de archivos de configuración YAML, como Skaffold, no se ve afectada.

Nota: La compatibilidad con la edición de YAML de Cloud Build solo está disponible para los archivos llamados cloudbuild.yaml

Archivos de configuración YAML compatibles

• Anthos Config Management
• Cloud Build
• Config Connector
• Knative
• Kubernetes
• Kustomize
• Migrate to Containers
• Skaffold

Cloud Code también admite CRD de Kubernetes populares, como Kubeflow, listas para usar.

Nota: Para usar la agregación de recursos más reciente, necesitarás la versión más reciente de Cloud Code.

Habilitar o inhabilitar la compatibilidad con YAML

Para habilitar o inhabilitar la compatibilidad con YAML, ve a Archivo > Configuración > Herramientas > Gemini + Google Cloud Code > Kubernetes (para Windows y Linux) o IntelliJ IDEA > Configuración > Herramientas > Gemini + Google Cloud Code , y desmarca la casilla de verificación para admitir macOS> Google Cloud Code o, y habilitar Gemini + Google Cloud Code.>

Usar esquema personalizado

Con Cloud Code, puedes proporcionar tu propio esquema de CRD con la configuración de IntelliJ. Para ello, navega a Archivo > Configuración > Herramientas > Gemini + Google Cloud Code > Kubernetes (para Windows y Linux) o IntelliJ IDEA > Configuración > Herramientas> Esquema de Google Cloud> Gemini Cloud Code y Google Cloud Code.>

Puedes apuntar a un archivo local o a una URL. Las URL que apuntan a github.com se convierten de forma automática en raw.githubusercontent.com.

Extraer esquema de un clúster

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

Asistencia adicional con Skaffold

Skaffold es el motor subyacente de Cloud Code, que te ayuda a compilar, enviar y, también, implementar tu aplicación, además de proporcionar asistencia para la creación de canalizaciones de CI/CD.

Cloud Code incluye asistencia adicional para la administración de archivos de configuración de Skaffold. Cuando abres un proyecto, Cloud Code detecta esquemas de Skaffold que no están actualizados y te muestra (a través del registro de eventos) cuando hay una actualización de la versión del esquema de Skaffold disponible para tus archivos de configuración YAML existentes de Skaffold.

Como alternativa, puedes navegar a Herramientas > Gemini + Cloud Code > Kubernetes > Check for Skaffold Schemas Upgrades (Buscar actualizaciones de esquemas de Skaffold) para ver las actualizaciones de esquema disponibles.

Configurar con fragmentos

Los fragmentos listos para usar del esquema YAML común (con Ctrl + Espacio para ver las opciones) te permiten iniciar un archivo YAML nuevo o agregarlo a uno existente sin errores, sin dejar de seguir las prácticas recomendadas. Además, es más fácil trabajar con campos repetitivos; si completas uno, Cloud Code llenará las instancias restantes.

Cloud Code ofrece los siguientes fragmentos:

• 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 - Service
• Migrate to Containers - Export
• Migrate to Containers - PersistentVolumeClaim
• Migrate to Containers - StatefulSet
• Skaffold - Bazel
• Skaffold - Getting-started
• Skaffold - Helm deployment
• Skaffold - Kaniko

Completar con contexto

Según el esquema actual, Cloud Code proporciona respuestas contextuales para ayudarte a elegir la opción correcta.

Validar el esquema YAML

Cloud Code ofrece compatibilidad con la validación de esquemas mediante el marcado de etiquetas y valores no válidos en los archivos YAML y la sugerencia de correcciones cuando es posible.

Valida los archivos YAML de Skaffold

Cloud Code proporciona compatibilidad adicional con la edición de archivos de configuración de Skaffold y plantillas inteligentes que te permiten validar tus archivos skaffold.yaml. Consulta esta guía sobre cómo usar una app existente con Cloud Code.

Completa los archivos de configuración de Skaffold con contexto

Cloud Code proporciona datos completados contextuales y documentación relevante según el esquema actual para ayudarte a elegir la opción correcta.

Descubre definiciones con la documentación rápida

Cloud Code muestra la documentación relevante para un recurso cuando destacas una línea en tu archivo de configuración y navegas a Ver > Documentación rápida.

Analiza YAML con lint para detectar problemas de estructura y validez.

Cloud Code proporciona asistencia de análisis con lint en torno a problemas comunes del esquema y proporciona errores descriptivos.

Aplica un archivo YAML

Para ejecutar kubectl apply -f a fin de aplicar un cambio de configuración con el archivo actual, puedes usar el ícono de acciones de kubectl , disponible en el margen del IDE, y seleccionar Apply. Aparecerá una vista de diferencias para que revises los cambios antes de hacer clic en Apply.

Diferencias entre archivos YAML

Para ver las diferencias entre un archivo YAML en el control de código fuente y un archivo YAML implementado, puedes usar el ícono de acciones de kubectl disponible en el margen del editor. Selecciona la opción Diferencia para obtener una vista de diferencias a fin de comparar y contrastar dos archivos de esquema.

Realiza una ejecución de prueba de un archivo YAML

Para realizar una ejecución de prueba de tu archivo y verificar su validez, puedes usar el ícono de acciones de kubectl , disponible en el margen de tu IDE, para seleccionar Ejecución de prueba en el servidor o Ejecución de prueba en cliente. Esto ejecuta kubectl apply -f dry-run=server (o kubectl apply -f dry-run=client, para la opción Cliente) y te notifica si tu archivo se puede crear correctamente en la ventana de tu terminal.

¿Qué sigue?

• Crea un archivo skaffold.yaml de configuración de ejecución de Kubernetes de Cloud Code.
• Crea de forma manual una configuración de Skaffold para tu aplicación.
• Consulta los documentos de referencia de Skaffold.yaml.

Obtenga asistencia

Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve aTools >Cloud Code >Help / About >Envía comentarios o informa un problema para informar un problema en GitHub o hacer una pregunta en Stack Overflow.