Esercitazione: Eseguire il debug di un'applicazione Java distribuita in un cluster di Azure Service Fabric locale

Questa è la seconda di una serie di esercitazioni. Si apprenderà come collegare un debugger remoto usando Eclipse per l'applicazione Service Fabric. Si apprenderà anche come reindirizzare i log dalle applicazioni in esecuzione a un percorso pratico per lo sviluppatore.

In questa serie di esercitazioni si apprenderà come:

Nella seconda parte della serie si apprenderà come:

Prerequisiti

Prima di iniziare questa esercitazione:

• Configurare l'ambiente di sviluppo per Mac o Linux. Seguire le istruzioni per installare il plug-in Eclipse, Gradle, Service Fabric SDK e l'interfaccia della riga di comando di Service Fabric (sfctl).

Scaricare l'applicazione di voto di esempio

Se l'applicazione di voto di esempio non è stata compilata nella parte 1 di questa serie di esercitazioni, è possibile scaricarla. In una finestra di comando eseguire il comando seguente per clonare il repository dell'app di esempio nel computer locale.

git clone https://github.com/Azure-Samples/service-fabric-java-quickstart

Compilare e distribuire l'applicazione nel cluster di sviluppo locale.

Eseguire il debug di un'applicazione Java con Eclipse

1. Aprire l'IDE di Eclipse nel computer e fare clic su File -> Importa

2. Nella finestra popup selezionare l'opzione Generale -> Progetti esistenti nell'area di lavoro e fare clic su Avanti.

3. Nella finestra Import Projects (Importa progetti) scegliere l'opzione Select root directory (Seleziona directory radice) e selezionare la directory Voting. Se è stata eseguita la prima serie di esercitazioni, la directory Voting si trova nella directory Eclipse-workspace.

4. Aggiornare l'elemento entryPoint.sh del servizio di cui eseguire il debug in modo che avvii il processo Java con i parametri di debug remoto. Per questa esercitazione viene usato il front-end senza stato Voting/VotingApplication/VotingWebPkg/Code/entryPoint.sh. In questo esempio la porta 8001 è impostata per il debug.

   java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -jar VotingWeb.jar
   

5. Aggiornare il manifesto dell'applicazione impostando il numero di istanze o di repliche per il servizio di cui eseguire il debug su uno. Questa impostazione evita che si verifichino conflitti per la porta usata per il debug. Per i servizi senza stato, ad esempio, impostare InstanceCount="1", mentre per i servizi con stato impostare la destinazione e le dimensioni minime del set di repliche su 1 nel modo seguente: TargetReplicaSetSize="1" MinReplicaSetSize="1".

6. Nell'IDE di Eclipse selezionare Esegui -> Configurazioni di debug -> Applicazione Java remota, fare clic sul pulsante Nuovo, impostare le proprietà come segue e fare clic su Applica.

   Name: Voting
   Project: Voting
   Connection Type: Standard
   Host: localhost
   Port: 8001
   

7. Inserire un punto di interruzione nella riga 109 del file Voting/VotingWeb/src/statelessservice/HttpCommunicationListener.java.

8. In Esplora pacchetti fare clic con il pulsante destro del mouse sul progetto Voting e scegliere Service Fabric -> Pubblica applicazione

9. Nella finestra Publish Application (Pubblica applicazione) selezionare Local.json dall'elenco a discesa e fare clic su Publish (Pubblica).

10. Nell'IDE di Eclipse selezionare Esegui -> Configurazioni di debug -> Applicazione Java remota, fare clic sulla configurazione Voting creata e quindi su Debug.

11. Passare al Web browser e accedere a localhost:8080. In questo modo, verrà automaticamente raggiunto il punto di interruzione ed Eclipse potrà accedere alla prospettiva di debug.

A questo punto, è possibile applicare questi stessi passaggi per eseguire il debug di qualsiasi applicazione di Service Fabric in Eclipse.

Reindirizzare i log applicazioni a un percorso personalizzato

La procedura seguente illustra come reindirizzare i log applicazioni dal percorso /var/log/syslog predefinito a un percorso personalizzato.

1. Attualmente le applicazioni in esecuzione nei cluster Linux di Service Fabric supportano solo la selezione di un singolo file di log. Per configurare un'applicazione affinché i log vengano sempre inviati a /tmp/mysfapp0.0.log, creare un file denominato logging.properties nel percorso seguente Voting/VotingApplication/VotingWebPkg/Code/logging.properties e aggiungere il contenuto seguente.

   handlers = java.util.logging.FileHandler
   
   java.util.logging.FileHandler.level = ALL
   java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter
   
   # This value specifies your custom location.
   # You will have to ensure this path has read and write access by the process running the SF Application
   java.util.logging.FileHandler.pattern = /tmp/mysfapp0.0.log
   

2. Aggiungere il parametro seguente nel file Voting/VotingApplication/VotingWebPkg/Code/entryPoint.sh per il comando di esecuzione Java:

   -Djava.util.logging.config.file=logging.properties
   

   L'esempio seguente illustra un'esecuzione di esempio con il debugger collegato, in modo analogo all'esecuzione nella sezione precedente.

   java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -Djava.util.logging.config.file=logging.properties -jar VotingWeb.jar
   

In questa fase si è appreso come eseguire il debug e l'accesso ai log applicazioni durante lo sviluppo di applicazioni Java di Service Fabric.

Passaggi successivi

In questa parte dell'esercitazione si è appreso come:

Passare all'esercitazione successiva: