빠른 시작: Azure Spring Apps에 이벤트 기반 애플리케이션 배포

참고 항목

기본, 표준 및 엔터프라이즈 계획은 2025년 3월 중순부터 사용되지 않으며 3년의 은퇴 기간이 있습니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 사용 중지 공지 사항을 참조하세요.

표준 소비 및 전용 계획은 2024년 9월 30일부터 사용되지 않으며 6개월 후에 완전히 종료됩니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 표준 사용량 및 전용 계획을 Azure Container Apps로 마이그레이션을 참조 하세요.

이 문서는 표준 사용량 및 전용(미리 보기) ✅ Basic/Standard ✅ Enterprise에 적용됩니다.✅

이 문서에서는 Azure Spring Apps에 Spring Boot 이벤트 기반 애플리케이션을 배포하는 방법을 설명합니다.

샘플 프로젝트는 lower-case라는 Service Bus 큐을 구독한 다음 메시지를 처리하고 다른 메시지를 upper-case라는 다른 큐로 보내는 이벤트 기반 애플리케이션입니다. 앱을 간단하게 만들기 위해 메시지 처리는 메시지를 대문자로 변환하기만 합니다. 다음 다이어그램에서 이 프로세스를 보여 줍니다.

이 문서에서는 다음과 같이 Azure Spring Apps에 배포하는 옵션을 설명합니다.

• Azure Portal 옵션은 가장 쉽고 빠른 방법이며 클릭 한 번으로 리소스를 만들고 애플리케이션을 배포할 수 있습니다. 이 옵션은 애플리케이션을 Azure 클라우드 서비스에 빠르게 배포하려는 Spring 개발자에게 적합합니다.
• Azure Portal + Maven 플러그 인 옵션은 보다 일반적인 방법이며 리소스를 만들고 애플리케이션을 단계별로 배포할 수 있습니다. 이 옵션은 Azure 클라우드 서비스를 처음 사용하는 Spring 개발자에게 적합합니다.
• Azure Developer CLI 옵션은 보다 효율적인 방법이며 간단한 명령을 통해 자동으로 리소스를 만들고 애플리케이션을 배포할 수 있습니다. Azure Developer CLI는 템플릿을 사용하여 필요한 Azure 리소스를 프로비전하고 애플리케이션 코드를 배포합니다. 이 옵션은 Azure 클라우드 서비스를 능숙하게 다루는 Spring 개발자에게 적합합니다.

• Azure Portal 옵션은 가장 쉽고 빠른 방법이며 클릭 한 번으로 리소스를 만들고 애플리케이션을 배포할 수 있습니다. 이 옵션은 애플리케이션을 Azure 클라우드 서비스에 빠르게 배포하려는 Spring 개발자에게 적합합니다.
• Azure Portal + Maven 플러그 인 옵션은 보다 일반적인 방법이며 리소스를 만들고 애플리케이션을 단계별로 배포할 수 있습니다. 이 옵션은 Azure 클라우드 서비스를 처음 사용하는 Spring 개발자에게 적합합니다.
• Azure CLI 옵션은 강력한 명령줄 도구를 사용하여 Azure 리소스를 관리합니다. 이 옵션은 Azure 클라우드 서비스를 능숙하게 다루는 Spring 개발자에게 적합합니다.

1. 사전 요구 사항

Azure Portal

• Azure 구독 Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

Azure Portal + Maven 플러그 인

• Azure 구독 Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
• Git
• Java Development Kit (JDK), 버전 17.

Azure Developer CLI

• Azure 구독 Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
• Git
• Java Development Kit (JDK), 버전 17.
• AZD(Azure Developer CLI) 버전 1.2.0 이상

Azure Portal

• Azure 구독 Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
• 대상 구독에서 처음으로 Azure Spring Apps 엔터프라이즈 플랜 인스턴스를 배포하는 경우 Azure Marketplace에서 Azure Spring Apps 엔터프라이즈 계층 제품 보기의 요구 사항 섹션을 참조하세요.

Azure Portal + Maven 플러그 인

• Azure 구독 Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
• 대상 구독에서 처음으로 Azure Spring Apps 엔터프라이즈 플랜 인스턴스를 배포하는 경우 Azure Marketplace에서 Azure Spring Apps 엔터프라이즈 계층 제품 보기의 요구 사항 섹션을 참조하세요.
• Git
• Java Development Kit (JDK), 버전 17.

Azure CLI

• Azure 구독 Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
• 대상 구독에서 처음으로 Azure Spring Apps 엔터프라이즈 플랜 인스턴스를 배포하는 경우 Azure Marketplace에서 Azure Spring Apps 엔터프라이즈 계층 제품 보기의 요구 사항 섹션을 참조하세요.
• Git
• Java Development Kit (JDK), 버전 17.
• Azure CLI: 버전 2.45.0 이상

2. Spring 프로젝트 준비

Azure Portal

다음 섹션의 Azure에 배포 단추를 누르면 GitHub의 ASA-Samples-Web-Application 릴리스 페이지에서 JAR 패키지를 다운로드하는 Azure Portal 환경이 시작됩니다. 로컬 준비 단계는 필요하지 않습니다.

Azure Portal + Maven 플러그 인

다음 단계를 따라 샘플을 로컬로 준비합니다.

1. 샘플 프로젝트는 GitHub에서 준비되었습니다. 다음 명령을 사용하여 샘플 프로젝트를 복제합니다.

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. 다음 명령을 사용하여 샘플 프로젝트를 빌드합니다.

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Azure Developer CLI

다음 단계에서 샘플을 로컬로 준비합니다. 이 단계에서는 AZD를 사용하여 Azure Developer CLI 템플릿에서 이벤트 기반 애플리케이션을 초기화합니다.

1. 터미널을 열고 비어 있는 새 폴더를 만든 다음, 터미널로 이동합니다.

2. 다음 명령을 사용하여 프로젝트를 초기화합니다.

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • 새 환경 이름 입력: 모든 Azure 리소스를 보관하기 위해 만든 리소스 그룹에 대한 접미사로 사용되는 환경 이름을 제공합니다. 이 이름은 Azure 구독 내에서 고유해야 합니다.

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

3. 클라우드 환경 준비

이 샘플을 실행하는 데 필요한 기본 리소스는 Azure Spring Apps 인스턴스, Azure Key Vault Azure Service Bus 인스턴스입니다. 다음 단계에서 이러한 리소스를 만듭니다.

Azure Portal

