빠른 시작: IntelliJ IDEA를 사용하여 Azure Container Apps에 배포

아티클
04/11/2024

이 문서에서는 IntelliJ IDEA용 Azure 도구 키트를 사용하여 컨테이너화된 애플리케이션을 Azure Container Apps에 배포하는 방법을 보여줍니다. 이 문서에서는 음악 앨범의 정적 컬렉션을 반환하는 샘플 백 엔드 웹 API 서비스를 사용합니다.

필수 조건

활성 구독이 있는 Azure 계정. 구독이 없는 경우 시작하기 전에 체험 계정을 만드세요.
지원되는 JDK(Java Development Kit) Azure에서 개발할 때 사용할 수 있는 JDK에 대한 자세한 내용은 Azure 및 Azure Stack에 대한 Java 지원을 참조하세요.
IntelliJ IDEA, Ultimate 또는 Community Edition.
Maven 3.5.0 이상.
Docker 클라이언트
IntelliJ용 Azure 도구 키트입니다. 자세한 내용은 IntelliJ용 Azure 도구 키트 설치를 참조하세요. 또한 IntelliJ용 Azure 도구 키트에 대한 Azure 계정에 로그인해야 합니다. 자세한 내용은 IntelliJ용 Azure 도구 키트에 대한 로그인 지침을 참조 하세요.

프로젝트 복제

다음 명령을 사용하여 샘플 앱을 복제하고 분기를 IDE 검사.

git clone https://github.com/Azure-Samples/containerapps-albumapi-java
cd containerapps-albumapi-java
git checkout IDE

열기를 선택하여 IntelliJ IDEA에서 프로젝트를 엽니다.

로컬로 프로젝트 빌드 및 실행

다음 명령을 사용하여 Maven을 사용하여 프로젝트를 빌드합니다.
```
mvn clean package -DskipTests
```
애플리케이션이 실행 중인지 확인하려면 브라우저 http://localhost:8080/albums를 열고 . 이 페이지는 다음 명령의 출력과 유사한 JSON 개체 목록을 반환합니다.
```
java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
```

Azure Container Registry에 이미지 푸시

Azure Container Apps에 프로젝트를 배포하려면 먼저 컨테이너 이미지를 빌드하고 Azure Container Registry에 푸시해야 합니다.

Azure 탐색기 보기에서 Azure 노드를 확장하고 Container Registries를 마우스 오른쪽 단추로 클릭한 다음 Azure Portal에서 만들기를 선택합니다.
컨테이너 레지스트리 만들기 페이지에서 다음 정보를 입력합니다.
- 구독: 컨테이너 레지스트리에 사용할 Azure 구독을 지정합니다.
- 리소스 그룹: 컨테이너 레지스트리에 대한 리소스 그룹을 지정합니다. 다음 옵션 중 하나를 선택합니다.
  - 새로 만들기: 새 리소스 그룹을 만들도록 지정합니다.
  - 기존 항목 사용: Azure 계정과 연결된 리소스 그룹 목록에서 선택해야 되도록 지정합니다.
- 레지스트리 이름: 새 컨테이너 레지스트리의 이름을 지정합니다.
- 위치: 컨테이너 레지스트리가 만들어지는 지역(예 : 미국 서부)을 지정합니다.
- SKU: 컨테이너 레지스트리의 서비스 계층을 지정합니다. 이 자습서에서는 기본을 선택합니다.
검토 + 만들기를 선택하고 정보가 올바른지 확인합니다. 그런 다음 만들기를 선택합니다.
프로젝트 탭에서 프로젝트로 이동하고 Dockerfile을 엽니다.
Azure 아이콘을 선택한 다음, Azure Container Registry에 이미지 푸시를 선택합니다.
이전 단계에서 만든 레지스트리를 선택하고 다음 정보를 입력한 다음 실행을 선택합니다.
- 리포지토리 이름: 리포지토리의 이름을 지정합니다.
- 태그 이름: 이미지 또는 기타 아티팩트 버전을 지정합니다.

환경 및 컨테이너 앱 만들기

다음 단계를 사용하여 환경을 설정하고 Azure에서 컨테이너 앱을 배포합니다.

