Débogage à distance du service Query

Vous pouvez définir des extensions de débogage à distance vers votre service Query. Cette fonction à distance permet à vos développeurs de voir l'état actuel des variables et de tirer parti de la permutation à chaud du code pour voir vos modifications reflétées dans le serveur au fur et à mesure qu'ils développent du code.

Before you begin

Pour plus d'informations sur la permutation à chaud de code, voir Activer le remplacement de fichier de classe "HotSwap" dans la documentation Java Platform Debugger Architecture Java SE 1.4 Enhancements.

About this task

Pour activer le débogage à distance sur le service Query, procédez comme suit :

Procedure

Dans le conteneur de service Query, localisez le fichier jvm.options dans /opt/WebSphere/Liberty/usr/servers/default/jvm.option. Ajoutez ce qui suit en tant que nouvelle ligne dans ce fichier :
```
-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=7777
```
Les paramètres configurables sont les suivants :

address

Port de débogage sur lequel le débogueur Eclipse doit se connecter. 7777 est le port de débogage par défaut du serveur Liberty. L'utilisateur peut le remplacer par n'importe quel autre port disponible.

suspend=y

Arrête le démarrage du serveur jusqu'à ce qu'un débogueur se connecte au port de débogage. Si ce comportement n'est pas requis, suspend=n peut être utilisé. Dans ce cas, le serveur démarre normalement lors de l'écoute via le port de débogage pour qu'un débogueur puisse se connecter à tout moment.
Le port de débogage doit être exposé dans le conteneur de service Query afin que le débogueur Eclipse puisse se connecter à ce port et communiquer avec l'application de service Query. Pour ce faire, éditez le fichier docker-compose.yml. Voici un exemple de configuration :
```
version '2.3'

services:
  query:
    image: comlnx94.prod.hclpnp.com/9.1.9.0/search-query-app:v9-latest
    mem_reservation: 2g
    mem_limit: 3g
    ports:
       - "30900:30900"
       - "30901:30901"
       - "7777:7777"
```
Dans le projet Eclipse contenant le code source de votre extension de service Query, cliquez avec le bouton droit de la souris sur le projet et accédez à Déboguer en tant que > Configurations de débogage….
Ajoutez l'adresse IP de votre machine virtuelle dans la zone d'entrée Hôte et le port de débogage dans la zone Port. Vérifiez que Type de connexion est défini sur Socket Attach. Cliquez sur Déboguer pour connecter votre débogueur au port de débogage d'écoute du service Query.
Note: Ne conservez pas les configurations de débogage à distance activées dans le environnement de production, car cela a des répercussions sur les performances et la sécurité. La fonctionnalité de débogage à distance doit être utilisée uniquement dans les environnements de développement. En outre, notez que cette fonction de débogage à distance fonctionne uniquement avec un environnement d'exécution Docker local.