이 섹션에서는 Azure에 배포 단추를 사용하여 Azure Portal에서 배포 환경을 시작합니다. 이 환경에서는 ARM 템플릿을 사용하여 Azure 리소스를 만듭니다.

3.1. Azure Portal에 로그인

Azure Portal로 이동하고 자격 증명을 입력하여 포털에 로그인합니다. 기본 보기는 서비스 대시보드입니다.

3.2. Azure 리소스 만들기

다음 단계를 따라 앱에 사용하는 모든 Azure 리소스를 만듭니다.

1. 다음 Azure에 배포 단추를 선택하여 Azure Portal에서 배포 환경을 시작합니다.

   

2. 기본 사항 탭에서 양식을 작성합니다. 양식을 작성하기 위한 지침으로 다음 표를 사용합니다.

   설정	제안 값	설명
   구독	구독 이름입니다.	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   지역	사용자에게 가장 가까운 지역입니다.	지역은 리소스 그룹을 만드는 데 사용됩니다.

3. 검토 및 만들기를 선택하여 선택 사항을 검토합니다. 그런 다음 만들기를 선택하여 앱을 Azure Spring Apps에 배포합니다.

4. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스의 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다. 리소스로 이동을 선택하여 서비스의 개요 페이지를 엽니다.

   

Azure Portal + Maven 플러그 인

3.1. Azure Portal에 로그인

웹 브라우저를 열고 Azure Portal로 이동합니다. 자격 증명을 입력하여 포털에 로그인합니다. 기본 보기는 서비스 대시보드입니다.

3.2. Service Bus 인스턴스 만들기

다음 단계를 따라 Service Bus 인스턴스를 만듭니다.

1. Azure Portal의 모서리에서 리소스 만들기를 선택합니다.

2. 서비스 및 마켓플레이스 검색 검색 상자에서 Service Bus를 검색합니다.

3. Service Bus 섹션에서 만들기를 선택합니다.

4. 기본 사항 탭에서 양식을 작성합니다. 양식을 작성하기 위한 지침으로 다음 표를 사용합니다.

   설정	제안 값	설명
   구독	구독 이름입니다.	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   네임스페이스 이름	my-srvbus	Service Bus 서비스를 식별하는 고유한 이름입니다.
   위치	사용자에게 가장 가까운 위치입니다.	사용자에게 가장 가까운 위치입니다.
   호스팅 옵션 및 계획	기본	요금제에 따라 인스턴스와 관련된 리소스 및 비용이 결정됩니다.

5. 검토 및 만들기를 선택하여 만들기 매개 변수를 검토합니다. 그런 다음, 만들기를 선택하여 Service Bus 인스턴스 만들기를 완료합니다.

6. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스의 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다. 리소스로 이동을 선택하여 서비스의 개요 페이지를 엽니다.

   

7. 리소스로 이동을 선택하여 Service Bus 네임스페이스 페이지로 이동합니다.

8. 탐색 메뉴에서 공유 액세스 정책을 선택한 다음, RootManageSharedAccessKey를 선택합니다.

9. SAS 정책: RootManageSharedAccessKey 페이지에서 Spring 앱 연결을 설정하는 데 사용되는 기본 연결 문자열 값을 복사하고 저장합니다.

10. 탐색 메뉴에서 큐를 선택한 다음, 큐를 선택합니다.

11. 큐 만들기 페이지에서 이름을 소문자로 입력한 다음, 만들기를 선택합니다.

12. 이름을 대문자로 입력한 다음, 이전 단계를 반복하여 다른 큐를 만듭니다.

3.3. Azure Spring Apps 인스턴스 만들기

다음 단계를 따라 서비스 인스턴스를 만듭니다.

1. 포털의 모서리에서 리소스 만들기를 선택합니다.

2. 컴퓨팅>Azure Spring Apps를 선택합니다.

3. 다음 정보를 사용하여 표준 사용량 및 전용(미리 보기) 양식을 작성합니다.

   설정	제안 값	설명
   구독	구독 이름	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   이름	myasa	Azure Spring Apps 서비스를 식별하는 고유한 이름입니다. 이름은 4-32자 사이여야 하며, 소문자, 숫자 및 하이픈(-) 문자만 포함할 수 있습니다. 서비스 이름의 첫 글자는 문자여야 하며 마지막 문자는 문자 또는 숫자여야 합니다.
   계획	표준 사용량 및 전용(미리 보기)	요금제에 따라 인스턴스와 관련된 리소스 및 비용이 결정됩니다.
   지역	사용자와 가장 가까운 지역	사용자에게 가장 가까운 위치입니다.
   Container Apps 환경	myacaenv	이 환경은 서로 통신하고 가상 네트워크, 로깅, Dapr 구성을 공유할 수 있는 하나 이상의 컨테이너 앱을 둘러싼 보안 경계입니다.

4. (선택 사항) 다음 단계를 따라 Container Apps 환경을 만듭니다.

   사용량 워크로드

   1. 기본 탭에 다음 정보를 입력합니다.

      • 환경 이름: myacaenv
      • 플랜: 사용량
      • 영역 중복: 사용 안 함

   2. 만들기를 선택하여 Container Apps 환경을 만듭니다.

   전용 워크로드

   1. 기본 탭에 다음 정보를 입력합니다.

      • 환경 이름: myacaenv
      • 플랜: (미리 보기) 사용량 및 전용 워크로드 프로필
      • 영역 중복: 사용 안 함

   2. 워크로드 프로필(미리 보기) 탭을 선택한 다음, 워크로드 프로필 추가를 선택하여 워크로드 프로필을 추가합니다.

   3. 워크로드 프로필 추가(미리 보기) 페이지에서 다음 정보를 추가합니다.

      • 워크로드 프로필 이름: my-wlp
      • 워크로드 프로필 크기: Dedicated-D4를 선택합니다.
      • 인스턴스 수 범위 자동 조정: 3 및 5을 선택합니다.

   4. 추가를 선택합니다. 이 옵션을 선택하면 워크로드 프로필 추가(미리 보기) 페이지로 돌아갑니다. my-wlp를 선택한 다음, 만들기를 선택하여 Container Apps 환경을 만듭니다.

5. 검토 및 만들기를 선택하여 선택 사항을 검토합니다. 만들기를 선택하여 Azure Spring Apps 인스턴스를 프로비전합니다.

6. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스에 대한 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다. 리소스로 이동 옵션을 선택하면 서비스의 개요 페이지가 열립니다.

   

7. 리소스로 이동을 선택하여 Azure Spring Apps 개요 페이지로 이동합니다.

