Cette page présente le développement Kubernetes dans Cloud Code.
Utiliser l'explorateur Kubernetes dans Cloud Code
L'explorateur Kubernetes vous permet d'accéder aux informations sur vos clusters, nœuds, charges de travail et plus encore, directement depuis votre IDE. Avec l'explorateur Kubernetes, vous pouvez également définir un contexte actuel, diffuser et afficher les journaux, ouvrir un terminal interactif et rechercher des descriptions de ressources.
![Explorateur Kubernetes Cloud Code](https://cloud.google.com/static/code/docs/shell/images/shell-dev-cluster-k8s-sections.png?hl=fr)
Cloud Code utilise le fichier kubeconfig par défaut, situé dans le répertoire $HOME/.kube
sous macOS/Linux ou %USERPROFILE%\.kube
sous Windows, pour récupérer les ressources Kubernetes. Vous pouvez basculer ou ajouter des fichiers Kubeconfig
à partir de l'explorateur Kubernetes. Les fichiers Kubeconfig sont des fichiers YAML contenant les détails, le certificat et le jeton secret de votre cluster Kubernetes pour l'authentification auprès du cluster.
Pour utiliser un fichier kubeconfig autre que le fichier kubeconfig par défaut, consultez le guide Utiliser des fichiers kubeconfig.
Accéder à l'explorateur Kubernetes
Pour afficher et gérer vos ressources Kubernetes, accédez à l'explorateur Kubernetes en cliquant surAccéder à la section "Sessions de développement"
Utilisez les sessions de développement pour exécuter ou déboguer votre application Kubernetes, ou créez 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.
Actions de base
L'explorateur Kubernetes est fourni par kubectl
. Tant que vous avez configuré votre fichier de configuration kubectl
pour accéder à vos clusters, vous pouvez utiliser l'explorateur Kubernetes pour ajouter des clusters et parcourir tous les espaces de noms, ressources et nœuds disponibles pour vos clusters, qu'ils se trouvent dans le contexte actif ou inactif.
Section Clusters
Les actions Kubernetes générales disponibles, accessibles via leurs icônes dans la section Clusters de l'explorateur Kubernetes, sont les suivantes:
- add Ajoutez un cluster à KubeConfig.
- refresh : Actualiser l'explorateur Kubernetes
- question_mark Ouvrir la documentation Kubernetes Cloud Code dans un navigateur Web
Section "Sessions de développement"
Les actions Kubernetes disponibles, accessibles via les icônes correspondantes dans la section Sessions de développement de Kubernetes, sont les suivantes:
Ouvrir un exemple d'application Kubernetes
- play_arrow Exécuter l'application
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 des conteneurs et des clusters). Pour copier le nom d'une ressource, effectuez un clic droit sur la ressource et choisissez Copier le nom de la ressource.
![Copier le nom de la ressource à l'aide du menu contextuel](https://cloud.google.com/static/code/docs/shell/images/shell-copy-resource-name.png?hl=fr)
Actualiser les ressources
L'explorateur Kubernetes surveille les modifications et s'actualise automatiquement en conséquence. Pour forcer l'actualisation d'une ressource Kubernetes afin d'extraire ses dernières informations, effectuez un clic droit sur la ressource et choisissez Refresh (Actualiser).
![Actualiser les pods à l'aide du menu contextuel](https://cloud.google.com/static/code/docs/shell/images/shell-refresh-resource.png?hl=fr)
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 les informations sur la ressource.![Décrire les détails de la ressource dans le menu contextuel](https://cloud.google.com/static/code/docs/shell/images/shell-describe-resource.png?hl=fr)
Personnaliser votre configuration de lancement
Pour configurer l'exécution de votre application, vous pouvez personnaliser le fichier skaffold.yaml
.
Afficher le fichier YAML distant
Pour afficher le fichier YAML d'une ressource de votre cluster, sélectionnez ou pointez sur la ressource pour afficher les icônes![](https://cloud.google.com/static/code/docs/vscode/images/vscode-edit-yaml-icon.png?hl=fr)
![](https://cloud.google.com/static/code/docs/vscode/images/vscode-view-yaml-icon.png?hl=fr)
![Fichier YAML du service Kubernetes ouvert à l'aide de l'icône Afficher YAML](https://cloud.google.com/static/code/docs/shell/images/shell-view-yaml.png?hl=fr)
Afficher les journaux
Vous pouvez diffuser et afficher les journaux des ressources Kubernetes dans la console de l'explorateur Kubernetes pour surveiller leur progression.
Pour ouvrir la visionneuse de journaux, ouvrez la palette de commandes en appuyant surCtrl/Cmd+Shift+P
ou en cliquant sur Affichage > Palette de commandes, puis sélectionnez Cloud Code: Afficher les journaux.
La visionneuse de journaux s'ouvre dans un nouvel onglet de l'éditeur.
Pour afficher les journaux d'un pod ou d'un conteneur, effectuez un clic droit sur la ressource et sélectionnez Afficher les journaux.
Lancer un terminal
Pour les pods et les conteneurs, vous pouvez ouvrir un terminal interactif en effectuant un clic droit sur le pod ou le conteneur, puis en sélectionnant Get terminal (Obtenir un terminal).
![Ouvrir un terminal interactif](https://cloud.google.com/static/code/docs/shell/images/shell-get-terminal.png?hl=fr)
Actions spécifiques sur les ressources
L'explorateur Kubernetes affiche les clusters, les espaces de noms, les nœuds, les charges de travail (telles que les déploiements, les ensembles d'instances répliqué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 (tels que les volumes). L'explorateur Kubernetes vous permet d'effectuer des actions uniques sur certaines de ces ressources.
Clusters
- Ajouter un cluster au kubeconfig:ajoutez un cluster GKE ou minikube existant, ou créez-en un.
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](https://cloud.google.com/static/code/docs/shell/images/shell-cluster-choose-platform.png?hl=fr)
Définir en tant que cluster actif:définissez le cluster spécifié comme actif de sorte que le contexte
kubectl
que vous avez configuré accède à ce cluster par défaut.
L'explorateur Kubernetes s'actualise automatiquement et le symbole Kubernetes s'affiche à côté du cluster approprié.
Si plusieurs contextes sont configurés sur un cluster, vous pouvez 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 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.
Notez qu'un 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 minikube ou un cluster 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 celui-ci, exécutez la commande kubectl config set-context
dans votre terminal pour définir un contexte avec le cluster, l'utilisateur et l'espace de noms de votre choix.
Pods
- Afficher les journaux:affichez les journaux d'un pod dans la console de l'explorateur Kubernetes.
Ouvrir le terminal : obtenez un terminal pour un pod dans la console Kubernetes Explorer.
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](https://cloud.google.com/static/code/docs/vscode/images/vscode-pod-status-green.png?hl=fr)
Des conteneurs
- Affichez les journaux:affichez les journaux d'un conteneur dans la console de l'explorateur Kubernetes.
- Obtenir le terminal:accédez au terminal d'un conteneur dans la console de l'explorateur Kubernetes.
Déploiements
Afficher les journaux:affichez les journaux d'un déploiement dans la console de l'explorateur 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](https://cloud.google.com/static/code/docs/vscode/images/vscode-deploy-status-green.png?hl=fr)
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
L'explorateur Kubernetes va répertorier 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](https://cloud.google.com/static/code/docs/vscode/images/vscode-crd-list.png?hl=fr)
Étapes suivantes
- Faites vos premiers pas avec Cloud Code pour Cloud Shell pour Kubernetes en créant et en déployant une application Kubernetes à partir d'un exemple de code.
- Utilisez la synchronisation des fichiers et le hot reload pour accélérer le développement.
- Déboguer votre application dans Cloud Code