자습서: 로컬 Service Fabric 클러스터에 배포된 Java 애플리케이션 디버그

아티클
08/24/2024

이 자습서는 시리즈의 2부입니다. Eclipse를 사용하여 Service Fabric 애플리케이션에 원격 디버거를 연결하는 방법을 알아봅니다. 또한 개발자를 위해 편리한 위치에서 실행 중인 애플리케이션에서 로그를 리디렉션하는 방법을 알아봅니다.

이 자습서 시리즈에서는 다음 방법에 대해 알아봅니다.

Java Service Fabric Reliable Services 애플리케이션 빌드
로컬 클러스터에서 애플리케이션 배포 및 디버그
Azure 클러스터에 애플리케이션 배포
애플리케이션에 대한 모니터링 및 진단 설정
CI/CD를 설정합니다.

시리즈 2부에서는 다음 방법에 대해 알아봅니다.

Eclipse를 사용하여 Java 애플리케이션 디버그
구성 가능한 위치로 로그 리디렉션

필수 조건

이 자습서를 시작하기 전에:

Mac 또는 Linux용 개발 환경을 설정합니다. 지침에 따라 Eclipse 플러그 인, Gradle, Service Fabric SDK 및 Service Fabric CLI(sfctl)를 설치합니다.

투표 애플리케이션 예제 다운로드

이 자습서 시리즈의 1부에서 투표 예제 애플리케이션을 빌드하지 않은 경우 다운로드할 수 있습니다. 명령 창에서 다음 명령을 실행하여 로컬 컴퓨터에 샘플 앱 리포지토리를 복제합니다.

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

로컬 개발 클러스터에 애플리케이션을 빌드하고 배포합니다.

Eclipse를 사용하여 Java 애플리케이션 디버그

컴퓨터에서 Eclipse IDE를 열고 파일 -> 가져오기...를 클릭합니다.
팝업 창에서 일반 -> 작업 영역에서 기존 프로젝트 옵션을 선택하고 다음을 누릅니다.
프로젝트 가져오기 창에서 루트 디렉터리 선택 옵션을 선택하고 Voting 디렉터리를 선택합니다. 자습서 시리즈 1부를 따른 경우 Voting 디렉터리는 Eclipse 작업 공간 디렉터리 내에 있습니다.
디버그하려는 서비스의 entryPoint.sh를 원격 디버그 매개 변수를 사용하여 Java 프로세스를 시작하도록 업데이트합니다. 이 자습서의 경우 상태 비저장 프런트 엔드는 다음과 같이 사용됩니다. Voting/VotingApplication/VotingWebPkg/Code/entryPoint.sh. 이 예제에서는 디버깅을 위해 포트 8001이 설정되어 있습니다.
```
java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -jar VotingWeb.jar
```
인스턴스 수 또는 디버그하는 서비스의 복제본 수를 1로 설정하여 애플리케이션 매니페스트를 업데이트합니다. 이 설정은 디버깅에 사용되는 포트에 대한 충돌을 방지합니다. 예를 들어, 상태 비저장 서비스의 경우 InstanceCount="1"을 설정하고 상태 저장 서비스의 경우 TargetReplicaSetSize="1" MinReplicaSetSize="1"과 같이 대상과 최소 복제본 세트 크기를 1로 설정합니다.
Eclipse IDE에서 실행 -> 구성 디버그 -> 원격 Java 애플리케이션을 선택하고 새 단추를 누르고 속성을 다음과 같이 설정하고 적용을 클릭합니다.
```
Name: Voting
Project: Voting
Connection Type: Standard
Host: localhost
Port: 8001
```
Voting/VotingWeb/src/statelessservice/HttpCommunicationListener.java 파일의109번째 줄에 중단점을 놓습니다.
패키지 탐색기에서 Voting 프로젝트를 마우스 오른쪽 단추로 클릭하고 Service Fabric -> 애플리케이션 게시...를 클릭합니다.
애플리케이션 게시 창의 드롭다운 메뉴에서 Local.json을 선택하고 게시를 클릭합니다.
Eclipse IDE에서 실행 -> 구성 디버그 -> 원격 Java 애플리케이션을 선택하고 만든 Voting 구성을 클릭하고 디버그를 클릭합니다.
웹 브라우저로 이동하여 localhost:8080에 액세스합니다. 그러면 자동으로 중단점에 도달하고 Eclipse는 디버그 큐브 뷰를 시작합니다.

이제 동일한 단계를 적용하여 Eclipse에서 모든 Service Fabric 애플리케이션을 디버깅할 수 있습니다.

애플리케이션 로그를 사용자 지정 위치로 리디렉션

다음 단계는 기본 /var/log/syslog 위치에서 사용자 지정 위치로 애플리케이션 로그를 리디렉션하는 방법을 설명합니다.

현재 Service Fabric Linux 클러스터에서 실행 중인 애플리케이션은 단일 로그 파일 선택만 지원합니다. 로그가 항상 /tmp/mysfapp0.0.log로 이동하도록 애플리케이션을 설정하려면, 다음 위치 Voting/VotingApplication/VotingWebPkg/Code/logging.properties에 logging.properties라는 파일을 만들고 다음 내용을 추가합니다.
```
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
```
Java 실행 명령에 대한 다음 매개 변수를 Voting/VotingApplication/VotingWebPkg/Code/entryPoint.sh에 추가합니다.
```
-Djava.util.logging.config.file=logging.properties
```
다음 예제는 첨부된 디버거를 사용한 샘플 실행을 보여주며, 이전 섹션의 실행과 유사합니다.
```
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
```

이 단계에서는 Service Fabric Java 애플리케이션을 개발하는 동안 애플리케이션 로그를 디버그하고 액세스하는 방법을 알아봅니다.

다음 단계

자습서의 이 부분에서는 다음 방법에 대해 알아봅니다.

Eclipse를 사용하여 Java 애플리케이션 디버그
구성 가능한 위치로 로그 리디렉션

다음 자습서를 진행합니다.

Azure에 애플리케이션 배포

다음을 통해 공유