Présentation de Cloud Code for VS Code Kubernetes

Cette page présente le développement Kubernetes dans Cloud Code.

Utiliser la section "Kubernetes" dans Cloud Code

La section Kubernetes vous permet d'accéder à des informations clusters, nœuds, charges de travail et plus encore, directement depuis votre IDE. Vous pouvez aussi définir un contexte actuel, diffuser et consulter les journaux, Ouvrez un terminal interactif. rechercher les descriptions de ressources avec l'API Kubernetes, .

Section Kubernetes dans Cloud Code

Cloud Code utilise le fichier kubeconfig par défaut, situé sous le répertoire $HOME/.kube sous macOS/Linux ou %USERPROFILE%\.kube sous Windows, permettant de récupérer des ressources Kubernetes. Vous pouvez changer de fichier ou en ajouter de nouveaux depuis la section Kubernetes. Les fichiers Kubeconfig sont des fichiers YAML contenant les détails, le certificat et le jeton secret de votre cluster Kubernetes à s'authentifier auprès du cluster.

Pour utiliser un fichier kubeconfig autre que le fichier kubeconfig par défaut, reportez-vous à la Utiliser les fichiers kubeconfig.

Accéder à la section Kubernetes

Pour afficher et gérer vos ressources Kubernetes, accédez à la console d'administration Kubernetes en cliquant sur Cloud Code, puis en développant la section Kubernetes. Pour afficher les sessions de débogage ou créer un application exemple, développez la section Sessions de développement.

Lors d'une tentative de débogage, vous pouvez être invité à authentifier vos identifiants pour exécuter et déboguer une application localement.

Accéder à la section "Sessions de développement"

Utilisez les sessions de développement pour exécuter ou déboguer votre application Kubernetes, ou créer un exemple d'application à l'aide d'un modèle.

Lorsque vous démarrez une session de développement ou de débogage, La section Sessions de développement affiche la vue de journalisation structurée.

Volet des sessions de développement

Pour accéder aux sessions de développement, cliquez sur Cloud Code. développez la section Sessions de développement.

Actions de base

La section Kubernetes est alimentée par kubectl. Tant que vous avez configuré votre fichier de configuration kubectl pour accéder à vos clusters, vous pouvez utiliser section Kubernetes pour ajouter des clusters, parcourez tous vos clusters disponibles des espaces de noms, des ressources et des nœuds pour vos clusters, qu'ils se trouvent le contexte actif ou inactif.

Section Kubernetes

Les actions Kubernetes générales disponibles, accessibles via leurs icônes dans le Kubernetes, sont:

  • ajouter KubeConfig
  • refresh. Actualisez la page Section Kubernetes
  • question_mark Ouvrez le Documentation Kubernetes Cloud Code dans un navigateur Web

Section "Sessions de développement"

Les actions Kubernetes disponibles, accessibles via leurs icônes dans le Sessions de développement Kubernetes:

  • Icône Ouvrir l'exemple Kubernetes Ouvrir un exemple d'application Kubernetes
  • play_arrow Exécuter votre application
  • Icône de débogage Déboguer votre application

Copier un nom de ressource

Vous pouvez copier n'importe quel nom de ressource Kubernetes dans le presse-papiers (y compris les noms et les noms des clusters). Pour copier le nom d'une ressource, effectuez un clic droit sur la ressource, puis sélectionnez Copier le nom de la ressource.

Copier le nom de la ressource à l'aide du menu contextuel

Actualiser les ressources

La section Kubernetes surveille les modifications et analyse automatiquement s'actualise pour refléter les mises à jour. Pour forcer l'actualisation d'une ressource Kubernetes récupérer ses dernières informations, effectuer un clic droit sur la ressource et sélectionner Refresh (Actualiser).

Actualiser les pods à l'aide du menu contextuel

Vous pouvez aussi forcer l'actualisation de toute la section Kubernetes. en utilisant le bouton d'actualisation de la section Kubernetes ; Bouton d'actualisation de la section Kubernetes

Décrire les ressources

Pour afficher les détails d'une ressource hors cluster, effectuez un clic droit sur la ressource, puis sélectionnez Décrire. Un terminal s'ouvre et affiche la ressource des informations. Décrire les détails de la ressource dans le menu contextuel

Personnaliser votre configuration de lancement

Pour configurer l'exécution de votre application, vous pouvez personnaliser votre skaffold.yaml.

Vous pouvez également configurer votre lancement en spécifiant les champs suivants dans la configuration cloudcode.kubernetes de votre fichier .vscode/launch.json :

  • skaffoldConfig : spécifiez le fichier de configuration skaffold, qui contient les paramètres de compilation et de déploiement.
  • profil : indiquez votre profil skaffold préféré. S'il n'est pas défini, le profil par défaut est utilisé.
  • imageRegister : spécifiez le registre d'images vers lequel transférer les images.
  • watch : spécifiez s'il faut surveiller les modifications apportées à l'espace de travail et réexécuter l'application. À moins qu'il ne soit défini explicitement sur "false", "true" par défaut.
  • cleanUp : spécifiez s'il faut supprimer les ressources Kubernetes déployées dans le cluster après l'arrêt de l'application. À moins qu'il ne soit défini explicitement sur "false", "true" par défaut.
  • portForward : spécifiez s'il faut transférer les ports des ressources Kubernetes exposées de votre cluster vers votre ordinateur local. À moins qu'il ne soit défini explicitement sur "false", "true" par défaut.

