Travailler avec des fichiers YAML Google Cloud et Kubernetes dans Cloud Code pour IntelliJ

Cloud Code est conçu pour vous aider à modifier efficacement les fichiers de configuration associés à Google Cloud et à Kubernetes, grâce, entre autres, à la validation basée sur des schémas, aux diagnostics et à la documentation rapide.

Remarque : Pour des raisons de compatibilité, les fonctionnalités d'édition des fichiers Kubernetes sont automatiquement désactivées si le plug-in JetBrains Kubernetes est détecté. Vous pouvez les réactiver manuellement dans le menu des paramètres de Cloud Code en accédant à Cloud Code > Kubernetes > Kubernetes editing features (fonctionnalités d'édition Kubernetes), puis en activant le paramètre Enable Kubernetes YAML configuration editing features (Activer les fonctionnalités d'édition des fichiers de configuration YAML pour Kubernetes). Ces dispositions pour raison de compatibilité ne concernent que les fichiers YAML pour Kubernetes. Compatibilité avec d'autres types de configuration YAML les types de fichiers tels que Skaffold ne sont pas concernés.

Remarque :La modification du code YAML de Cloud Build n'est disponible que pour les fichiers nommé cloudbuild.yaml

Fichiers de configuration YAML compatibles

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

Cloud Code est également compatible avec les CRD Kubernetes courants, comme Kubeflow, prêt à l'emploi.

Remarque :Pour utiliser l'agrégation de ressources la plus récente, vous devez disposer de la dernière version version de Cloud Code.

Activer ou désactiver la compatibilité avec YAML

Pour activer ou désactiver la compatibilité avec YAML, accédez à Fichier > Paramètres > Outils > Gemini + Google Cloud Code > Kubernetes (pour Windows et Linux) ou IntelliJ IDEA > Paramètres > Outils > Gemini + Google Cloud Code > Kubernetes (pour macOS), puis cochez ou décochez les cases Cochez la case Enable YAML support (Activer la compatibilité avec YAML) pour activer ou désactiver la fonctionnalité.

Utiliser un schéma personnalisé

Avec Cloud Code, vous pouvez fournir votre propre schéma CRD avec IntelliJ accédez à Fichier > Paramètres > Outils > Gemini + Google Cloud Code > Kubernetes (pour Windows et Linux) ou IntelliJ IDEA > Paramètres > Outils > Gemini + Google Cloud Code > Kubernetes (pour macOS), puis reportez-vous au schéma CRD emplacements.

Vous pouvez le faire pointer vers un fichier local ou une URL. Les URL pointant vers github.com sont automatiquement converties en raw.githubusercontent.com.

Extraire le schéma d'un cluster

Lorsque vous basculez vers un cluster exécutant Kubernetes v1.16+ dans la Explorateur Kubernetes, Cloud Code extrait automatiquement le schéma de tous les objets CRD installés.

Assistance Skaffold supplémentaire

Skaffold est le moteur sous-jacent Cloud Code vous aide à créer, transférer et déployer votre application. et permet de créer des pipelines CI/CD.

Cloud Code fournit une assistance supplémentaire pour la gestion des fichiers de configuration Skaffold. Lorsque vous ouvrez un projet, Cloud Code détecte les schémas Skaffold qui ne sont pas à jour et qui vous invitent (via le journal des événements) ; Lorsqu'une mise à niveau de la version du schéma Skaffold est disponible pour votre Skaffold existant de configuration YAML.

Vous pouvez également accéder à Outils > Gemini + Cloud Code > Kubernetes > Vérifier les schémas Skaffold Mises à niveau pour rechercher les mises à niveau de schéma disponibles.

Configurer avec des extraits

Extraits de code prêts à l'emploi pour les schémas YAML courants (en utilisant Ctrl+Espace pour les options d'affichage) vous permettent de créer un fichier YAML ou d'ajouter des fichiers à un fichier existant sans erreur, tout en respectant les bonnes pratiques. De plus, il est plus facile pour travailler avec des champs répétitifs ; à remplir un seul, et Cloud Code remplit les instances restantes.

Cloud Code propose les extraits de code suivants :

• 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

Complétez avec le contexte

Sur la base du schéma actuel, Cloud Code fournit des informations pour vous aider à choisir la bonne option.

Valider le schéma YAML

Cloud Code permet la validation de schéma en signalant les erreurs des balises et des valeurs dans vos fichiers YAML et suggérer des corrections lorsque cela est possible.

Valider les fichiers YAML Skaffold

Cloud Code fournit des options supplémentaires pour modifier le fichier de configuration Skaffold et des modèles intelligents qui vous permettent de valider vos skaffold.yaml . Consultez ce guide sur l'utilisation d'une application existante avec Cloud Code.

Compléter les fichiers de configuration Skaffold avec le contexte

Sur la base du schéma actuel, Cloud Code fournit des informations des informations complètes et de la documentation pertinente pour vous aider à choisir la bonne option.

Découvrez des définitions grâce à une documentation rapide

Cloud Code fournit la documentation pertinente à une ressource lorsque vous mettez en surbrillance une ligne de votre fichier de configuration et accédez à View (Afficher). > Documentation rapide.

Lint YAML pour les problèmes de structure et de validité

Cloud Code fournit une assistance lint pour les problèmes de schéma courants. et fournit des erreurs descriptives.

Appliquer un fichier YAML

Pour exécuter kubectl apply -f afin d'appliquer une modification de configuration à l'aide de la méthode vous pouvez utiliser l'icône d'actions kubectl , disponible dans la marge de votre IDE, puis sélectionnez Apply (Appliquer). Cela fait apparaître une différence pour examiner les modifications avant de cliquer sur Appliquer.

Différences entre les fichiers YAML

Pour afficher les différences entre un fichier YAML dans le contrôle du code source et un fichier YAML, vous pouvez utiliser l'icône d'actions kubectl disponible dans la marge de votre éditeur. Sélectionnez l'option Diff (Différence) pour afficher les différences. pour comparer deux fichiers de schéma.

Effectuer une simulation d'un fichier YAML

Pour effectuer une simulation de votre fichier et vérifier sa validité, vous pouvez utiliser le Icône des actions kubectl , disponible dans la marge de votre IDE, sélectionnez Dry run on Server (Effectuer un test à blanc sur serveur). ou Dry run on Client (Exécuter une simulation sur le client). Cette opération exécute kubectl apply -f dry-run=server (ou kubectl apply -f dry-run=client pour l'option Client) et vous avertit si votre fichier peut être créé dans votre fenêtre de terminal.

Étape suivante

• Créez un Configuration d'exécution Kubernetes dans Cloud Code skaffold.yaml.
• Créer manuellement un Configuration Skaffold pour votre application.
• Consultez le Documentation de référence sur Skaffold.yaml

Obtenir de l'aide

Pour envoyer des commentaires ou signaler un problème dans votre IDE IntelliJ, accédez à Outils > Cloud Code > Aide / À propos > Envoyer des commentaires ou signaler un problème pour signaler un problème sur GitHub, ou posez une question sur Stack Overflow.