Déboguer les applications Google Chat

En tant que développeur d'applications Google Chat, vous devrez peut-être déboguer du code pour pour tester les modifications ou résoudre des problèmes complexes. Déboguer les applications Chat peut s'effectuer de différentes manières en fonction de l'architecture de votre application, l'application, la façon dont elle est déployée et vos préférences.

Cette page explique comment déboguer une application de chat HTTP à l'aide de ngrok, une plate-forme d'entrée unifiée que vous pouvez utiliser pour tester des environnements de développement Google Cloud. Dans ce guide, vous allez tester les modifications de code dans un environnement et résoudre les problèmes dans un environnement distant.

Déboguer à partir de l'environnement de développement local

Dans cette section, vous interagissez avec votre application Chat s'exécute dans votre environnement local.

Déboguer à partir du développement local
environnement

Figure 1. Procédez au débogage dans un environnement de développement local.

Atelier

Node.js

Python

Java

Prérequis

Node.js

Python

Java

Rendre le service localhost disponible publiquement

Vous devez connecter votre environnement local à Internet pour que L'application Chat peut y accéder. L'application ngrok est utilisée pour rediriger les requêtes HTTP effectuées vers une URL publique vers votre environnement local.

  1. Dans un navigateur de votre environnement local, connectez-vous à votre compte ngrok.
  2. Installez l'application et configurez votre authtoken dans votre environnement cloud.
  3. Créez un domaine statique dans votre ngrok, il est référencé sous la forme NGROK_STATIC_DOMAIN dans les instructions de ce guide.

Configurer l'application Chat

Configurer l'application Chat pour qu'elle envoie toutes ses requêtes HTTP à votre domaine statique.

  1. Dans la console Google Cloud, ouvrez la page de l'API Google Chat:

    Accéder à la page de l'API Google Chat

  2. Cliquez sur l'onglet Configuration.

  3. Accédez à Fonctionnalités interactives > Paramètres de connexion, puis définissez la valeur du champ de texte App Url (URL de l'application) par:

    https://NGROK_STATIC_DOMAIN
    

    Remplacez NGROK_STATIC_DOMAIN par le domaine statique dans votre compte ngrok.

  4. Cliquez sur Enregistrer.

L'application Chat envoie toutes ses requêtes HTTP au
domaine statique

Figure 2. L'application Chat envoie toutes ses requêtes HTTP au domaine statique. Le service public ngrok sert de passerelle entre les Application Chat et code de l'application qui s'exécute localement.

Tester l'application Chat

Vous pouvez déployer, configurer, tester, déboguer et recharger automatiquement votre Application Chat

Node.js

  1. Cloner le dépôt googleworkspace/google-chat-samples depuis GitHub dans votre environnement local, il contient le code de l'application execute:

    git clone https://github.com/googleworkspace/google-chat-samples.git
  2. Depuis l'IDE Visual Studio Code installé dans votre environnement local, effectuer les opérations suivantes:

    1. Ouvrez le dossier dans une nouvelle fenêtre. google-chat-samples/node/basic-app
    2. Configurez l'application pour le débogage par actualisation automatique en ajoutant deux dans le fichier package.json:

      {
          ...
          "scripts": {
              ...
              "debug": "node --inspect index.js",
              "debug-watch": "nodemon --watch ./ --exec npm run debug"
          }
          ...
      }
      
    3. À partir du répertoire racine, installez l'application:

      npm install
    4. Créez et configurez un lancement nommé Debug Watch qui déclenche l'événement script debug-watch en créant le fichier .vscode/launch.json dans le répertoire racine:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "node",
              "request": "launch",
              "name": "Debug Watch",
              "cwd": "${workspaceRoot}",
              "runtimeExecutable": "npm",
              "runtimeArgs": ["run-script", "debug-watch"]
          }]
      }
      
    5. Ajoutez un point d'arrêt qui suspend le traitement de la requête HTTP dans le index.js, puis lancez l'exécution et le débogage avec Configuration Debug Watch ajoutée précédemment. L'application est maintenant en cours d'exécution et à l'écoute des requêtes HTTP sur le port 9000.

      L'application est en cours d'exécution et écoute les requêtes HTTP sur le