Azure 탐색기 보기에서 Container Apps 환경을 마우스 오른쪽 단추로 클릭한 다음 컨테이너 앱 환경 만들기를 선택합니다.
컨테이너 앱 환경 만들기 페이지에서 다음 정보를 입력한 다음 확인을 선택합니다.
- 구독: 사용할 Azure 구독을 지정합니다.
- 리소스 그룹: 컨테이너 앱에 대한 리소스 그룹을 지정합니다. 다음 옵션 중 하나를 선택합니다.
  - 새로 만들기: 새 리소스 그룹을 만들도록 지정합니다.
  - 기존 항목 사용: Azure 계정과 연결된 리소스 그룹 목록에서 선택해야 되도록 지정합니다.
- 이름: 새 컨테이너 앱 환경의 이름을 지정합니다.
- 지역: 적절한 지역(예 : 미국 동부)을 지정합니다.
- Log Analytics 작업 영역: 사용하거나 기본값을 적용하려는 Log Analytics 작업 영역을 지정합니다.
만든 컨테이너 앱 환경을 마우스 오른쪽 단추로 클릭하고 Azure Explorer에서 컨테이너 앱 만들기>를 선택합니다. 다음 정보를 입력합니다.
- 구독: 사용할 Azure 구독을 지정합니다.
- 리소스 그룹: 컨테이너 앱에 대한 리소스 그룹을 지정합니다. 다음 옵션 중 하나를 선택합니다.
  - 새로 만들기: 새 리소스 그룹을 만들도록 지정합니다.
  - 기존 항목 사용: Azure 계정과 연결된 리소스 그룹 목록에서 선택해야 되도록 지정합니다.
- 이름: 새 컨테이너 앱의 이름을 지정합니다.
- 지역: 적절한 지역(예 : 미국 동부)을 지정합니다.
- 환경: 사용하려는 Container Apps 환경을 지정합니다.
- 빠른 시작: 빠른 시작 이미지 사용을 선택합니다.
확인을 선택합니다. 도구 키트는 앱 만들기에 성공하면 상태 메시지를 표시합니다.

컨테이너 앱 배포

프로젝트 탭에서 프로젝트로 이동하고 Dockerfile을 엽니다.
Azure 아이콘을 선택한 다음, 컨테이너 앱에 이미지 배포를 선택합니다.
Azure Container Apps에 이미지 배포 페이지에서 다음 정보를 입력한 다음 실행을 선택합니다.
- Dockerfile/Image: Dockerfile의 경로를 지정하거나 기본값을 적용합니다.
- Container Registry: 사용하려는 Container Registry를 지정합니다.
- 리포지토리 이름: Container Registry에서 사용할 리포지토리 이름을 지정합니다.
- 태그 이름: Container Registry에서 사용할 태그 이름을 지정합니다.
- 컨테이너 앱: 배포할 컨테이너 앱을 지정합니다.
- 수신: HTTP 또는 TCP 엔드포인트가 필요한 애플리케이션에 대해 수신을 사용하도록 설정합니다. 사용을 선택합니다.
- 외부 트래픽: HTTP 또는 TCP 엔드포인트가 필요한 애플리케이션에 대해 외부 트래픽을 사용하도록 설정합니다. 사용을 선택합니다.
- 대상 포트: 이 값을 컨테이너에서 사용하는 포트 번호로 설정합니다. 이 단계에서 포트 8080을 엽니다.
배포가 완료되면 IntelliJ용 Azure 도구 키트에 알림이 표시됩니다. 찾아보기를 선택하여 브라우저에서 배포된 앱을 엽니다.

브라우저의 주소 표시줄에서 앱 URL 끝에 경로를 추가하여 /albums 샘플 API 요청의 데이터를 봅니다.

리소스 정리

Azure Container Apps 리소스를 클린 제거하려면 리소스 또는 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 삭제하면 해당 리소스 그룹에 연결된 다른 모든 리소스가 함께 삭제됩니다. 다음 단계를 사용하여 리소스를 클린.

Azure Container Apps 리소스를 삭제하려면 왼쪽 Azure 탐색기 사이드바로 이동하여 Container Apps 환경 항목을 찾습니다.
삭제하려는 Azure Container Apps 서비스를 마우스 오른쪽 단추로 클릭한 다음 삭제를 선택합니다.
리소스 그룹을 삭제하려면 Azure Portal을 방문하여 구독에서 리소스를 수동으로 삭제합니다.

다음 단계

Azure Container Apps의 Java 개요

다음을 통해 공유