Afficher le fichier YAML distant

Pour afficher le fichier YAML d'une ressource de votre cluster, sélectionnez ou pointez sur pour afficher la ressource Modifier YAML et Afficher les icônes YAML Sélectionnez le bouton Afficher YAML pour ouvrir le fichier YAML. correspondant à la ressource spécifiée dans un nouvel onglet de l'éditeur.

Fichier YAML du pod Kubernetes ouvert à l'aide de l'icône Afficher YAML

Voir les journaux

Vous pouvez diffuser et afficher les journaux des ressources Kubernetes dans le pour suivre leur progression.

Pour ouvrir la visionneuse de journaux, ouvrez la palette de commandes en appuyant sur Ctrl/Cmd+Shift+P ou en cliquant sur Affichage > Palette de commandes, puis sélectionnez Cloud Code: afficher les journaux

Boîte de dialogue "Afficher les journaux" dans la palette de commandes

La visionneuse de journaux s'ouvre dans un nouvel onglet de l'éditeur.

Visionneuse de journaux Pour afficher les journaux d'un pod ou d'un conteneur, effectuez un clic droit sur la ressource et sélectionnez Affichez les journaux.

Afficher les journaux d'un pod

Lancer un terminal

Pour les pods et les conteneurs, vous pouvez ouvrir un terminal interactif en effectuant un clic droit le pod ou le conteneur, puis sélectionnez Obtenir un terminal.

Ouvrir un terminal interactif

Actions spécifiques sur les ressources

La section "Kubernetes" affiche les clusters, les espaces de noms, les nœuds et les charges de travail (déploiements, ensembles d'instances répliquées, pods et conteneurs), de services et d'entrées de configuration (secrets et mappages de configuration, par exemple) et de stockage (volumes, par exemple). La section Kubernetes vous permet d'effectuer des actions uniques sur certaines de ces ressources.

Clusters

  • Ajouter un cluster à Kubeconfig:ajoutez un cluster GKE ou minikube existant ou créez-en une.

La boîte de dialogue "Ajouter un cluster" s'affiche. Vous pouvez choisir le projet et le cluster. que vous souhaitez utiliser ou créer un cluster.

Choisir la plate-forme du cluster

Créer ou choisir un cluster GKE

  • Définir en tant que cluster actif:définissez le cluster spécifié comme actif de sorte que vos Le contexte kubectl configuré accède à ce cluster par défaut.

    Définir le cluster comme actif à l'aide du menu contextuel

La section Kubernetes s'actualise automatiquement et affiche Kubernetes à côté du cluster approprié.

Si plusieurs contextes sont configurés sur un cluster, vous pourrez pour choisir l'un des contextes disponibles à définir comme contexte actuel.

Espaces de noms

  • Définir comme espace de noms actif:définissez un espace de noms comme actif, de sorte que votre Le contexte kubectl configuré accède à cet espace de noms par défaut.

    Effectuez un clic droit sur l'espace de noms que vous souhaitez définir comme actif.

    Définir l'espace de noms comme contexte actuel à l'aide du menu contextuel

Si cette action aboutit, la section Kubernetes est actualisée automatiquement. Un astérisque s'affiche à côté de l'espace de noms pour indiquer cela fait partie du contexte actuel.

Notez qu'un contexte Kubernetes est un raccourci qui vous donne un accès rapide à un espace de noms de votre cluster. Les contextes sont normalement créés automatiquement lorsque vous démarrez un minikube ou un cluster GKE. Si vous ne voyez pas l'option Définir comme contexte actuel pour un espace de noms donné et souhaitez créer un contexte, utilisez Commande kubectl config set-context dans votre terminal pour définir un contexte avec le cluster, l'utilisateur et espace de noms.

Pods

  • Afficher les journaux:affichez les journaux d'un pod dans la console de la section Kubernetes.
  • Get Terminal (Obtenir le terminal) : obtient le terminal d'un pod dans la console de la section Kubernetes.

    Par ailleurs, les libellés de pods en cours d'exécution sont associés à des marques d'état colorées :

    • Rouge : le pod a échoué
    • Jaune : le pod démarre ou se termine
    • Vert : le pod est opérationnel et en cours d'exécution
Coche verte à côté du pod indiquant l'état de fonctionnement

Conteneurs

Déploiements

  • Afficher les journaux:Afficher les journaux d'un déploiement dans la console de la section Kubernetes.

    Les déploiements en direct présentent des marques d'état colorées situées à côté de leurs libellés et du nombre d'instances dupliquées actives/totales :

    • Jaune : le déploiement ne présente pas de disponibilité minimale ni de problèmes d'image.
    • Vert : le déploiement est opérationnel et sa disponibilité minimale.
Icônes de déploiement vertes indiquant un état opérationnel

Nœuds

Les nœuds de votre cluster sont signalés par des marques d'état colorées situées à côté de leurs noms :

  • Jaune : le nœud présente un problème de ressource, au niveau de la mémoire ou de la disponibilité du disque.
  • Vert : le nœud est opérationnel.

Définitions de ressources personnalisées

La section Kubernetes répertorie toutes les définitions de ressources personnalisées (CRD, Custom Resource Definition). installé et disponible sur votre cluster:

Liste des définitions de ressources personnalisées dans la section

Étape suivante