Utiliser l'explorateur Kubernetes

Le volet de l'explorateur Kubernetes vous permet d'accéder aux informations sur vos clusters, nœuds, charges de travail, etc., directement depuis votre IDE. Vous pouvez également définir un contexte actuel, diffuser et afficher les journaux, ouvrir un terminal interactif et examiner les descriptions de ressources avec l'explorateur Kubernetes.

Accéder à l'explorateur Kubernetes

Pour faciliter la gestion des ressources Kubernetes, vous pouvez utiliser l'explorateur Kubernetes, accessible depuis le panneau latéral de droite. Vous pouvez également y accéder via Outils > Cloud Code > Kubernetes > Afficher l'explorateur de cluster.

Panneau de l'explorateur Kubernetes ouvert à l'aide de l'onglet de la barre des tâches de droite

Bien que Cloud Code utilise le fichier kubeconfig par défaut, situé dans le répertoire "$HOME/.kube", pour récupérer les ressources Kubernetes, vous pouvez choisir d'utiliser d'autres fichiers kubeconfig. Pour plus de détails sur la gestion de vos fichiers kubeconfig, consultez la page Utiliser des fichiers kubeconfig supplémentaires.

Actions de base

L'explorateur Kubernetes est fourni par kubectl. Tant que vous avez configuré votre contexte kubectl pour accéder à vos clusters, vous pouvez utiliser l'explorateur Kubernetes pour parcourir l'ensemble des espaces de noms, des ressources et des nœuds disponibles pour vos clusters, indépendamment le contexte actif ou inactif.

Les actions générales de l'explorateur Kubernetes disponibles, accessibles via leurs icônes dans l'explorateur, sont les suivantes:

  • Créer une application Kubernetes à partir d'un exemple Nouvelle application Kubernetes à partir d'un exemple d'icône
  • Actualisation de l'explorateur Icône Actualiser l'explorateur
  • Ouvrir la documentation Cloud Code Kubernetes dans un navigateur Web Icône ouvrir des documents

Copier le nom de la ressource

Vous pouvez copier n'importe quel nom de ressource Kubernetes dans le presse-papiers (y compris les noms des conteneurs et des clusters).Copier un nom de ressource à l'aide du menu contextuel

Actualiser les ressources

L'explorateur Kubernetes détecte les modifications et s'actualise automatiquement pour refléter les mises à jour. Pour forcer l'actualisation d'une ressource Kubernetes, effectuez un clic droit sur la ressource et sélectionnez Refresh (Actualiser). Actualiser un pod à l'aide du menu d'actualisation accessible via un clic droit

Vous pouvez forcer l'actualisation de l'intégralité de l'explorateur à l'aide du bouton d'actualisation de l'explorateur Kubernetes.

Bouton d'actualisation de l'explorateur Kubernetes

Décrire les ressources

Pour afficher les détails d'une ressource hors cluster, sélectionnez Décrire. Cet onglet fournit des informations sur les ressources dans le panneau de la console de l'explorateur Kubernetes.

Pour accéder à la description d'une ressource, effectuez un clic droit sur son nom dans le panneau de l'explorateur Kubernetes, puis choisissez "Describe" (Décrire).

Pour afficher les détails d'une ressource, vous pouvez également cliquer sur n'importe quelle ressource. S'il contient des métadonnées, celles-ci sont disponibles dans le panneau "Détails de la ressource" de l'explorateur Kubernetes.

Afficher les métadonnées des ressources dans le panneau "Resource Details" (Détails des ressources) disponible dans la seconde moitié de l'explorateur Kubernetes

Afficher le fichier YAML distant

Vous pouvez afficher le fichier YAML d'une ressource de votre cluster, directement depuis l'explorateur Kubernetes. Accédez à une ressource dans l'explorateur Kubernetes, par exemple un pod, faites un clic droit sur le nom de la ressource, puis sélectionnez Afficher le fichier YAML distant.

Cela ouvre le fichier YAML correspondant à la ressource spécifiée dans un nouvel onglet de l'éditeur.

