Déployer une application Kubernetes avec Cloud Code for VS Code
Cette page vous explique comment démarrer rapidement avec Cloud Code.
Vous allez configurer une nouvelle application Kubernetes à l'aide d'un exemple d'application "Hello World", créer un cluster, exécuter votre application sur ce cluster, déboguer votre code en cours d'exécution, afficher les journaux de votre application active et connecter un terminal à votre conteneur.
Avant de commencer
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Google Kubernetes Engine API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Google Kubernetes Engine API.
- Installez Git. Git est nécessaire pour copier des exemples sur votre ordinateur.
- Installez le plug-in Cloud Code si ce n'est pas déjà fait.
Créer une application
Ouvrez la palette de commandes (appuyez sur
Ctrl
/Cmd
+Shift
+P
ou cliquez sur Affichage > Palette de commandes), puis exécutez Cloud Code: New Application (Cloud Code : Nouvelle application).Sélectionnez Application Kubernetes.
Choisissez une application Hello World dans la langue de votre choix.
Par exemple, si vous choisissez
Node.js: Hello World
, vous créez une application Hello World Node.js de démarrage.Enregistrez la nouvelle application.
Une notification confirme que votre application a été créée et celle-ci s'ouvre dans une nouvelle fenêtre.
Créer un cluster GKE
Pour créer un cluster Google Kubernetes Engine (GKE) standard, procédez comme suit :
Cliquez sur
Cloud Code, puis développez la section Kubernetes.
Cliquez sur Ajouter Ajouter un cluster au fichier KubeConfig, puis sur Google Kubernetes Engine dans le menu Sélection rapide.
Lorsque vous êtes invité à activer
container.googleapis.com
, sélectionnez Oui.Cliquez sur + Créer un cluster GKE.
Choisissez Standard comme type de cluster.
Cliquez sur Ouvrir pour autoriser Cloud Code à ouvrir la console Google Cloud.
Dans la console Google Cloud, utilisez le projet que vous avez créé, définissez la zone sur
us-central1-a
et définissez le nom du cluster surmy-first-cluster
.Cliquez sur Créer. La création du cluster prend quelques minutes.
Une fois le cluster créé, dans le menu Quick pick (Sélection rapide), cliquez sur refresh (Actualiser) puis sur Refresh (Actualiser).
Lorsque le nom de votre nouveau cluster apparaît dans la liste, cliquez dessus. Votre nouveau cluster est ajouté à la configuration et configuré en tant que contexte actif.
Exécuter et afficher votre application
Maintenant que vous êtes prêt, vous pouvez exécuter votre application et l'afficher en direct. Cloud Code surveille les modifications apportées à votre système de fichiers afin que vous puissiez modifier et réexécuter votre application quasiment en temps réel.
Pour exécuter votre application, procédez comme suit :
Dans la barre d'état Cloud Code, cliquez sur le nom du projet actif.
Dans le menu "Démarrage rapide" qui s'affiche, sélectionnez Exécuter sur Kubernetes.
Confirmez si vous souhaitez utiliser le contexte actif du cluster ou basculer vers un autre.
Si vous y êtes invité, choisissez un registre d'images vers lequel transférer les images. Si vous créez un registre d'images à l'aide de
gcr.io/PROJECT_ID
, assurez-vous qu'il se trouve dans le même projet que votre cluster.Une fenêtre de résultat s'affiche, dans laquelle vous pouvez suivre la progression de votre application en cours d'exécution. Un flux en direct des journaux des pods en cours d'exécution s'affiche également dans la sortie du terminal.
Une fois votre application exécutée sur Kubernetes, la fenêtre de résultat affiche une adresse IP. Pour utiliser cette adresse IP associée afin d'accéder à votre application, appuyez sur
Ctrl
/Cmd
, puis cliquez sur l'adresse.
Conseils de dépannage
Si vous utilisez un cluster préexistant, pour définir votre cluster comme actif et obtenir les identifiants du cluster, procédez comme suit:
Cliquez sur
Cloud Code, puis développez la section Kubernetes.
Effectuez un clic droit sur le nom de votre cluster, puis cliquez sur Set as Active Cluster (Définir comme cluster actif).
Déboguer votre application
Pour déboguer votre application, procédez comme suit :
Dans la barre d'état Cloud Code, cliquez sur le nom du projet actif.
Dans le menu "Démarrage rapide" qui s'affiche, sélectionnez Déboguer sur Kubernetes.
Si vous y êtes invité, authentifiez vos identifiants pour exécuter et déboguer une application localement.
Si vous y êtes invité, confirmez si vous souhaitez utiliser le contexte actuel du cluster ou passer à un autre.
Cloud Code utilise les configurations
cloudcode.kubernetes
de votre fichier.vscode/launch.json
pour exécuter votre application et lui associer une session de débogage.Cloud Code crée vos conteneurs, les transfère dans le registre, applique les configurations Kubernetes au cluster et renvoie l'adresse IP que vous pouvez utiliser pour parcourir votre application active.
Avant d'associer votre session de débogage, vous êtes invité à confirmer ou à saisir le répertoire du conteneur distant dans lequel se trouve le programme à déboguer, ou à appuyer sur ÉCHAP pour ignorer le débogage du conteneur.
Pour ajouter un point d'arrêt à la ligne 9, ouvrez
src/app.js
, puis cliquez dans la marge de l'éditeur.Les cercles remplis de rouge indiquent les points d'arrêt actifs, tandis que les cercles vides gris indiquent les points d'arrêt désactivés. Pour un contrôle plus précis des points d'arrêt, vous pouvez utiliser la section "Points d'arrêt" de la vue "Débogage" de VS Code.
Lorsque vous envoyez une nouvelle requête à votre application, le débogueur se met en pause au premier point d'arrêt actif.
Dans l'exemple suivant, sous Local dans la section Variables, notez que la valeur de
res._contentLength;
pourHello, world!
est 13.Remplacez la chaîne envoyée dans la ligne 8 par
Hello, goodbye!
, puis redémarrez l'action Debug on Kubernetes (Déboguer sur Kubernetes).Une fois l'application recompilée et redéployée, notez la valeur mise à jour de
res._contentLength
.
Une fois votre session de débogage lancée, le volet Sessions de développement affiche la vue structurée de la journalisation. Lorsqu'une tâche démarre, elle s'affiche avec un demi-cercle en rotation progress_activity.
Si une tâche aboutit, une coche check_circle s'affiche à côté de l'étape correspondante.
Pour afficher les détails d'une étape, cliquez dessus dans le volet Session de développement. Le volet "Résultat" affiche l'étape dans la sortie de la journalisation.
Ouvrir un terminal dans votre conteneur
Pour ouvrir un terminal dans votre conteneur, procédez comme suit :
Cliquez sur
Cloud Code, puis développez la section Kubernetes.
Développez les sections suivantes:
- Section de votre cluster préféré
- La section Espaces de noms, puis la section de l'espace de noms de votre choix
- La section Pods, puis la section de votre pod préféré
Section Containers
Cliquez avec le bouton droit sur le conteneur dans lequel vous souhaitez ouvrir un terminal, puis cliquez sur Get Terminal (Obtenir un terminal).
Un terminal s'ouvre. Vous avez maintenant accès à un shell dans le conteneur en cours d'exécution.
Effectuer un nettoyage
Une fois votre application arrêtée, toutes les ressources Kubernetes déployées pendant l'exécution sont automatiquement supprimées.
Pour éviter que les autres ressources utilisées dans ce démarrage rapide soient facturées sur votre compte, veillez à supprimer le projet ou le cluster que vous avez créés si vous souhaitez réutiliser le projet.
Pour supprimer le cluster :
- Cliquez sur
Cloud Code, puis développez l'explorateur Kubernetes.
- Pointez sur le nom de votre cluster, puis cliquez sur open_in_new (Ouvrir dans la console Google Cloud) Ouvrir dans la console Google Cloud.
- Cliquez sur Supprimer et de nouveau sur Supprimer.
Pour supprimer votre projet (et les ressources associées, y compris les clusters) :
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Étape suivante
- Envisagez d'importer une application existante dans VS Code et de la configurer avec Cloud Code.
- Découvrez une configuration Google Cloud et Kubernetes plus avancée grâce à la compatibilité de l'édition YAML avec Cloud Code. Google Cloud
- Découvrez l'assistance au débogage spécifique au langage fournie par Cloud Code.
- Accélérez votre développement grâce à la synchronisation des fichiers et au rechargement à chaud.
- Créer et configurer un cluster GKE
- Configurer des clusters privés
- Personnalisez votre expérience Cloud Code en configurant des paramètres pertinents.
- Déployer vos applications sur des clusters GKE ARM64, AMD64 ou à architecture mixte