8. 왼쪽 탐색 메뉴에서 앱을 선택한 다음, 앱 만들기를 선택합니다.

9. 앱 만들기 페이지에서 앱 이름에 simple-event-driven-app을 입력한 다음, 빠른 시작 샘플 앱 사용을 선택하여 앱을 만듭니다.

   

10. 만들기를 선택하여 Azure Spring Apps 인스턴스 만들기를 완료합니다.

11. 앱을 만든 후 이전 단계에서 만든 앱 이름을 선택합니다.

12. 탐색 창에서 구성을 선택한 다음, 환경 변수 탭에서 다음 속성을 구성합니다.

    • SERVICE_BUS_CONNECTION_STRING: Service Bus 기본 연결 문자열을 입력합니다.

    

13. 저장을 선택하여 연결 속성을 저장합니다.

Azure Developer CLI

1. 다음 명령을 사용하여 OAuth2로 Azure에 로그인합니다. 이미 로그인한 경우 이 단계를 무시하세요.

   azd auth login
   

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   Logged in to Azure.
   

2. 다음 명령을 사용하여 템플릿의 인프라를 Azure에 프로비전합니다.

   azd provision
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • 사용할 Azure 구독 선택: 화살표를 사용하여 이동하고 필터링할 대상을 입력한 다음, Enter 키를 누릅니다.
   • 사용할 Azure 위치 선택: 화살표를 사용하여 이동하고 필터링할 대상을 입력한 다음, Enter 키를 누릅니다.

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   참고 항목

   이 명령을 완료하는 데 다소 시간이 걸릴 수 있습니다. Azure 리소스를 프로비전하면 진행률 표시기가 표시됩니다.

4. Azure Spring Apps에 앱 배포

Azure Portal

이전 섹션에서 Azure에 배포 단추를 누르면 애플리케이션 배포가 포함된 Azure Portal 환경이 시작되므로 다른 작업은 필요하지 않습니다.

Azure Portal + Maven 플러그 인

다음 단계를 따라 Azure Spring Apps용 Maven 플러그 인을 사용하여 배포합니다.

1. 전체 디렉터리로 이동한 후 다음 명령을 실행하여 Azure Spring Apps에서 앱을 구성합니다.

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • OAuth2 로그인: OAuth2 프로토콜에 따라 Azure에 대한 로그인 권한을 부여해야 합니다.
   • 구독 선택: 만든 Azure Spring Apps 인스턴스의 구독 목록 번호를 선택합니다. 기본값은 목록의 첫 번째 구독입니다. 기본 번호를 사용하는 경우 바로 Enter 키를 누릅니다.
   • Azure에서 기존 Azure Spring Apps 사용: 기존 Azure Spring Apps 인스턴스를 사용하려면 y 키를 누릅니다.
   • 배포할 Azure Spring Apps 선택: 만든 Azure Spring Apps 인스턴스의 목록 번호를 선택합니다. 기본 번호를 사용하는 경우 바로 Enter 키를 누릅니다.
   • Azure Spring Apps <your-instance-name>에서 기존 앱 사용: 만든 앱을 사용하려면 y를 누릅니다.
   • 위 모든 구성 저장 확인: y 키를 누릅니다. n 키를 누르면 구성이 POM 파일에 저장되지 않습니다.

2. 다음 명령을 사용하여 앱을 배포합니다.

   ./mvnw azure-spring-apps:deploy
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • OAuth2 로그인: OAuth2 프로토콜에 따라 Azure에 대한 로그인 권한을 부여해야 합니다.

   명령이 실행되면 다음 로그 메시지에서 배포가 성공했음을 확인할 수 있습니다.

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Azure Developer CLI

다음 단계를 따라 AZD를 사용하여 앱을 패키지하고 웹 애플리케이션에 필요한 Azure 리소스를 프로비전한 다음, Azure Spring Apps에 배포합니다.

1. 다음 명령을 사용하여 배포 가능한 애플리케이션 복사본을 패키지합니다.

   azd package
   

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. 다음 명령을 사용하여 애플리케이션 코드를 새롭게 프로비전된 해당 리소스에 배포합니다.

   azd deploy
   

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - No endpoints were found
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

참고 항목

azd up을 사용하여 이전의 3가지 명령인 azd provision(Azure 리소스 프로비전), azd package(배포 가능한 애플리케이션 복사본 패키지), azd deploy(애플리케이션 코드 배포)를 결합할 수도 있습니다. 자세한 내용은 Azure-Samples/ASA-Samples-Event-Driven-Application을 참조하세요.

2. Spring 프로젝트 준비

Azure Portal

다음 섹션의 Azure에 배포 단추를 누르면 GitHub의 ASA-Samples-Web-Application 릴리스 페이지에서 JAR 패키지를 다운로드하는 Azure Portal 환경이 시작됩니다. 로컬 준비 단계는 필요하지 않습니다.

Azure Portal + Maven 플러그 인

다음 단계를 따라 샘플을 로컬로 준비합니다.

1. 샘플 프로젝트는 GitHub에서 준비되었습니다. 다음 명령을 사용하여 샘플 프로젝트를 복제합니다.

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. 다음 명령을 사용하여 샘플 프로젝트를 빌드합니다.

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Azure Developer CLI

다음 단계에서 샘플을 로컬로 준비합니다. 이 단계에서는 AZD를 사용하여 Azure Developer CLI 템플릿에서 이벤트 기반 애플리케이션을 초기화합니다.

1. 터미널을 열고 비어 있는 새 폴더를 만든 다음, 터미널로 이동합니다.

2. 다음 명령을 사용하여 프로젝트를 초기화합니다.

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • 새 환경 이름 입력: 모든 Azure 리소스를 보관하기 위해 만든 리소스 그룹에 대한 접미사로 사용되는 환경 이름을 제공합니다. 이 이름은 Azure 구독 내에서 고유해야 합니다.

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

3. 클라우드 환경 준비

이 샘플을 실행하는 데 필요한 기본 리소스는 Azure Spring Apps 인스턴스, Azure Key Vault 인스턴스, Azure Service Bus 인스턴스입니다. 다음 단계에서 이러한 리소스를 만듭니다.

Azure Portal

이 섹션에서는 Azure에 배포 단추를 사용하여 Azure Portal에서 배포 환경을 시작합니다. 이 환경에서는 ARM 템플릿을 사용하여 Azure 리소스를 만듭니다.

3.1. Azure Portal에 로그인

Azure Portal로 이동하고 자격 증명을 입력하여 포털에 로그인합니다. 기본 보기는 서비스 대시보드입니다.

