Déployer une application Kubernetes avec Cloud Code pour VS Code

Déployer une application Kubernetes avec Cloud Code pour 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

Connectez-vous à votre Google Cloud compte. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Installez Git. Git est nécessaire pour copier des exemples sur votre ordinateur.
2. Installez Docker. Docker est nécessaire pour compiler l'exemple de code. Assurez-vous que votre compte utilisateur local est en mesure de créer des conteneurs.
3. Installez le plug-in Cloud Code si ce n'est pas déjà fait.

Rôles requis

Pour obtenir les autorisations nécessaires pour suivre ce guide de démarrage rapide, demandez à votre administrateur de vous attribuer le rôle IAM d'administrateur Kubernetes Engine (roles/container.admin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer une application

1. 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).

2. Sélectionnez Kubernetes Application (Application Kubernetes).

3. 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.

4. 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 :

1. Cliquez sur Cloud Code , puis développez la section Kubernetes.

2. Cliquez sur add Ajouter un cluster au fichier KubeConfig , puis sur Google Kubernetes Engine dans le menu Démarrage rapide.

3. Lorsque vous êtes invité à activer l'API Container, sélectionnez Oui.

4. Cliquez sur + Créer un cluster GKE.

5. Choisissez Standard comme type de cluster.

6. Cliquez sur Ouvrir pour autoriser Cloud Code à ouvrir la Google Cloud console.

7. Dans la Google Cloud console, assurez-vous que le projet sélectionné est celui que vous avez créé ou choisi précédemment.

8. Définissez le nom du cluster sur my-first-cluster.

9. Sélectionnez Zonal comme type d'emplacement, puis définissez la zone sur us-central1-a.

10. Cliquez sur Créer. La création du cluster prend quelques minutes.

11. Une fois le cluster créé, cliquez à nouveau sur Ajouter un cluster au fichier KubeConfig, puis sélectionnez le cluster que vous venez de créer dans la liste.

12. 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 :

1. Dans la barre d'état Cloud Code, cliquez sur le nom du projet actif.

   

2. Dans le menu "Démarrage rapide" qui s'affiche, sélectionnez Run on Kubernetes (Exécuter sur Kubernetes). Lorsque vous y êtes invité, sélectionnez à nouveau Run on Kubernetes (Exécuter sur Kubernetes).

3. Confirmez si vous souhaitez utiliser le contexte actif du cluster ou basculer vers un autre.

4. 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.

5. Une fois votre application exécutée sur Kubernetes, cliquez sur l'entrée État de la tâche Run on Kubernetes (Exécuter sur Kubernetes) dans la section Sessions de développement. Une fenêtre s'ouvre avec un onglet Résultat qui inclut l'URL de votre application. Pour ouvrir cette URL, appuyez sur Ctrl (ou Cmd sous macOS), puis cliquez sur l'adresse.

   Vous pouvez également trouver votre application dans la présentation des charges de travail de la Google Cloud console. Pour en savoir plus sur votre application en cours d'exécution, y compris son adresse IP externe et son numéro de port, cliquez sur son nom dans la liste.

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 :

1. Dans VS Code, cliquez sur Cloud Code , puis développez la section Kubernetes.

2. Faites 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 :

1. Dans la barre d'état Cloud Code, cliquez sur le nom du projet actif.

   

2. Dans le menu "Démarrage rapide" qui s'affiche, sélectionnez Debug on Kubernetes (Déboguer sur Kubernetes).

3. Si vous y êtes invité, authentifiez vos identifiants pour exécuter et déboguer une application en local.

4. 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.

5. 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.

6. 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; pour Hello, world! est 13.

   

7. 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 démarré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 une icône de 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 sur l'étape 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 :

1. Cliquez sur Cloud Code , puis développez la section Kubernetes.

2. Développez les sections suivantes :

   • Section de votre cluster préféré
   • Section Espaces de noms , puis section de votre espace de noms préféré
   • Section Pods , puis section de votre pod préféré

   • Section Conteneurs

     

3. 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 se lance. Vous avez maintenant accès à une interface système à l'intérieur du 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éé si vous souhaitez réutiliser le projet.

Pour supprimer le cluster :

1. Cliquez sur Cloud Code, puis développez l'explorateur Kubernetes.
2. Pointez sur le nom de votre cluster, puis cliquez sur open_in_new Ouvrir dans la Google Cloud console.
3. Cliquez sur Supprimer et de nouveau sur Supprimer.

Pour supprimer votre projet (et les ressources associées, y compris les clusters) :

Attention : La suppression d'un projet aura les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. Dans la Google Cloud console, accédez à la page Gérer les ressources.

   Accéder à la page "Gérer les ressources"

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez Arrêter pour supprimer le projet.

Étape suivante

• Envisagez d'importer une application existante dans VS Code et de la configurer avec Cloud Code.
• Découvrez une configuration 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éployez vos applications sur des clusters GKE ARM64, AMD64 ou à architecture mixte.