Tutorial: Depurar um aplicativo Java implantado em um cluster local do Service Fabric

Artigo
06/01/2023

Este tutorial é a parte dois de uma série. Você aprenderá como anexar um depurador remoto usando o Eclipse para o aplicativo do Service Fabric. Além disso, você aprenderá a redirecionar os logs dos aplicativos em execução para um local conveniente para o desenvolvedor.

Nesta série de tutoriais, você aprenderá a:

Compilar um aplicativo Java do Reliable Services no Service Fabric
Implantar e depurar o aplicativo em um cluster local
Implantar o aplicativo em um cluster do Azure
Configurar monitoramento e diagnóstico para o aplicativo
Configurar CI/CD

Na segunda parte da série, você aprenderá como:

Depurar o aplicativo Java usando o Eclipse
Redirecionar logs para um local configurável

Pré-requisitos

Antes de começar este tutorial:

Configurar seu ambiente de desenvolvimento no Mac ou no Linux. Siga as instruções para instalar o plug-in do Eclipse, o Gradle, o SDK do Service Fabric e a CLI do Service Fabric (sfctl).

Baixar o aplicativo de exemplo Votação

Se você não tiver criado o aplicativo de exemplo Votação na parte um esta série de tutoriais, poderá baixá-lo. Em uma janela de comando, execute o comando a seguir para clonar o repositório de aplicativos de exemplo no computador local.

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

Compile e implante o aplicativo no cluster de desenvolvimento local.

Depurar o aplicativo Java usando o Eclipse

Abra o IDE do Eclipse em seu computador e clique em Arquivo -> Importar...
Na janela pop-up, selecione a opção Geral ->; Projetos Existentes no Workspace e pressione Avançar.
Na janela Importar Projetos, escolha a opção Selecionar diretório raiz e escolha o diretório Votação. Se você seguiu a primeira série de tutoriais, o diretório Votação estará no diretório Eclipse-espaço de trabalho.
Atualize entryPoint.sh do serviço que você quer depurar para que ele inicie o processo java com parâmetros de depuração remota. Para este tutorial, o front-end sem estado é usado: Voting/VotingApplication/VotingWebPkg/Code/entryPoint.sh. Neste exemplo, a porta 8001 foi definida para depuração.
```
java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -jar VotingWeb.jar
```
Atualize o Manifesto do Aplicativo, definindo a contagem de instâncias ou a contagem de réplicas para o serviço que está sendo depurado como um. Essa configuração evita conflitos para a porta que é usada para depuração. Por exemplo, para serviços sem estado, defina InstanceCount="1" e, para serviços com estado, defina o destino e o tamanho mínimo do conjunto de réplicas para 1, como se segue: TargetReplicaSetSize="1" MinReplicaSetSize="1".
No IDE do Eclipse, escolha Executar -> Configurações de Depuração -> Aplicativo Java Remoto, pressione o botão Novo e defina as propriedades da seguinte maneira e clique em Aplicar.
```
Name: Voting
Project: Voting
Connection Type: Standard
Host: localhost
Port: 8001
```
Coloque um ponto de interrupção na linha 109 do arquivo Voting/VotingWeb/src/statelessservice/HttpCommunicationListener.java.
No Package Explorer, clique com botão direito do mouse no projeto Votação e clique em Service Fabric -> Publicar Aplicativo...
Na janela Publicar Aplicativo, selecione Local.json na lista suspensa e clique em Publicar.
No IDE do Eclipse, selecione Executar -> Configurações de Depuração -> Aplicativo Java Remoto, clique na configuração de Votação que você criou e clique em Depurar.
No navegador da Web, acesse localhost:8080. Isso atingirá automaticamente o ponto de interrupção e o Eclipse vai inserir a Perspectiva de depuração.

Agora você pode aplicar estas mesmas etapas para depurar qualquer aplicativo do Service Fabric no Eclipse.

Redirecionar os logs de aplicativo para o local personalizado

As etapas a seguir explicam como redirecionar os logs de aplicativo do local padrão /var/log/syslog para um local personalizado.

Atualmente, os aplicativos em execução em clusters do Linux do Service Fabric são compatíveis somente com a seleção de um único arquivo de log. Para configurar um aplicativo para que os logs sempre vão para /tmp/mysfapp0.0.log, crie um arquivo chamado logging.properties na seguinte localização Voting/VotingApplication/VotingWebPkg/Code/logging.properties e adicione o seguinte conteúdo.
```
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
```
Adicione o seguinte parâmetro no Voting/VotingApplication/VotingWebPkg/Code/entryPoint.sh para o comando de execução de Java:
```
-Djava.util.logging.config.file=logging.properties
```
O exemplo a seguir mostra um exemplo de execução com o depurador anexado, semelhante à execução na seção anterior.
```
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
```

Neste estágio, você aprendeu a depurar e acessar seus logs de aplicativo durante o desenvolvimento de seus aplicativos Java do Service Fabric.

Próximas etapas

Nesta parte do tutorial, você aprendeu a:

Depurar o aplicativo Java usando o Eclipse
Redirecionar logs para um local configurável

Prosseguir para o próximo tutorial:

Implantar aplicativo no Azure

Compartilhar via