3.2. Azure 리소스 만들기

다음 단계를 따라 앱에 사용하는 모든 Azure 리소스를 만듭니다.

1. 다음 Azure에 배포 단추를 선택하여 Azure Portal에서 배포 환경을 시작합니다.

   

2. 기본 사항 탭에서 양식을 작성합니다. 양식을 작성하기 위한 지침으로 다음 표를 사용합니다.

   설정	제안 값	설명
   구독	구독 이름입니다.	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   지역	사용자에게 가장 가까운 지역입니다.	지역은 리소스 그룹을 만드는 데 사용됩니다.

3. 검토 및 만들기를 선택하여 선택 사항을 검토합니다. 그런 다음 만들기를 선택하여 앱을 Azure Spring Apps에 배포합니다.

4. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스의 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다. 리소스로 이동을 선택하여 서비스의 개요 페이지를 엽니다.

   

Azure Portal + Maven 플러그 인

3.1. Azure Portal에 로그인

웹 브라우저를 열고 Azure Portal로 이동합니다. 자격 증명을 입력하여 포털에 로그인합니다. 기본 보기는 서비스 대시보드입니다.

3.2. Service Bus 인스턴스 만들기

다음 단계를 따라 Service Bus 인스턴스를 만듭니다.

1. Azure Portal의 모서리에서 리소스 만들기를 선택합니다.

2. 서비스 및 마켓플레이스 검색 검색 상자에서 Service Bus를 검색합니다.

3. Service Bus 섹션에서 만들기를 선택합니다.

4. 기본 사항 탭에서 양식을 작성합니다. 양식을 작성하기 위한 지침으로 다음 표를 사용합니다.

   설정	제안 값	설명
   구독	구독 이름입니다.	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   네임스페이스 이름	my-srvbus	Service Bus 서비스를 식별하는 고유한 이름입니다.
   위치	사용자에게 가장 가까운 위치입니다.	사용자에게 가장 가까운 위치입니다.
   호스팅 옵션 및 계획	기본	요금제에 따라 인스턴스와 관련된 리소스 및 비용이 결정됩니다.

5. 검토 및 만들기를 선택하여 만들기 매개 변수를 검토합니다. 그런 다음, 만들기를 선택하여 Service Bus 인스턴스 만들기를 완료합니다.

6. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스의 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다. 리소스로 이동을 선택하여 서비스의 개요 페이지를 엽니다.

   

7. 리소스로 이동을 선택하여 Service Bus 네임스페이스 페이지로 이동합니다.

8. 탐색 메뉴에서 공유 액세스 정책을 선택한 다음, RootManageSharedAccessKey를 선택합니다.

9. SAS 정책: RootManageSharedAccessKey 페이지에서 Spring 앱 연결을 설정하는 데 사용되는 기본 연결 문자열 값을 복사하고 저장합니다.

10. 탐색 메뉴에서 큐를 선택한 다음, 큐를 선택합니다.

11. 큐 만들기 페이지에서 이름을 소문자로 입력한 다음, 만들기를 선택합니다.

12. 이름을 대문자로 입력한 다음, 이전 단계를 반복하여 다른 큐를 만듭니다.

3.3. Azure Spring Apps 인스턴스 만들기

다음 단계를 따라 Azure Spring Apps 인스턴스를 만듭니다.

1. Azure Portal의 모서리에서 리소스 만들기를 선택합니다.

2. 컴퓨팅>Azure Spring Apps를 선택합니다.

3. 다음 정보로 기본 사항 양식을 입력합니다.

   다음 표를 참조하여 양식을 작성합니다. 권장되는 플랜은 표준입니다.

   설정	제안 값	설명
   구독	구독 이름	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   이름	myasa	Azure Spring Apps 서비스를 식별하는 고유한 이름입니다. 이름은 4-32자 사이여야 하며, 소문자, 숫자 및 하이픈(-) 문자만 포함할 수 있습니다. 서비스 이름의 첫 글자는 문자여야 하며 마지막 문자는 문자 또는 숫자여야 합니다.
   계획	Standard	플랜에 따라 인스턴스와 관련된 리소스 및 비용이 결정됩니다.
   지역	사용자와 가장 가까운 지역	사용자에게 가장 가까운 위치입니다.
   영역 중복	선택 취소	Azure 가용성 영역에서 Azure Spring Apps 서비스를 만들지 여부는 현재 일부 지역에서만 지원될 수 있습니다.

4. 검토 및 만들기를 선택하여 선택 사항을 검토합니다. 만들기를 선택하여 Azure Spring Apps 인스턴스를 프로비전합니다.

5. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스에 대한 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다. 리소스로 이동 옵션을 선택하면 서비스의 개요 페이지가 열립니다.

   

3.4 Service Bus 인스턴스에 앱 인스턴스 연결

1. Azure Portal에서 Azure Spring Apps 인스턴스로 이동합니다.

2. 탐색 메뉴에서 앱을 선택한 다음, 앱 만들기를 선택합니다.

3. 앱 만들기 페이지에서 앱이름에 simple-event-driven-app을 입력하고 런타임 플랫폼용 Java 17을 선택합니다.

   

4. 앱을 만든 후 이전 단계에서 만든 앱 이름을 선택합니다.

5. 구성 페이지에서 환경 변수 탭을 선택하고 키에 SERVICE_BUS_CONNECTION_STRING을 입력한 다음, 값에 Service Bus 연결 문자열을 붙여넣고 저장을 선택합니다.

   

Azure Developer CLI

1. 다음 명령을 사용하여 OAuth2로 Azure에 로그인합니다. 이미 로그인한 경우 이 단계를 무시하세요.

   azd auth login
   

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   Logged in to Azure.
   

2. 다음 명령을 사용하여 표준 플랜으로 템플릿을 설정합니다.

   azd env set PLAN standard
   

3. 다음 명령을 사용하여 배포 가능한 애플리케이션 복사본을 패키지하고 템플릿 인프라를 Azure에 프로비전한 다음, 애플리케이션 코드를 새롭게 프로비전된 해당 리소스에 배포합니다.

   azd provision
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • 사용할 Azure 구독 선택: 화살표를 사용하여 이동하고 필터링할 대상을 입력한 다음, Enter 키를 누릅니다.
   • 사용할 Azure 위치 선택: 화살표를 사용하여 이동하고 필터링할 대상을 입력한 다음, Enter 키를 누릅니다.

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   참고 항목

   이 명령을 완료하는 데 다소 시간이 걸릴 수 있습니다. Azure 리소스를 프로비전하면 진행률 표시기가 표시됩니다.

