Déboguer un service Cloud Run

Cloud Code vous permet de déboguer facilement une application déployée dans Cloud Run. Vous n'avez pas besoin de terminer la configuration manuelle, comme la configuration du transfert de port ou l'injection d'arguments de débogage spécifiques à un langage. Vous avez simplement besoin d'une application Cloud Run prête pour Cloud Code, qui inclut un fichier de configuration skaffold.yaml et un fichier lancement.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 lui associer une session de débogage, ouvrez la palette de commandes (cliquez sur Icône Gérer en forme de roue dentée Gérer > Palette de commandes) ou Appuyez sur Ctrl/Cmd+Shift+P), puis exécutez la commande Debug on Cloud Run Emulator (Déboguer sur l'émulateur Cloud Run).

  2. Dans la boîte de dialogue "Run/Debug on Cloud Run Emulator" (Exécuter/Déboguer 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 ou des arguments Dockerfile, 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é pour le service à utiliser, 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.
    • Si vous souhaitez spécifier des variables d'environnement, cliquez sur Afficher les paramètres de service avancés, puis sur Variables d'environnement. puis spécifiez les valeurs.
    • Si vous souhaitez spécifier des connexions Cloud SQL, cliquez sur Connexions, puis spécifiez une connexion par ligne.

    Si vous souhaitez personnaliser davantage le fonctionnement de votre service, vous pouvez modifier directement votre fichier lancement.json.

  3. Pour commencer à déboguer votre service, cliquez sur Débogage.

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

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

    Cloud Code associe une session de débogage à chaque conteneur débogable du service.

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

    Les cercles remplis de couleur rouge indiquent les points d'arrêt actifs, tandis que les cercles vides gris indiquent les points d'arrêt désactivés.

    Lorsque vous envoyez une nouvelle requête à votre service, elle est suspendue à la ligne que vous avez spécifiée.

  6. Une fois votre session terminée, d'autres options de menu contextuel sont disponibles pour surveiller votre application et ses ressources à l'aide de la barre d'état Cloud Code, y compris:

    • Ouvrir les journaux de déploiement:ouvrez les journaux d'application pour un déploiement spécifique à l'aide de la visionneuse de journaux Cloud Code.
    • Open Service URL (Ouvrir l'URL du service) : ouvrez l'URL du service d'application d'un service spécifique dans un navigateur Web.
    • Activer/Désactiver le mode de visionnage:activez/désactivez le mode de lecture pour la session en cours. Par défaut, Cloud Code surveille en permanence les modifications apportées à vos fichiers, telles que la configuration ou le code de Kubernetes, recompile les conteneurs et redéploie l'application sur le cluster afin que votre{ 101}les modifications sont reflétées quasiment en temps réel.

      Options disponibles dans la barre d'état Cloud Code: ouvrir les journaux de déploiement, ouvrir l'URL du service et activer le mode de surveillance, en plus des actions standards de Cloud Code

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

  8. Pour arrêter votre déploiement en cours, cliquez sur le bouton Arrêter dans la barre d'action de votre déploiement actuel.

    Barre d'action pour le déploiement de Cloud Run