port "9000"

      Figure 3. L'application est en cours d'exécution et écoute le trafic HTTP requêtes sur le port 9000.

  3. Lancez l'application ngrok dans votre environnement local:

    ngrok http --domain=NGROK_STATIC_DOMAIN 9000

    Remplacez NGROK_STATIC_DOMAIN par le domaine statique dans votre compte ngrok. Toutes les requêtes sont désormais redirigées vers votre et le port utilisé par l'application.

    Le terminal sur lequel le serveur ngrok est en cours d'exécution
redirection

    Figure 4. Le terminal avec le serveur ngrok en cours d'exécution et en cours de redirection.

  4. Une interface Web est également démarrée sur votre localhost par ngrok vous pouvez surveiller toutes les activités en l'ouvrant dans un navigateur.

    Interface Web hébergée par l'application ngrok qui n'affiche pas de protocole HTTP
requêtes

    Figure 5. Interface Web hébergée par l'application ngrok n'affichant aucune requête HTTP.

  5. Testez votre application Chat en lui envoyant directement message:

    • Ouvrez Google Chat.

      Accéder à Google Chat

    • Cliquez sur Nouveau chat .

    • Dans la boîte de dialogue, saisissez le nom de votre Application Chat

    • Dans les résultats de recherche, recherchez votre application Chat, cliquez sur Ajouter > Chatter.

    • Dans l'espace de message privé, saisissez Hello et appuyez sur enter. Votre L'application Chat ne répond pas, car elle est en cours activement débogués.

  6. Dans le fichier Visual Studio Code de votre environnement local, vous pouvez voir que l'exécution est mise en pause au point d'arrêt défini.

    L'exécution est mise en pause au niveau du point d'arrêt
CANNOT TRANSLATE

    Figure 6. L'exécution est suspendue au point d'arrêt défini.

  7. Lorsque vous reprenez l'exécution à partir du débogueur de Visual Studio Code avant que Google Chat n'expire l'application Chat répond Your message : Hello.

  8. Vous pouvez consulter les journaux de requêtes et de réponses HTTP depuis l'interface Web hébergé par l'application ngrok dans votre environnement local.

    Requête HTTP provenant de l'interface Web hébergée par "ngrok"
application

    Figure 7. Requête HTTP provenant de l'interface Web hébergée par le Application ngrok.

  9. Pour modifier le comportement de l'application, remplacez Your message par Here was your message a intégré 35 de index.json. Lorsque vous enregistrez le fichier, nodemon actualise automatiquement l'application avec le code source mis à jour et Visual Studio Code reste en mode débogage.

    L'application est en cours d'exécution et écoute les requêtes HTTP sur le port.
"9000" avec le changement de code
chargé

    Figure 8. L'application est en cours d'exécution et écoute les requêtes HTTP. sur le port 9000 avec la modification de code chargée.

  10. Cette fois, au lieu d'envoyer un second message Hello dans l'espace, vous peut sélectionner la dernière requête HTTP consignée sur l'interface Web hébergée par l'application ngrok dans votre environnement local, puis cliquez sur Replay. Comme la dernière fois, votre application Chat ne répond pas car il est en cours de débogage actif.

  11. Lorsque vous reprenez l'exécution à partir du débogueur de Visual Studio Code vous pouvez voir dans l'interface Web hébergée par l'application ngrok l'environnement local avec lequel l'application génère une réponse la version mise à jour du message Here was your message : Hello.

Python

  1. Procurez-vous de nouveaux identifiants utilisateur à utiliser pour les paramètres par défaut de l'application Identifiants:

    gcloud config set project PROJECT_ID
    gcloud auth application-default login

    Remplacez PROJECT_ID par le ID du projet pour le projet Cloud de l'application.

  2. Cloner le dépôt googleworkspace/google-chat-samples depuis GitHub dans votre environnement local, il contient le code de l'application:

    git clone https://github.com/googleworkspace/google-chat-samples.git
  3. Depuis l'IDE Visual Studio Code installé dans votre environnement local, effectuer les opérations suivantes:

    1. Ouvrez le dossier dans une nouvelle fenêtre. google-chat-samples/python/avatar-app
    2. Créez un environnement virtuel pour Python env et activez-le:

      virtualenv env
      source env/bin/activate
    3. Installez toutes les dépendances du projet à l'aide de pip dans le environnement:

      pip install -r requirements.txt
    4. Créez le fichier .vscode/launch.json dans le répertoire racine. configurer un lancement nommé Debug Watch qui déclenche l'application à partir du module functions-framework sur le port 9000 en mode débogage sur l'environnement virtuel env:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "python",
              "request": "launch",
              "name": "Debug Watch",
              "python": "${workspaceFolder}/env/bin/python3",
              "module": "functions_framework",
              "args": [
                  "--target", "avatar_app",
                  "--port", "9000",
                  "--debug"
              ]
          }]
      }
      
    5. Ajoutez un point d'arrêt qui suspend le traitement de la requête HTTP dans le main.py, puis lancez l'exécution et le débogage avec Configuration Debug Watch ajoutée précédemment. L'application est maintenant en cours d'exécution et à l'écoute des requêtes HTTP sur le port 9000.

      L'application est en cours d'exécution et écoute les requêtes HTTP sur le
