Visual Studio Code를 사용하여 Java Service Fabric 애플리케이션 개발

2024-08-25

VS Code용 Service Fabric Reliable Services 확장을 사용하면 Windows, Linux 및 macOS 운영 체제에서 Java Service Fabric 애플리케이션을 쉽게 빌드할 수 있습니다.

이 문서에서는 Visual Studio Code를 사용하여 Java Service Fabric 애플리케이션을 빌드, 배포 및 디버그하는 방법을 보여 줍니다.

Important

Service Fabric Java 애플리케이션은 Windows 컴퓨터에서 개발할 수 있지만 Azure Linux 클러스터에만 배포할 수 있습니다. Windows에서는 Java 애플리케이션을 디버그할 수 없습니다.

필수 조건

이 문서에서는 VS Code, VS Code용 Service Fabric Reliable Services 확장 및 개발 환경에 필요한 모든 종속성을 설치했다고 가정합니다. 자세한 내용은 시작을 참조하세요.

샘플 다운로드

이 문서에서는 Service Fabric Java 애플리케이션 빠른 시작 샘플 GitHub 리포지토리의 Voting 애플리케이션을 사용합니다.

개발 컴퓨터에 리포지토리를 복제하려면 터미널 창(Windows의 명령 창)에서 다음 명령을 실행합니다.

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

VS Code에서 애플리케이션 열기

VS Code를 엽니다. 작업 막대에서 탐색기 아이콘을 클릭하고 폴더 열기를 클릭하거나 파일 -> 폴더 열기를 클릭합니다. 리포지토리를 복제한 폴더의 ./service-fabric-java-quickstart/Voting 디렉터리로 이동한 후 확인을 클릭합니다. 작업 영역에는 아래 스크린샷에 표시된 것과 동일한 파일이 포함되어야 합니다.

작업 영역의 Java Voting 애플리케이션

애플리케이션 빌드

VS Code에서 (Ctrl + Shift + p)를 눌러 명령 팔레트를 엽니다.
Service Fabric: Build Application 명령을 검색한 후 선택합니다. 빌드 출력이 통합된 터미널로 전송됩니다.

로컬 클러스터에 애플리케이션 배포

애플리케이션이 빌드되면 로컬 클러스터에 배포할 수 있습니다.

Important

Windows 컴퓨터에서는 로컬 클러스터로 Java 애플리케이션을 배포할 수 없습니다.

명령 팔레트에서 Service Fabric: Deploy Application (Localhost) 명령을 선택합니다. 설치 프로세스의 출력이 통합된 터미널로 전송됩니다.
배포가 완료되면 브라우저를 시작하고 http://localhost:19080/Explorer의 Service Fabric Explorer를 엽니다. 애플리케이션이 실행되고 있는 것을 확인할 수 있습니다. 다소 시간이 소요되니 기다려 주세요.
애플리케이션이 실행되고 있는지 확인한 후 브라우저를 시작하고 http://localhost:8080 페이지를 엽니다. 애플리케이션의 웹 프런트 엔드입니다. 항목을 추가하고 클릭하여 투표할 수 있습니다.
클러스터에서 애플리케이션을 제거하려면 명령 팔레트에서 Service Fabric: Remove Application 명령을 선택합니다. 제거 프로세스의 출력이 통합된 터미널로 전송됩니다. Service Fabric Explorer를 사용하여 애플리케이션이 로컬 클러스터에서 제거되었는지 확인할 수 있습니다.

애플리케이션 디버그

VS Code에서 애플리케이션을 디버그할 때 애플리케이션은 로컬 클러스터에서 실행되고 있어야 합니다. 그래야 코드에 중단점을 추가할 수 있습니다.

Important

Windows 컴퓨터에서는 Java 애플리케이션을 디버그할 수 없습니다.

VotingDataService 및 Voting 애플리케이션을 디버그할 수 있게 준비하려면 다음 단계를 수행합니다.

Voting/VotingApplication/VotingDataServicePkg/Code/entryPoint.sh 파일을 업데이트합니다. 6번 줄에서 명령을 주석 처리하고(# 사용) 파일 끝에 다음 명령을 추가합니다.
```
java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -jar VotingDataService.jar
```
Voting/VotingApplication/ApplicationManifest.xml 파일을 업데이트합니다. StatefulService 요소에서 MinReplicaSetSize 및 TargetReplicaSetSize 특성을 "1"로 설정합니다.
```
      <StatefulService MinReplicaSetSize="1" ServiceTypeName="VotingDataServiceType" TargetReplicaSetSize="1">
```
작업 막대에서 디버그 아이콘을 클릭하여 VS Code에서 디버거 보기를 엽니다. 디버거 보기의 맨 위에 있는 톱니바퀴 아이콘을 클릭하고 드롭다운 메뉴에서 Java를 선택합니다. launch.json 파일이 열립니다.
launch.json 파일에서 디버그(연결) 구성의 포트 값을 8001로 설정합니다. 파일을 저장합니다.
Service Fabric: Deploy Application (Localhost) 명령을 사용하여 로컬 클러스터에 애플리케이션을 배포합니다. 애플리케이션이 Service Fabric Explorer에서 실행되고 있는지 확인합니다. 애플리케이션을 디버그할 준비가 되었습니다.

중단점을 설정하려면 다음 단계를 수행합니다.

Explorer에서 /Voting/VotingDataService/src/statefulservice/VotingDataService.java 파일을 엽니다. addItem 메서드의 try 블록에서 첫 번째 코드 줄에 중단점을 설정합니다(줄 80).

Important

코드의 실행 파일 줄에 중단점을 설정해야 합니다. 예를 들어, 메서드 선언, try 문 또는 catch 문에 설정된 중단점은 디버거에서 건너뜁니다.
디버깅을 시작하려면 작업 막대에서 디버그 아이콘을 클릭하고 디버그 메뉴에서 디버그(연결) 구성을 선택한 후 실행 단추(녹색 화살표)를 클릭합니다.
웹 브라우저에서 http://localhost:8080로 이동합니다. 텍스트 상자에 새 항목을 입력하고 + 추가를 클릭합니다. 중단점이 적중되어야 합니다. VS Code 맨 위에 있는 디버그 도구 모음을 사용하여 실행을 계속하거나, 줄을 건너뛰거나, 메서드를 한 단계씩 실행하거나, 현재 메서드에서 나갈 수 있습니다.
디버깅 세션을 종료하려면 VS Code 맨 위에 있는 디버그 도구 모음에서 플러그 아이콘을 클릭합니다.
디버깅을 완료한 경우 Service Fabric: Remove Application 명령을 사용하여 로컬 클러스터에서 Voting 애플리케이션이 제거할 수 있습니다.