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 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, l'explorateur de données.
![Explorateur Kubernetes Cloud Code](https://cloud.google.com/static/code/docs/intellij/images/kubernetes-explorer-panel.png?authuser=7&hl=fr)
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 l'explorateur 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 à l'explorateur Kubernetes
Pour afficher et gérer vos ressources Kubernetes, utilisez l'API Kubernetes Explorer, accessible depuis le panneau latéral sur la droite. Par ailleurs, il est possible d'y accéder Outils > Cloud Code > Kubernetes > Affichez l'explorateur de cluster.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, 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.
Les actions Kubernetes générales disponibles, accessibles via leurs icônes dans le Kubernetes:
Créer une application Kubernetes à partir d'un exemple
Actualiser l'explorateur
Ouvrez le Documentation Kubernetes Cloud Code dans un navigateur Web
Autres actions de débogage Kubernetes courantes, accessibles via leurs icônes dans l'explorateur Kubernetes, sont:
Exécutez la la configuration d'exécution/de débogage actuelle.
Lancez le exécuter la configuration en mode débogage.
Arrêter une session de débogage active.
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 d'une ressource à l'aide du menu contextuel](https://cloud.google.com/static/code/docs/intellij/images/copy-resource-name.png?authuser=7&hl=fr)
Actualiser les ressources
L'explorateur Kubernetes surveille les modifications 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](https://cloud.google.com/static/code/docs/intellij/images/refresh-resource.png?authuser=7&hl=fr)
![Bouton d'actualisation de l'explorateur Kubernetes](https://cloud.google.com/static/code/docs/intellij/images/kubernetes-explorer-refresh.png?authuser=7&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. Les informations sur la ressource sont présentées dans Panneau de la console de l'explorateur Kubernetes.Pour afficher les détails d'une ressource, vous pouvez également cliquer sur n'importe quelle ressource. Si des métadonnées sont associées, elles sont disponibles dans le panneau "Ressource Details" (Détails des ressources) de l'explorateur Kubernetes.
Options Skaffold
- Skaffold configuration (Configuration Skaffold) : sélectionne un fichier de configuration
skaffold.yaml
. Sera automatiquement détecté si vous avez unskaffold.yaml
dans votre projet. - Deployment profile (Profil de déploiement) : permet de sélectionner un profil.
parmi les options disponibles configurées dans votre fichier
skaffold.yaml
. - Environment variables (Variables d'environnement) : vous permettent de configurer des variables d'environnement supplémentaires à transmettre au processus de déploiement de Skaffold. Les options Skaffold peuvent également être configurées en tant que variables d'environnement à utiliser dans ce champ. Reportez-vous à la documentation de référence de la CLI Skaffold pour obtenir la liste complète des variables d'environnement Skaffold disponibles.
- Verbosité : permet de définir le niveau de verbosité de la sortie sur
trace
,debug
,info
,warn
,error
oufatal
. Le niveau de verbosité par défaut estwarn
.
Options Kubernetes
Le contexte de déploiement représente le contexte Kubernetes dans lequel votre application est déployée. Si le contexte de déploiement n'est pas spécifié, le comportement par défaut est de déployer dans le contexte de votre système actuel, le cas échéant.
Si vous préférez ne pas effectuer de déploiement dans le contexte actuel, dans la section "Déploiement" des paramètres d'exécution/de débogage, vous pouvez choisir l'une des options suivantes :
- Déployer localement sur un cluster Minikube : démarre un cluster Minikube géré par Cloud Code pour exécuter votre application et l'arrêter une fois le déploiement terminé. Si un cluster Minikube est déjà en cours d'exécution, Cloud Code utilise le cluster Minikube existant pour le déploiement.
Changer de contexte et déployer : modifie le contexte actuel de votre système en fonction du contexte spécifié lors du déploiement.
Delete deployments when finished (Supprimer les déploiements lorsque vous avez terminé) : supprime les déploiements Kubernetes lorsque le processus est terminé. Il s'agit du comportement par défaut. Vous pouvez également activer/désactiver ce paramètre pour empêcher la suppression des déploiements.
Personnaliser votre configuration de lancement
Pour configurer l'exécution de votre application, vous pouvez personnaliser votre
skaffold.yaml
.
Afficher le fichier YAML distant
Pour afficher le fichier YAML d'une ressource de votre cluster, directement depuis le l'explorateur Kubernetes. Accéder à une ressource dans l'application Kubernetes (un pod, par exemple), effectuez un clic droit sur le nom de la ressource, puis sélectionnez Afficher le fichier YAML distantLe fichier YAML correspondant à la ressource spécifiée s'ouvre dans un nouvel éditeur .
Voir les journaux
Vous pouvez diffuser et afficher les journaux des ressources Kubernetes dans le Explorer la console pour suivre leur progression.
Une fois que votre application est compilée et qu'elle s'exécute en mode normal ou en mode de développement, vous avez la possibilité de surveiller dans votre IDE les journaux qu'elle diffuse.
Vous pouvez également afficher les journaux d'un service spécifique en accédant à la page l'explorateur de données.
Pour sélectionner la ressource dont vous souhaitez afficher les journaux, comme un pod, un déploiement, ou d'un service:
Faites un clic droit sur la ressource, puis sélectionnez Stream Logs (Diffuser les journaux). Vous pouvez également diffuser les journaux de conteneurs individuels s'exécutant dans des pods.
Les journaux sont alors envoyés à la console de l'explorateur Kubernetes.
Pour afficher l'état des ressources de votre déploiement:
États des pods, des déploiements et des nœuds : les libellés de ces ressources Kubernetes sont accompagnés d'un symbole coloré indiquant leur état : échec (rouge), démarrage/arrêt/avertissement (jaune), état opérationnel (vert).
Descriptions des ressources déployées: vous pouvez exécuter une
kubectl describe
sur votre les ressources déployées pour en afficher les détails. Pour ce faire, effectuez un clic droit Décrivez.
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](https://cloud.google.com/static/code/docs/intellij/images/get-terminal.png?authuser=7&hl=fr)
Actions spécifiques sur les ressources
L'explorateur 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). L'explorateur Kubernetes vous permet d'effectuer des actions uniques sur certaines de ces ressources.
Vous pouvez accéder à l'explorateur Kubernetes depuis le panneau latéral ou accéder à Outils > Cloud Code > Kubernetes > Affichez l'explorateur de cluster.
Pour afficher les détails de vos ressources déployées, effectuez un clic droit sur une étiquette de ressource dans l'explorateur Kubernetes, puis cliquez sur Décrire.
Clusters
- Ajouter un cluster Google Kubernetes Engine:ajoutez un cluster Google Kubernetes Engine Autopilot ou créez-en un en cliquant sur + Ajouter un cluster GKE. dans l'explorateur Kubernetes.
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.
Lorsque vous avez terminé, cliquez sur OK, puis accédez au cluster choisi et aux des ressources via l'explorateur Kubernetes.Définir en tant que contexte actif : définissez le cluster spécifié comme actif, de sorte que le contexte
kubectl
que vous avez configuré puisse accéder à ce cluster par défaut.
L'explorateur Kubernetes s'actualise automatiquement et vous pouvez voir 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.
![Choisir et définir un cluster actif dans une liste de plusieurs contextes avec l'explorateur Kubernetes](https://cloud.google.com/static/code/docs/intellij/images/multiple-context.png?authuser=7&hl=fr)
Espaces de noms
Définir en tant que contexte actif : définissez un espace de noms comme actif, de sorte que le contexte
kubectl
que vous avez configuré puisse accéder à cet espace de noms par défaut.
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 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é de l'état indiquant que le pod est opérationnel](https://cloud.google.com/static/code/docs/intellij/images/kubernetes-explorer-healthy-pod.png?authuser=7&hl=fr)
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.
![Diffuser les journaux d'un conteneur à l'aide de son menu contextuel pour générer des journaux dans la console de l'explorateur Kubernetes](https://cloud.google.com/static/code/docs/intellij/images/stream-container-logs.png?authuser=7&hl=fr)
Déploiements
Afficher les journaux:Afficher 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/intellij/images/deploy-status-green.png?authuser=7&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/intellij/images/crd-list.png?authuser=7&hl=fr)
Étape suivante
- Faites vos premiers pas avec Cloud Code for IntelliJ pour Kubernetes par créer et déployer 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