port "9000"

      Figure 3. L'application est en cours d'exécution et écoute le trafic HTTP requêtes sur le port 9000.

  4. Lancez l'application ngrok dans votre environnement local:

    ngrok http --domain=NGROK_STATIC_DOMAIN 9000

    Remplacez NGROK_STATIC_DOMAIN par le domaine statique dans votre compte ngrok. Toutes les requêtes sont désormais redirigées vers votre et le port utilisé par l'application.

    Le terminal sur lequel le serveur ngrok est en cours d'exécution
redirection

    Figure 4. Le terminal avec le serveur ngrok en cours d'exécution et en cours de redirection.

  5. Une interface Web est également démarrée sur votre localhost par ngrok vous pouvez surveiller toutes les activités en l'ouvrant dans un navigateur.

    Interface Web hébergée par l'application ngrok qui n'affiche pas de protocole HTTP
requêtes

    Figure 5. Interface Web hébergée par l'application ngrok n'affichant aucune requête HTTP.

  6. Testez votre application Chat en lui envoyant directement message:

    • Ouvrez Google Chat.

      Accéder à Google Chat

    • Cliquez sur Nouveau chat .

    • Dans la boîte de dialogue, saisissez le nom de votre Application Chat

    • Dans les résultats de recherche, recherchez votre application Chat, cliquez sur Ajouter > Chatter.

    • Dans l'espace de message privé, saisissez Hey! et appuyez sur enter. Votre L'application Chat ne répond pas, car elle est en cours activement débogués.

  7. Dans le fichier Visual Studio Code de votre environnement local, vous pouvez voir que l'exécution est mise en pause au point d'arrêt défini.

    L'exécution est mise en pause au niveau du point d'arrêt
CANNOT TRANSLATE

    Figure 6. L'exécution est suspendue au point d'arrêt défini.

  8. Lorsque vous reprenez l'exécution à partir du débogueur de Visual Studio Code avant que Google Chat n'expire l'application Chat répond avec votre nom et votre photo d'avatar dans le message.

  9. Vous pouvez consulter les journaux de requêtes et de réponses HTTP depuis l'interface Web hébergé par l'application ngrok dans votre environnement local.

    Requête HTTP provenant de l'interface Web hébergée par "ngrok"
application

    Figure 7. Requête HTTP provenant de l'interface Web hébergée par le Application ngrok.

  10. Pour modifier le comportement de l'application, remplacez Hello par Hey intégré 51 du fichier main.py. Lorsque vous enregistrez le fichier, Visual Studio Code actualise automatiquement l'application avec le code source mis à jour reste en mode débogage.

    L'application est en cours d'exécution et écoute les requêtes HTTP sur le port.
"9000" avec le changement de code
chargé

    Figure 8. L'application est en cours d'exécution et écoute les requêtes HTTP. sur le port 9000 avec la modification de code chargée.

  11. Cette fois, au lieu d'envoyer un second message Hey! dans l'espace, vous peut sélectionner la dernière requête HTTP consignée sur l'interface Web hébergée par l'application ngrok dans votre environnement local, puis cliquez sur Replay. Comme la dernière fois, votre application Chat ne répond pas car il est en cours de débogage actif.

  12. Lorsque vous reprenez l'exécution à partir du débogueur de Visual Studio Code vous pouvez voir dans l'interface Web hébergée par l'application ngrok l'environnement local avec lequel l'application génère une réponse la version mise à jour du message.

