Déboguer un service Cloud Run dans Cloud Code for Cloud Shell

Cloud Code for Cloud Shell vous permet de déboguer facilement une application déployée sur Cloud Run. Vous n'avez pas besoin de réaliser de configuration manuelle, par exemple pour la configuration du transfert de port ou l'injection d'arguments de débogage spécifiques à un langage. Il vous suffit de disposer d'une application Cloud Run prête pour Cloud Code qui inclut un fichier de configuration skaffold.yaml et un fichier launch.json de type cloudcode.cloudrun.

Déboguer votre service Cloud Run

Pour déboguer votre service, procédez comme suit :

  1. Pour exécuter votre service et y associer une session de débogage, ouvrez la palette de commandes (cliquez sur Icône Gérer Gérer > Palette de commandes ou appuyez sur Ctrl/Cmd+Shift+P), puis exécutez la commande Debug on Cloud Run Emulator (Débogage sur l'émulateur Cloud Run).

  2. Dans la boîte de dialogue "Run/Debug on Cloud Run Emulator" (Exécution/Débogage sur l'émulateur Cloud Run), définissez les spécifications de votre configuration :

    • Choisissez Docker ou Buildpacks comme compilateur, puis spécifiez votre fichier Dockerfile ou Buildpack.
    • Si vous souhaitez spécifier une cible de fichier Dockerfile ou des arguments de compilation, cliquez sur Afficher les paramètres de compilation avancés, puis spécifiez la cible ou les arguments.
    • Si vous souhaitez spécifier un nom de service personnalisé, une URL d'image de conteneur, un port de conteneur, une identité à utiliser pour le service, un nombre de processeurs dédiés ou une quantité de mémoire à allouer à chaque instance de conteneur, cliquez sur Afficher les paramètres de service avancés puis spécifiez les valeurs souhaitées.
    • Si vous souhaitez spécifier des variables d'environnement, cliquez sur Afficher les paramètres de service avancés, puis sur Variables d'environnement et spécifiez les valeurs souhaitées.
    • Si vous souhaitez spécifier des connexions Cloud SQL, cliquez sur Connexions puis spécifiez une connexion par ligne.

    Si vous souhaitez personnaliser davantage l'exécution de votre service, vous pouvez modifier directement votre fichier launch.json.

  3. Pour commencer le débogage de votre service, cliquez sur Debug (Déboguer).

  4. Pour chaque conteneur débogable dans votre service, confirmez ou saisissez le répertoire du conteneur distant dans lequel se trouve le programme à déboguer.

    Vous pouvez également appuyer sur ÉCHAP pour ignorer le débogage du conteneur.

    Cloud Code rattache une session de débogage pour chaque conteneur débogable dans le service.

    Par défaut, lorsqu'une modification apportée à votre application est enregistrée automatiquement, Cloud Code redéploie l'application et configure une nouvelle session de débogage. Vous pouvez activer ou désactiver cette fonctionnalité avec l'option watch dans la configuration de lancement de votre projet.

  5. Pour ajouter un point d'arrêt, dans l'éditeur, cliquez dans la marge du fichier que vous déboguez.

    Les cercles pleins rouges indiquent les points d'arrêt actifs et les cercles vides gris indiquent les points d'arrêt inactifs.

    Lorsque vous envoyez une nouvelle requête à votre service, celle-ci s'interrompt sur la ligne spécifiée.

  6. Une fois la session terminée, vous pouvez utiliser les commandes du menu contextuel suivantes :

    • Ouvrir les journaux de déploiement:ouvrez les journaux d'une application dans un journal spécifique à l'aide de l'explorateur de journaux Cloud Code.
    • Ouvrir une URL de service : ouvrez l'URL du service d'application d'un service spécifique dans un navigateur Web.
  7. Si vous avez désactivé le mode de surveillance dans votre configuration de lancement et que vous souhaitez apporter des modifications à votre application, puis recompiler et redéployer l'application, dans le volet des sessions de développement, mettez en pause l'action d'exécution, puis cliquez sur Icône Recréer et redéployerRecompiler et redéployer l'application.

  8. Si vous souhaitez inspecter les variables et les informations de pile, utilisez la barre latérale "Debug" (Débogage). Pour interagir avec la session de débogage, utilisez la console de débogage dans le volet inférieur du débogueur.

  9. Pour arrêter votre déploiement, cliquez sur le bouton Stop (Arrêter) dans la barre d'action de votre déploiement actuel.

    Barre d'actions pour le déploiement Cloud Run