4. Azure Spring Apps에 앱 배포

Azure Portal

이전 섹션에서 Azure에 배포 단추를 누르면 애플리케이션 배포가 포함된 Azure Portal 환경이 시작되므로 다른 작업은 필요하지 않습니다.

Azure Portal + Maven 플러그 인

다음 단계를 따라 Azure Spring Apps용 Maven 플러그 인을 사용하여 배포합니다.

1. 전체 디렉터리로 이동한 후 다음 명령을 실행하여 Azure Spring Apps에서 앱을 구성합니다.

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • OAuth2 로그인: OAuth2 프로토콜에 따라 Azure에 대한 로그인 권한을 부여해야 합니다.
   • 구독 선택: 만든 Azure Spring Apps 인스턴스의 구독 목록 번호를 선택합니다. 기본값은 목록의 첫 번째 구독입니다. 기본 번호를 사용하는 경우 바로 Enter 키를 누릅니다.
   • Azure에서 기존 Azure Spring Apps 사용: 기존 Azure Spring Apps 인스턴스를 사용하려면 y 키를 누릅니다.
   • 배포할 Azure Spring Apps 선택: 만든 Azure Spring Apps 인스턴스의 목록 번호를 선택합니다. 기본 번호를 사용하는 경우 바로 Enter 키를 누릅니다.
   • Azure Spring Apps <your-instance-name>에서 기존 앱 사용: 만든 앱을 사용하려면 y를 누릅니다.
   • 위 모든 구성 저장 확인: y 키를 누릅니다. n 키를 누르면 구성이 POM 파일에 저장되지 않습니다.

2. 다음 명령을 사용하여 앱을 배포합니다.

   ./mvnw azure-spring-apps:deploy
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • OAuth2 로그인: OAuth2 프로토콜에 따라 Azure에 대한 로그인 권한을 부여해야 합니다.

   명령이 실행되면 다음 로그 메시지에서 배포가 성공했음을 확인할 수 있습니다.

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Azure Developer CLI

다음 단계를 따라 AZD를 사용하여 앱을 패키지하고 웹 애플리케이션에 필요한 Azure 리소스를 프로비전한 다음, Azure Spring Apps에 배포합니다.

1. 다음 명령을 사용하여 배포 가능한 애플리케이션 복사본을 패키지합니다.

   azd package
   

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. 다음 명령을 사용하여 애플리케이션 코드를 새롭게 프로비전된 해당 리소스에 배포합니다.

   azd deploy
   

   콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - No endpoints were found
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

참고 항목

azd up을 사용하여 이전의 3가지 명령인 azd provision(Azure 리소스 프로비전), azd package(배포 가능한 애플리케이션 복사본 패키지), azd deploy(애플리케이션 코드 배포)를 결합할 수도 있습니다. 자세한 내용은 Azure-Samples/ASA-Samples-Event-Driven-Application을 참조하세요.

2. Spring 프로젝트 준비

Azure Portal

다음 섹션의 Azure에 배포 단추를 누르면 GitHub의 ASA-Samples-Web-Application 릴리스 페이지에서 JAR 패키지를 다운로드하는 Azure Portal 환경이 시작됩니다. 로컬 준비 단계는 필요하지 않습니다.

Azure Portal + Maven 플러그 인

다음 단계를 따라 샘플을 로컬로 준비합니다.

1. 샘플 프로젝트는 GitHub에서 준비되었습니다. 다음 명령을 사용하여 샘플 프로젝트를 복제합니다.

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. 다음 명령을 사용하여 샘플 프로젝트를 빌드합니다.

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Azure CLI

다음 단계를 따라 샘플을 로컬로 준비합니다.

1. 샘플 프로젝트는 GitHub에서 준비되었습니다. 다음 명령을 사용하여 샘플 프로젝트를 복제합니다.

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. 다음 명령을 사용하여 샘플 프로젝트를 빌드합니다.

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

3. 클라우드 환경 준비

이 샘플을 실행하는 데 필요한 기본 리소스는 Azure Spring Apps 인스턴스와 Azure Service Bus 인스턴스입니다. 다음 섹션에서는 이러한 리소스를 만드는 방법을 설명합니다.

Azure Portal

이 섹션에서는 Azure에 배포 단추를 사용하여 Azure Portal에서 배포 환경을 시작합니다. 이 환경에서는 ARM 템플릿을 사용하여 Azure 리소스를 만듭니다.

3.1. Azure Portal에 로그인

Azure Portal로 이동하고 자격 증명을 입력하여 포털에 로그인합니다. 기본 보기는 서비스 대시보드입니다.

3.2. Azure 리소스 만들기

다음 단계를 따라 앱에 사용하는 모든 Azure 리소스를 만듭니다.

1. 다음 Azure에 배포 단추를 선택하여 Azure Portal에서 배포 환경을 시작합니다.

   

2. 기본 사항 탭에서 양식을 작성합니다. 양식을 작성하기 위한 지침으로 다음 표를 사용합니다.

   설정	제안 값	설명
   구독	구독 이름입니다.	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   지역	사용자에게 가장 가까운 지역입니다.	지역은 리소스 그룹을 만드는 데 사용됩니다.

3. 검토 및 만들기를 선택하여 선택 사항을 검토합니다. 그런 다음 만들기를 선택하여 앱을 Azure Spring Apps에 배포합니다.

4. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스의 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다. 리소스로 이동을 선택하여 서비스의 개요 페이지를 엽니다.

   

Azure Portal + Maven 플러그 인

3.1. Azure Portal에 로그인

Azure Portal로 이동하고 자격 증명을 입력하여 포털에 로그인합니다. 기본 보기는 서비스 대시보드입니다.

3.2. Service Bus 인스턴스 만들기

다음 단계를 따라 Service Bus 인스턴스를 만듭니다.

1. Azure Portal의 모서리에서 리소스 만들기를 선택합니다.

2. 서비스 및 마켓플레이스 검색 검색 상자에서 Service Bus를 검색합니다.

3. Service Bus 섹션에서 만들기를 선택합니다.

4. 기본 사항 탭에서 양식을 작성합니다. 양식을 작성하기 위한 지침으로 다음 표를 사용합니다.

   설정	제안 값	설명
   구독	구독 이름입니다.	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   네임스페이스 이름	my-srvbus	Service Bus 서비스를 식별하는 고유한 이름입니다.
   위치	사용자에게 가장 가까운 위치입니다.	사용자에게 가장 가까운 위치입니다.
   호스팅 옵션 및 계획	기본	요금제에 따라 인스턴스와 관련된 리소스 및 비용이 결정됩니다.