Java

  1. Procurez-vous de nouveaux identifiants utilisateur à utiliser pour les paramètres par défaut de l'application Identifiants:

    gcloud config set project PROJECT_ID
    gcloud auth application-default login

    Remplacez PROJECT_ID par le ID du projet pour le projet Cloud de l'application.

  2. Cloner le dépôt googleworkspace/google-chat-samples depuis GitHub dans votre environnement local, il contient le code d'application:

    git clone https://github.com/googleworkspace/google-chat-samples.git
  3. Depuis l'IDE Visual Studio Code installé dans votre environnement local, effectuer les opérations suivantes:

    1. Ouvrez le dossier dans une nouvelle fenêtre. google-chat-samples/java/avatar-app
    2. Configurer le projet Maven sur lequel exécuter l'application App portez 9000 localement en ajoutant le build du framework Cloud Functions Plug-in function-maven-plugin dans le fichier pom.xml:

      ...
      <plugin>
          <groupId>com.google.cloud.functions</groupId>
          <artifactId>function-maven-plugin</artifactId>
          <version>0.11.0</version>
          <configuration>
              <functionTarget>App</functionTarget>
              <port>9000</port>
          </configuration>
      </plugin>
      ...
      
    3. Vous pouvez maintenant le lancer localement en mode débogage:

      mvnDebug function:run
      Preparing to execute Maven in debug mode
      Listening for transport dt_socket at address: 8000
    4. Créez le fichier .vscode/launch.json dans le répertoire racine. configurez un lancement nommé Remote Debug Watch qui s'associe application précédemment lancée avec le port 8000:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "java",
              "request": "attach",
              "name": "Remote Debug Watch",
              "projectName": "http-function",
              "hostName": "localhost",
              "port": 8000
          }]
      }
      
    5. Ajoutez un point d'arrêt qui suspend le traitement de la requête HTTP dans le App.java, puis commencez à joindre et le débogage avec Configuration Remote Debug Watch ajoutée précédemment. L'application est en cours d'exécution et à l'écoute des requêtes HTTP sur le port 9000.

      L&#39;application est en cours d&#39;exécution et écoute les requêtes HTTP sur le
port &quot;9000&quot;

      Figure 3 : L'application est en cours d'exécution et écoute le protocole HTTP. sur le port 9000.

  4. Lancez l'application ngrok dans votre environnement local:

    ngrok http --domain=NGROK_STATIC_DOMAIN 9000

    Remplacez NGROK_STATIC_DOMAIN par le domaine statique dans votre compte ngrok. Toutes les requêtes sont désormais redirigées vers votre et le port utilisé par l'application.

    Le terminal sur lequel le serveur ngrok est en cours d&#39;exécution
redirection

    Figure 4. Le terminal avec le serveur ngrok en cours d'exécution et en cours de redirection.

  5. Une interface Web est également démarrée sur votre localhost par ngrok vous pouvez surveiller toutes les activités en l'ouvrant dans un navigateur.

    Interface Web hébergée par l&#39;application ngrok qui n&#39;affiche pas de protocole HTTP
requêtes

    Figure 5. Interface Web hébergée par l'application ngrok n'affichant aucune requête HTTP.

  6. Testez votre application Chat en lui envoyant directement message:

    • Ouvrez Google Chat.

      Accéder à Google Chat

    • Cliquez sur Nouveau chat .

    • Dans la boîte de dialogue, saisissez le nom de votre Application Chat

    • Dans les résultats de recherche, recherchez votre application Chat, cliquez sur Ajouter &gt; Chatter.

    • Dans l'espace de message privé, saisissez Hey! et appuyez sur enter. Votre L'application Chat ne répond pas, car elle est en cours activement débogués.

  7. Dans le fichier Visual Studio Code de votre environnement local, vous pouvez voir que l'exécution est mise en pause au point d'arrêt défini.

    L&#39;exécution est mise en pause au niveau du point d&#39;arrêt
CANNOT TRANSLATE

    Figure 6. L'exécution est suspendue au point d'arrêt défini.

  8. Lorsque vous reprenez l'exécution à partir du débogueur de Visual Studio Code avant que Google Chat n'expire l'application Chat répond avec votre nom et votre photo d'avatar dans le message.

  9. Vous pouvez consulter les journaux de requêtes et de réponses HTTP depuis l'interface Web hébergé par l'application ngrok dans votre environnement local.

    Requête HTTP provenant de l&#39;interface Web hébergée par &quot;ngrok&quot;