Afficher le fichier YAML d'un pod en faisant un clic-droit sur son libellé dans l'explorateur Kubernetes et en sélectionnant "View remote YAML" (Afficher le fichier YAML distant)

Diffuser des journaux

Pour les pods, les conteneurs, les déploiements, les services et les ensembles d'instances dupliquées, vous pouvez diffuser et afficher les journaux de ces ressources dans la console de l'explorateur Kubernetes afin de surveiller leur progression.

Diffusion des journaux d'un pod à l'aide du menu contextuel pour les afficher dans la console de l'explorateur Kubernetes

Lancer un terminal

Pour les pods et les conteneurs, vous pouvez ouvrir un terminal interactif.

Utiliser le menu contextuel d'un pod pour accéder à un terminal interactif dans la console de l'explorateur Kubernetes

Actions spécifiques aux ressources

L'explorateur Kubernetes affiche les clusters, les espaces de noms, les nœuds, les charges de travail (par exemple, les déploiements, les ensembles d'instances dupliquées, les pods et les conteneurs), les services et les entrées, les configurations (telles que les secrets et les mappages de configuration) et le stockage (par exemple, les volumes). L'explorateur Kubernetes vous permet d'effectuer des actions uniques sur certaines de ces ressources.

Clusters

  • Ajoutez un cluster Google Kubernetes Engine: Ajoutez un cluster GKE standard ou Autopilot ou créez-en un en cliquant sur le champAjouter un cluster GKE BoutonIcône Ajouter un cluster Plus dans l'explorateur Kubernetes.

    La boîte de dialogue "Ajouter un cluster GKE" s'affiche, dans laquelle vous pouvez choisir le projet et le cluster que vous souhaitez utiliser. Vous pouvez également créer un cluster et revenir à cette boîte de dialogue.

    Une fois que vous avez terminé, cliquez sur OK et accédez au cluster choisi et à ses ressources sous-jacentes via l'explorateur Kubernetes.

    Ajouter un cluster GKE dans la boîte de dialogue de l'explorateur Kubernetes avec des champs pour les noms de projets et de clusters

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

    Définir un cluster en tant que contexte actuel avec l'explorateur Kubernetes

    Si cette action aboutit, l'explorateur est automatiquement actualisé, et le symbole Kubernetes s'affiche à côté du cluster approprié.

    De plus, si plusieurs contextes sont configurés pour un cluster, vous pouvez choisir l'un des contextes disponibles pour le définir comme contexte actuel.

    Choisir et définir un cluster actif dans une liste de plusieurs contextes avec l'explorateur Kubernetes

Espaces de noms

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

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

    Si cette action aboutit, l'explorateur est automatiquement actualisé, et un astérisque apparaît à côté de l'espace de noms pour indiquer qu'il fait partie du contexte actuel.

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

Pods

  • Diffuser les journaux : diffusez les journaux à partir d'un pod dans la console de l'explorateur Kubernetes.
  • Ouvrir le terminal : obtenez un terminal pour un pod dans la console Kubernetes Explorer.

    De plus, les pods en cours d'exécution sont signalés par des marques d'état colorées à côté de leurs libellés:

    • 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

    L'état du pod est normal, comme l'indique la coche verte située à côté du libellé du pod.

Conteneurs

Déploiements

  • Diffusion de journaux:diffusez les journaux d'un déploiement dans la console Kubernetes Explorer.

    Les déploiements en cours présentent des marques d'état colorées à côté de leurs libellés et du nombre d'instances dupliquées actuelles/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.

    L'état du déploiement est normal, comme indiqué par la coche verte située à côté du libellé du déploiement.

Nœuds

Des nœuds d'état colorés sont associés aux nœuds de votre cluster:

  • 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

L'explorateur Kubernetes répertorie toutes les définitions de ressources personnalisées (CRD) installées et disponibles sur votre cluster:

Liste des définitions de ressources personnalisées dans l'explorateur

Assistance

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

Vous pouvez également rejoindre la chaîne #cloud-code, qui fait partie de la communauté Slack Google Cloud.