5. 검토 및 만들기를 선택하여 만들기 매개 변수를 검토합니다. 그런 다음, 만들기를 선택하여 Service Bus 인스턴스 만들기를 완료합니다.

6. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스의 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다. 리소스로 이동을 선택하여 서비스의 개요 페이지를 엽니다.

   

7. 리소스로 이동을 선택하여 Service Bus 네임스페이스 페이지로 이동합니다.

8. 탐색 메뉴에서 큐를 선택한 다음, 큐를 선택합니다.

9. 큐 만들기 페이지에서 이름을 소문자로 입력한 다음, 만들기를 선택합니다.

10. 이름을 대문자로 입력한 다음, 이전 단계를 반복하여 다른 큐를 만듭니다.

3.3. Azure Spring Apps 인스턴스 만들기

다음 단계를 따라 서비스 인스턴스를 만듭니다.

1. Azure Portal의 모서리에서 리소스 만들기를 선택합니다.

2. 컴퓨팅>Azure Spring Apps를 선택합니다.

3. 다음 정보로 기본 사항 양식을 입력합니다.

   설정	제안 값	설명
   구독	구독 이름입니다.	서버에 사용할 Azure 구독입니다. 구독이 여러 개인 경우 해당 리소스에 대해 요금이 청구되는 구독을 선택합니다.
   리소스 그룹	myresourcegroup	새 리소스 그룹 이름 또는 구독의 기존 이름입니다.
   이름	myasa	Azure Spring Apps 서비스를 식별하는 고유한 이름입니다. 이름은 4-32자 사이여야 하며, 소문자, 숫자 및 하이픈(-) 문자만 포함할 수 있습니다. 서비스 이름의 첫 글자는 문자여야 하며 마지막 문자는 문자 또는 숫자여야 합니다.
   지역	사용자에게 가장 가까운 지역입니다.	사용자에게 가장 가까운 위치입니다.
   호스팅 옵션 및 계획	엔터프라이즈	요금제에 따라 인스턴스와 관련된 리소스 및 비용이 결정됩니다.
   영역 중복	선택 취소	Azure 가용성 영역에 Azure Spring Apps 서비스를 만드는 옵션입니다. 이 기능은 현재 모든 지역에서 지원되지 않습니다.
   소프트웨어 IP 플랜	종량제	Azure Spring Apps를 통해 사용한 만큼 지불할 수 있는 요금제입니다.
   샘플 프로젝트 배포	선택 취소	기본 제공 애플리케이션 예제를 사용하는 옵션입니다.

4. 검토 및 만들기를 선택하여 선택 사항을 검토합니다. 그런 다음, 만들기를 선택하여 Azure Spring Apps 인스턴스를 프로비전합니다.

5. 배포 프로세스를 모니터링하려면 도구 모음에서 알림 아이콘(벨)을 선택합니다. 배포가 완료된 후 대시보드에 고정을 선택하면 Azure Portal 대시보드에서 이 서비스의 타일을 서비스 개요 페이지에 대한 바로 가기로 만들 수 있습니다.

   

6. 리소스로 이동을 선택하여 Azure Spring Apps 개요 페이지로 이동합니다.

3.4 Service Bus 인스턴스에 앱 인스턴스 연결

다음 단계를 따라 서비스 인스턴스를 연결합니다.

1. Azure Portal에서 Azure Spring Apps 인스턴스로 이동합니다.

2. 탐색 창에서 앱 창을 연 다음, 앱 만들기를 선택합니다.

3. 앱 만들기 페이지에서 앱 이름에 simple-event-driven-app을 사용하고 나머지 필드는 기본값으로 둡니다.

4. 만들기를 선택하여 앱 만들기를 완료한 다음, 만든 앱을 선택하여 세부 정보를 확인합니다.

5. 탐색 창에서 서비스 커넥터를 선택한 다음, 만들기를 선택하여 새 서비스 연결을 만듭니다.

6. 기본 탭에 다음 정보를 입력합니다.

   • 서비스 유형: Service Bus를 선택합니다.
   • 연결 이름: 자동 생성된 이름으로 채워지며, 사용자가 수정할 수 있습니다.
   • 구독: 구독을 선택합니다.
   • 네임스페이스: 앞에서 만든 네임스페이스를 선택합니다.
   • 클라이언트 유형: SpringBoot를 선택합니다.

7. 다음 정보를 사용하여 다음: 인증 탭을 구성합니다.

   참고 항목

   사용 가능한 가장 안전한 인증 흐름을 사용하는 것이 권장됩니다. 데이터베이스, 캐시, 메시징 또는 AI 서비스와 같이 이 절차에서 설명하는 인증 흐름은 애플리케이션에 대한 신뢰 수준이 매우 높고 다른 흐름에 존재하지 않는 위험을 수반합니다. 암호 없는 연결 또는 키 없는 연결에 대한 관리 ID와 같은 더 안전한 옵션이 실행 가능하지 않은 경우에만 이 흐름을 사용합니다. 로컬 컴퓨터 작업의 경우 암호 없는 연결이나 키 없는 연결에 사용자 ID를 사용하는 것이 좋습니다.

   • 컴퓨팅 서비스와 대상 서비스 간에 사용할 인증 유형 선택: 연결 문자열을 선택합니다.

8. 다음: 네트워킹을 선택합니다. 기본 옵션인 대상 서비스에 대한 액세스를 사용하도록 방화벽 규칙 구성을 사용합니다.

9. 다음: 검토 및 만들기를 선택하여 선택 사항을 검토한 다음, 만들기를 선택하여 연결을 만듭니다.

Azure CLI

3.1. 각 리소스에 대한 이름 제공

다음 명령을 사용하여 리소스 이름을 저장할 변수를 만듭니다. 자리 표시자를 사용자의 값으로 바꿔야 합니다.

export RESOURCE_GROUP=<event-driven-app-resource-group-name>
export LOCATION=<desired-region>
export SERVICE_BUS_NAME_SPACE=<event-driven-app-service-bus-namespace>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>
export APP_NAME=<event-driven-app-name>

3.2. 새 리소스 그룹 만들기

다음 단계를 따라 새 리소스 그룹을 만듭니다.

1. 다음 명령을 실행하여 Azure CLI에 로그인합니다.

   az login
   