application

    Figure 7. Requête HTTP provenant de l'interface Web hébergée par le Application ngrok.

  10. Pour modifier le comportement de l'application, remplacez Hello par Hey intégré 55 du fichier App.java, redémarrez le processus mvnDebug et relancer Remote Debug Watch pour le réassocier et le redémarrer le débogage.

  11. Cette fois, au lieu d'envoyer un second message Hey! dans l'espace, vous peut sélectionner la dernière requête HTTP consignée sur l'interface Web hébergée par l'application ngrok dans votre environnement local, puis cliquez sur Replay. Comme la dernière fois, votre application Chat ne répond pas car il est en cours de débogage actif.

  12. Lorsque vous reprenez l'exécution à partir du débogueur de Visual Studio Code vous pouvez voir dans l'interface Web hébergée par l'application ngrok l'environnement local avec lequel l'application génère une réponse la version mise à jour du message.

Déboguer depuis l'environnement distant

Dans cette section, vous interagissez avec votre application Chat s'exécute dans un environnement distant.

Déboguer à distance
environnement

Figure 9. Effectuez le débogage depuis l'environnement distant.

Prérequis

  • Un espace de messagerie privée avec votre application Chat Vous pouvez suivez la section Testez votre application Chat de la Guide de démarrage rapide et recherchez Application de chat pour en démarrer une.
  • Votre application s'exécutant dans votre environnement distant avec le débogueur activé sur un port donné, il est référencé REMOTE_DEBUG_PORT dans les instructions de ce guide.
  • Votre environnement local peut ssh vers votre environnement distant.
  • Un IDE configuré dans votre environnement local et capable de déboguer Nous utilisons les Visual Studio Code IDE et son IDE par défaut les fonctionnalités de débogage à des fins d'illustration.

Connectez vos environnements local et distant

Dans votre environnement local à partir duquel vous souhaitez lancer un client de débogage configurez un tunnel SSH:

ssh -L LOCAL_DEBUG_PORT:localhost:REMOTE_DEBUG_PORT REMOTE_USERNAME@REMOTE_ADDRESS

Remplacez les éléments suivants :

  • LOCAL_DEBUG_PORT: port de débogage de votre environnement environnement.
  • REMOTE_USERNAME: nom d'utilisateur dans votre environnement distant.
  • REMOTE_ADDRESS: adresse de votre environnement distant.
  • REMOTE_DEBUG_PORT: port de débogage de votre télécommande environnement.

Le port de débogage de votre environnement local est désormais lié au port de débogage de votre un environnement distant.

Démarrer le débogage

À partir de l'IDE Visual Studio Code installé dans votre environnement local, effectuez la suivantes:

  1. Dans une nouvelle fenêtre, ouvrez le code source de votre application.
  2. Créez le fichier .vscode/launch.json dans le répertoire racine et configurez un lancement nommé Debug Remote qui s'associe au port de débogage dans votre environnement environnement:

    Node.js

    {
        "version": "0.2.0",
        "configurations": [{
            "type": "node",
            "request": "attach",
            "name": "Debug Remote",
            "address": "127.0.0.1",
            "port": LOCAL_DEBUG_PORT
        }]
    }
    

    Python

    {
        "version": "0.2.0",
        "configurations": [{
            "type": "python",
            "request": "attach",
            "name": "Debug Remote",
            "connect": {
                "host": "127.0.0.1",
                "port": LOCAL_DEBUG_PORT
            }
        }]
    }
    

    Java

    {
        "version": "0.2.0",
        "configurations": [{
            "type": "java",
            "request": "attach",
            "name": "Debug Remote",
            "hostName": "127.0.0.1",
            "port": LOCAL_DEBUG_PORT
        }]
    }
    

    Remplacez LOCAL_DEBUG_PORT par le port de débogage dans votre environnement local.

  3. Ajoutez un point d'arrêt dans le code source de votre application qui suspend la requête HTTP traitement, puis lancez l'exécution débogage avec la configuration Debug Remote ajoutée précédemment.

Dans l'espace de message privé de votre application Chat, saisissez à tester et appuyez sur enter. Votre L'application Chat ne répond pas, car elle est en cours d'exécution débogué dans l'IDE Visual Studio Code.