Utiliser Google Cloud et YAML Kubernetes dans Cloud Code pour VS Code

Cloud Code pour VS Code est conçu pour faciliter la configuration de Kubernetes et Cloud Build en analysant le schéma pour la structure et les valeurs valides, et en fournissant des erreurs descriptives. Cloud Code est fourni avec des solutions prêtes à l'emploi pour les fonctions courantes de schéma, de saisie intelligente et de documentation par survol de la souris.

Fichiers de configuration YAML compatibles

• Config Management
• Cloud Build
• Config Connector
• Istio
• Knative
• Kubernetes
• Kustomize
• Skaffold

Cloud Code est également compatible avec les définitions de ressources personnalisées (CRD) Kubernetes populaires, comme Kubeflow, prêtes à l'emploi.

Utiliser un schéma personnalisé

Avec Cloud Code, vous pouvez fournir votre propre schéma CRD avec le paramètre cloudcode.yaml.crdSchemaLocations dans votre fichier settings.json. 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 passez à un cluster exécutant Kubernetes v1.16 ou version ultérieure dans la vue Kubernetes, Cloud Code extrait automatiquement le schéma de tous les CRD installés.

Configurer avec des extraits

Les extraits prêts à l'emploi pour les schémas YAML courants (la combinaison Command/Ctrl+Space permettant d'afficher les options) facilitent la création de nouveaux fichiers YAML ou l'ajout de sections à des fichiers existants. Ils aident à travailler sans erreur, tout en respectant les bonnes pratiques. Cloud Code facilite l'utilisation des champs répétitifs en remplissant les instances restantes après que vous avez rempli le premier champ.

Cloud Code propose les extraits de code suivants :

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

Compléter avec le contexte

En fonction du schéma actuel, Cloud Code fournit des saisies semi-automatiques contextuelles et des documents pertinents pour vous aider à choisir la bonne option.

Valider le schéma YAML

Cloud Code offre une assistance pour la validation du schéma en signalant les valeurs et les tags non valides dans vos fichiers YAML, et en suggérant des corrections lorsque cela est possible.

Découvrir la documentation au survol

Cloud Code affiche la documentation pertinente lorsque vous pointez sur une valeur du schéma.

Accéder aux définitions de ressources

Pour afficher les définitions d'une ressource, effectuez un clic droit sur la ressource, puis sélectionnez Go to Definition (Accéder à la définition) ou Peek Definition (Aperçu de la définition).

Appliquer un fichier YAML

Pour appliquer une modification de configuration à l'aide du fichier actuel, ouvrez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur Affichage > Palette de commandes), puis exécutez Cloud Code : appliquer le fichier JSON/YAML actuel à la ressource K8s déployée.

Cette commande affiche une vue de comparaison qui vous permet d'examiner les modifications. Cliquez sur Appliquer lorsque vous êtes invité à appliquer la modification. Cela a pour effet d'exécuter kubectl apply -f.

Afficher les 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 déployé, ouvrez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur Affichage > Palette de commandes), puis exécutez Cloud Code : Comparer le fichier JSON/YAML actuel avec la ressource K8s déployée.

Effectuer un dry run d'un fichier YAML

Cloud Code effectue automatiquement des simulations à mesure que vous saisissez des informations dans votre fichier YAML et souligne les erreurs d'une ligne jaune ondulée.

Des lignes ondulées jaunes s'affichent lorsque le serveur considère qu'une partie de votre code est une erreur en fonction du résultat d'un dry run. Cela peut inclure des cas de non-respect des règles, des noms en double ou des validations que Cloud Code n'effectue pas côté client (comme le nombre maximal de ports).

Pour afficher la description de l'erreur dans votre fichier YAML, pointez sur le code souligné en jaune.

Des lignes ondulées rouges s'affichent pour les erreurs détectées avant que Cloud Code ne les vérifie auprès du serveur Kubernetes. Par exemple, si vous saisissez un nombre à la place d'une chaîne, une ligne rouge ondulée s'affiche.

Utiliser des secrets

L'utilisation de cartes de configuration et de secrets est un élément clé de l'utilisation de Kubernetes. Pour afficher le contexte d'un secret base64 avec Cloud Code, pointez sur le secret pour le décoder.

Étapes suivantes

• Créez un fichier de configuration d'exécution Cloud Code Kubernetes skaffold.yaml.
• Créez manuellement une configuration Skaffold pour votre application.
• Consultez la documentation de référence de Skaffold.yaml.

Obtenir de l'aide

Pour envoyer des commentaires, posez une question sur Stack Overflow. Si vous êtes un client Google Cloud, vous pouvez envoyer des demandes via les canaux d'assistance Google Cloud standards.