2. 다음 명령을 실행하여 기본 위치를 설정합니다.

   az configure --defaults location=${LOCATION}
   

3. 다음 명령을 사용하여 사용할 구독 ID를 결정하는 데 사용할 수 있는 모든 구독을 나열합니다.

   az account list --output table
   

4. 다음 명령을 사용하여 기본 구독을 설정합니다.

   az account set --subscription <subscription-ID>
   

5. 다음 명령을 사용하여 리소스 그룹을 만듭니다.

   az group create --resource-group ${RESOURCE_GROUP}
   

6. 다음 명령을 사용하여 새로 만든 리소스 그룹을 기본 리소스 그룹으로 설정합니다.

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. 확장 설치 및 네임스페이스 등록

다음 명령을 사용하여 Azure CLI용 Azure Spring Apps 확장을 설치하고 Microsoft.SaaS 네임스페이스를 등록합니다.

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4 Azure Spring Apps 인스턴스 만들기

다음 명령을 사용하여 Azure Spring Apps 인스턴스를 만듭니다.

az spring create \
    --name ${AZURE_SPRING_APPS_INSTANCE} \
    --sku Enterprise

다음 명령을 사용하여 Azure Spring Apps 인스턴스에서 앱을 만듭니다.

az spring app create \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME}

3.5. Service Bus 인스턴스 만들기

다음 단계를 따라 Service Bus 인스턴스를 만듭니다.

1. 다음 명령을 사용하여 Service Bus 네임스페이스를 만듭니다.

   az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
   

2. 다음 명령을 사용하여 lower-case 및 upper-case라는 2개의 큐를 만듭니다.

   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name lower-case
   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name upper-case
   

3.6. Service Bus 인스턴스에 앱 인스턴스 연결

Azure Spring Apps에서 Service Bus와 앱을 모두 만들었지만 앱을 Service Bus에 연결할 수는 없습니다. 다음 단계를 따라 앱을 Service Bus에 연결하도록 설정한 다음, 앱을 배포합니다.

1. 다음 명령을 사용하여 Service Bus의 연결 문자열을 가져옵니다.

   참고 항목

   사용 가능한 가장 안전한 인증 흐름을 사용하는 것이 권장됩니다. 데이터베이스, 캐시, 메시징 또는 AI 서비스와 같이 이 절차에서 설명하는 인증 흐름은 애플리케이션에 대한 신뢰 수준이 매우 높고 다른 흐름에 존재하지 않는 위험을 수반합니다. 암호 없는 연결 또는 키 없는 연결에 대한 관리 ID와 같은 더 안전한 옵션이 실행 가능하지 않은 경우에만 이 흐름을 사용합니다. 로컬 컴퓨터 작업의 경우 암호 없는 연결이나 키 없는 연결에 사용자 ID를 사용하는 것이 좋습니다.

   export SERVICE_BUS_CONNECTION_STRING=$( \
       az servicebus namespace authorization-rule keys list \
           --namespace-name ${SERVICE_BUS_NAME_SPACE} \
           --name RootManageSharedAccessKey \
           --query primaryConnectionString \
           --output tsv)
   

2. 다음 명령을 사용하여 환경 변수를 통해 앱에 연결 문자열을 제공합니다.

   az spring app update \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME} \
       --env SPRING_CLOUD_AZURE_SERVICEBUS_CONNECTIONSTRING=${SERVICE_BUS_CONNECTION_STRING} \
             SPRING_CLOUD_AZURE_KEYVAULT_SECRET_PROPERTYSOURCEENABLED=false
   

4. Azure Spring Apps에 앱 배포

Azure Portal

이전 섹션에서 Azure에 배포 단추를 누르면 애플리케이션 배포가 포함된 Azure Portal 환경이 시작되므로 다른 작업은 필요하지 않습니다.

Azure Portal + Maven 플러그 인

다음 단계를 따라 Azure Spring Apps용 Maven 플러그 인을 사용하여 배포합니다.

1. 전체 디렉터리로 이동한 후 다음 명령을 실행하여 Azure Spring Apps에서 앱을 구성합니다.

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • OAuth2 로그인: OAuth2 프로토콜에 따라 Azure에 대한 로그인 권한을 부여해야 합니다.
   • 구독 선택: 만든 Azure Spring Apps 인스턴스의 구독 목록 번호를 선택합니다. 기본값은 목록의 첫 번째 구독입니다. 기본 번호를 사용하는 경우 바로 Enter 키를 누릅니다.
   • Azure에서 기존 Azure Spring Apps 사용: 기존 Azure Spring Apps 인스턴스를 사용하려면 y 키를 누릅니다.
   • 배포할 Azure Spring Apps 선택: 만든 Azure Spring Apps 인스턴스의 목록 번호를 선택합니다. 기본 번호를 사용하는 경우 바로 Enter 키를 누릅니다.
   • Azure Spring Apps <your-instance-name>에서 기존 앱 사용: 만든 앱을 사용하려면 y를 누릅니다.
   • 위 모든 구성 저장 확인: y 키를 누릅니다. n 키를 누르면 구성이 POM 파일에 저장되지 않습니다.

2. 다음 명령을 사용하여 앱을 배포합니다.

   ./mvnw azure-spring-apps:deploy
   

   다음 목록에서는 명령 상호 작용을 설명합니다.

   • OAuth2 로그인: OAuth2 프로토콜에 따라 Azure에 대한 로그인 권한을 부여해야 합니다.

   명령이 실행되면 다음 로그 메시지에서 배포가 성공했음을 확인할 수 있습니다.

   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Azure CLI

이제 클라우드 환경이 준비되었습니다. 다음 명령을 사용하여 앱을 배포합니다.

az spring app deploy \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME} \
    --artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar

5. 앱 유효성 검사

다음 단계에서 이벤트 기반 앱이 올바르게 작동하는지 확인합니다. lower-case 큐에 메시지를 보낸 다음, upper-case 큐에 메시지가 있는지 확인하여 앱의 유효성을 검사할 수 있습니다.

1. Service Bus Explorer를 사용하여 lower-case 큐에 메시지를 보냅니다. 자세한 내용은 Service Bus Explorer를 사용하여 Service Bus에서 데이터 작업 실행의 큐 또는 항목에 메시지 보내기 섹션을 참조하세요.

2. upper-case 큐로 전송된 새 메시지가 있는지 확인합니다. 자세한 내용은 Service Bus Explorer를 사용하여 Service Bus에서 데이터 작업 실행의 메시지 보기 섹션을 참조하세요.

3. Azure Spring Apps 인스턴스 개요 페이지로 이동한 다음, 로그를 선택하여 앱의 로그를 확인합니다.

   

Azure Portal

1. Service Bus Explorer를 사용하여 lower-case 큐에 메시지를 보냅니다. 자세한 내용은 Service Bus Explorer를 사용하여 Service Bus에서 데이터 작업 실행의 큐 또는 항목에 메시지 보내기 섹션을 참조하세요.

2. upper-case 큐로 전송된 새 메시지가 있는지 확인합니다. 자세한 내용은 Service Bus Explorer를 사용하여 Service Bus에서 데이터 작업 실행의 메시지 보기 섹션을 참조하세요.

3. Azure Spring Apps 인스턴스 개요 페이지로 이동한 다음, 로그를 선택하여 앱의 로그를 확인합니다.

   

4. 배포 문제를 조사하는 데 유용한 각 리소스 배포의 세부 정보를 확인합니다.

Azure Portal + Maven 플러그 인

1. Service Bus Explorer를 사용하여 lower-case 큐에 메시지를 보냅니다. 자세한 내용은 Service Bus Explorer를 사용하여 Service Bus에서 데이터 작업 실행의 큐 또는 항목에 메시지 보내기 섹션을 참조하세요.

2. upper-case 큐로 전송된 새 메시지가 있는지 확인합니다. 자세한 내용은 Service Bus Explorer를 사용하여 Service Bus에서 데이터 작업 실행의 메시지 보기 섹션을 참조하세요.

3. Azure Spring Apps 인스턴스 개요 페이지로 이동한 다음, 로그를 선택하여 앱의 로그를 확인합니다.

   

4. 배포 문제를 조사하는 데 유용한 각 리소스 배포의 세부 정보를 확인합니다.

Azure CLI

1. Service Bus Explorer를 사용하여 lower-case 큐에 메시지를 보냅니다. 자세한 내용은 Service Bus Explorer를 사용하여 Service Bus에서 데이터 작업 실행의 큐 또는 항목에 메시지 보내기 섹션을 참조하세요.

2. upper-case 큐로 전송된 새 메시지가 있는지 확인합니다. 자세한 내용은 Service Bus Explorer를 사용하여 Service Bus에서 데이터 작업 실행의 메시지 보기 섹션을 참조하세요.

3. Azure Spring Apps 인스턴스 개요 페이지로 이동한 다음, 로그를 선택하여 앱의 로그를 확인합니다.

   

4. 다음 명령을 사용하여 앱의 로그를 확인하여 배포 문제를 조사합니다.

   az spring app logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME}
   

6. 리소스 정리

이 문서에서 만든 리소스가 더 이상 필요하지 않으면 삭제해야 합니다. 리소스 그룹의 모든 리소스를 포함하고 있는 Azure 리소스 그룹을 삭제할 수 있습니다.

Azure Portal

다음 단계를 따라 새로 만든 서비스를 포함한 전체 리소스 그룹을 삭제합니다.

1. Azure Portal에서 리소스 그룹을 찾습니다. 탐색 메뉴에서 리소스 그룹을 선택한 다음, 리소스 그룹의 이름을 선택합니다.

2. 리소스 그룹 페이지에서 삭제를 선택합니다. 텍스트 상자에 리소스 그룹 이름을 입력하여 삭제를 확인한 다음, 삭제를 선택합니다.

Azure Portal + Maven 플러그 인

다음 단계를 따라 새로 만든 서비스를 포함한 전체 리소스 그룹을 삭제합니다.

1. Azure Portal에서 리소스 그룹을 찾습니다. 탐색 메뉴에서 리소스 그룹을 선택한 다음, 리소스 그룹의 이름을 선택합니다.

2. 리소스 그룹 페이지에서 삭제를 선택합니다. 텍스트 상자에 리소스 그룹 이름을 입력하여 삭제를 확인한 다음, 삭제를 선택합니다.

Azure CLI

다음 명령을 사용하여 새로 만든 서비스를 포함한 전체 리소스 그룹을 삭제합니다.

az group delete --name ${RESOURCE_GROUP}

Azure Portal

다음 단계를 따라 새로 만든 서비스를 포함한 전체 리소스 그룹을 삭제합니다.

1. Azure Portal에서 리소스 그룹을 찾습니다. 탐색 메뉴에서 리소스 그룹을 선택한 다음, 리소스 그룹의 이름을 선택합니다.

2. 리소스 그룹 페이지에서 삭제를 선택합니다. 텍스트 상자에 리소스 그룹 이름을 입력하여 삭제를 확인한 다음, 삭제를 선택합니다.

Azure Portal + Maven 플러그 인

다음 단계를 따라 새로 만든 서비스를 포함한 전체 리소스 그룹을 삭제합니다.

1. Azure Portal에서 리소스 그룹을 찾습니다. 탐색 메뉴에서 리소스 그룹을 선택한 다음, 리소스 그룹의 이름을 선택합니다.

2. 리소스 그룹 페이지에서 삭제를 선택합니다. 텍스트 상자에 리소스 그룹 이름을 입력하여 삭제를 확인한 다음, 삭제를 선택합니다.

Azure Developer CLI

다음 명령을 사용하여 이 샘플 애플리케이션에 사용되는 모든 Azure 리소스를 삭제합니다.

azd down

다음 목록에서는 명령 상호 작용을 설명합니다.

• 삭제할 총 리소스 수: <your-resources-total>, 계속하시겠습니까?: y 키를 누릅니다.
• 대신 이름을 다시 사용할 수 있도록 해당 리소스를 영구적으로 삭제하시겠습니까?: y 키를 누릅니다. Key Vault를 다시 사용하려면 n을 누릅니다.

콘솔에 다음 예제와 비슷한 메시지가 표시됩니다.

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

7. 다음 단계

Azure Spring Apps의 구조적 애플리케이션 로그

Azure Spring Apps에 기존 사용자 지정 도메인 매핑

GitHub Actions에서 Azure Spring Apps CI/CD 설정

Azure Spring Apps에 대한 애플리케이션 배포 자동화

Azure Spring Apps에서 애플리케이션에 관리 ID 사용

Azure CLI를 사용하여 Azure Spring Apps에서 서비스 연결 만들기

마이크로 서비스 앱 실행(Pet Clinic)

Fitness Store 샘플 앱 소개

자세한 내용은 다음 문서를 참조하세요.

• Azure Spring 앱 샘플.
• Azure의 Spring
• Spring Cloud Azure