빠른 시작: Azure Spring Apps에 첫 번째 Spring Batch 애플리케이션 배포

참고 항목

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

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

이 빠른 시작에서는 Spring Batch 임시 애플리케이션을 Azure Spring Apps에 배포하는 방법을 보여줍니다. 샘플 프로젝트는 Spring Batch 샘플 축구 작업에서 파생됩니다. 통계 로드 작업입니다. 원래 샘플에서 단위 테스트는 작업을 트리거합니다. 조정된 샘플에서 FootballJobApplication의 main 메서드가 작업을 시작합니다.

이 문서는 기본/표준 ✅ 엔터프라이즈에 ❎ 적용됩니다.

다음 다이어그램에서는 시스템의 아키텍처를 보여줍니다.

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

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

1. 사전 요구 사항

Azure Portal

• Azure 구독 구독이 없는 경우 시작하기 전에 체험 계정을 만드세요.
• Git
• 대상 구독에서 Azure Spring Apps 엔터프라이즈 플랜 인스턴스를 처음 배포하는 경우 Azure Marketplace의 엔터프라이즈 플랜의 요구 사항 섹션을 참조하세요.

Azure CLI

• Azure 구독 구독이 없는 경우 시작하기 전에 체험 계정을 만드세요.
• Git
• Java Development Kit (JDK), 버전 17.
• Azure CLI: 버전 2.55.0 이상. 다음 명령을 사용하여 Azure Spring Apps 확장을 설치합니다. az extension add --name spring.
• 대상 구독에서 Azure Spring Apps Enterprise 플랜 인스턴스를 처음 배포하는 경우 Azure Marketplace의 Enterprise 플랜의 요구 사항 섹션을 참조하세요.

2. Spring 프로젝트 준비

다음 명령을 사용하여 GitHub에서 샘플 프로젝트를 복제합니다.

git clone https://github.com/Azure-Samples/azure-spring-apps-samples.git

3. 클라우드 환경 준비

이 샘플을 실행하는 데 필요한 주요 리소스는 Azure Spring Apps 인스턴스입니다. 이 섹션에서는 이 리소스를 만드는 단계를 제공합니다.

Azure Portal

3.1. Azure Portal에 로그인

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

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

다음 단계를 수행하여 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를 사용하여 사용한 만큼 지불할 수 있는 요금제입니다.
   Terms	선택한 상태	Marketplace 제품과 관련된 계약 확인란입니다. 이 확인란을 선택해야 합니다.
   샘플 프로젝트 배포	선택 취소	기본 제공 애플리케이션 예제를 사용하는 옵션입니다.

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

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

   

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

3.3. 서비스 레지스트리 사용

만든 Azure Spring Apps 인스턴스로 이동하여 탐색 창에서 관리 구성 요소를 확장한 다음, 서비스 레지스트리를 선택합니다. 그런 다음 개요 페이지에서 관리를 선택하여 관리 페이지를 열고, 서비스 레지스트리 사용을 선택한 다음, 적용을 선택합니다.

3.4 로그 분석 작업 영역을 설정합니다.

로그의 데이터 쿼리에 대한 내용은 빠른 시작: Log Analytics 작업 영역 설정을 참조하세요.

Azure CLI

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

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

export LOCATION=<location>
export RESOURCE_GROUP=<resource-group-name>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-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 Spring Apps 인스턴스 만들기

Azure Spring Apps는 Spring 웹앱을 호스트하는 데 사용됩니다. 다음 단계를 사용하여 Azure Spring Apps 인스턴스 및 그 안에 애플리케이션을 만듭니다.

1. 다음 명령을 사용하여 Azure Spring Apps 서비스 인스턴스를 만들고 서비스 레지스트리를 사용하도록 설정합니다.

   az spring create \
       --name ${AZURE_SPRING_APPS_INSTANCE} \
       --sku enterprise \
       --enable-sr
   

2. 다음 명령을 사용하여 Azure Spring Apps Enterprise 계획 서비스 인스턴스가 성공적으로 생성되었는지 확인합니다.

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Azure Spring Apps에 축구 광고판 앱 배포

Azure Portal

다음 단계를 사용하여 앱을 배포합니다.

1. 만든 Azure Spring Apps 인스턴스로 이동하여 탐색 창에서 설정을 확장한 다음, 앱을 선택합니다.

2. 앱 창에서 앱 만들기를 선택하여 앱 만들기 페이지를 엽니다.

3. 앱 이름을 축구 광고판으로 설정하고 바인딩 열에서 서비스 레지스트리를 선택한 다음, 만들기를 선택합니다.

   

4. 앱을 만든 후 앱 배포를 선택하고 앱을 배포하기 위한 Azure CLI 명령을 복사합니다. 그런 다음 Bash 창을 열고 명령줄에 명령을 붙여넣고 아티팩트 경로를 시스템에 맞는 올바른 값으로 바꿉니다. 그런 다음, 명령을 실행합니다. 빌드 및 배포가 성공할 때까지 몇 분 정도 기다립니다. 명령 및 출력은 다음 예제와 유사해야 합니다.

   $ az spring app deploy -s job-demo -g job-demo -n football-billboard --artifact-path target/spring-batch-football-billboard-0.0.1-SNAPSHOT.jar
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football-billboard'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

5. 배포 후 앱 창으로 돌아가서 football-billboard 앱을 선택합니다. 그런 다음, 개요 페이지로 이동하여 엔드포인트 할당을 선택하여 앱에 대한 퍼블릭 엔드포인트를 노출합니다.

Azure CLI

다음 단계를 사용하여 앱을 배포합니다.

1. 다음 명령을 사용하여 리포지토리의 루트 폴더에서 샘플 프로젝트 폴더로 이동합니다.

   cd azure-spring-apps-samples/job-samples/football-billboard
   

2. 다음 명령을 사용하여 Azure Spring Apps 인스턴스에서 애플리케이션을 만들고 서비스 레지스트리를 바인딩합니다.

   az spring app create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --assign-endpoint true \
       --bind-sr
   

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

   az spring app deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

5. Azure Spring Apps에 작업 샘플 배포

이 섹션에서는 샘플을 배포하는 단계를 제공합니다.

Azure Portal

5.1. 작업 만들기 및 실행

다음 단계를 사용하여 작업을 만들고 실행합니다.

1. 작업 창으로 이동한 다음 작업 만들기를 선택합니다. 작업 이름을 football(으)로 입력합니다. 병렬 처리, 재시도 제한 및 시간 제한과 같은 작업 매개 변수를 구성합니다. 필요에 따라 환경 변수 및 비밀 환경 변수를 추가합니다. 확인 후 만들기를 선택합니다.

   

2. 작업을 만든 후 탐색 창에서 관리 구성 요소를 확장하고 서비스 레지스트리를 선택합니다. 그런 다음 작업 바인딩을 선택하고 작업 바인딩을 선택하여 축구 작업을 선택한 다음, 적용을 선택하여 바인딩합니다.

   

3. 작업을 바인딩한 후 작업 창으로 돌아가서 작업 배포를 선택한 다음, 작업을 배포하기 위한 Azure CLI 명령을 복사합니다. 그런 다음 Bash 창을 열고 명령줄에 명령을 붙여넣고 아티팩트 경로를 시스템에 맞는 올바른 값으로 바꿉니다. 그런 다음, 명령을 실행합니다. 빌드 및 배포가 성공할 때까지 몇 분 정도 기다립니다. 명령 및 출력은 다음 예제와 유사해야 합니다.

   $ az spring job deploy -s job-demo -g job-demo -n football --artifact-path target/spring-batch-football-0.0.1-SNAPSHOT-jar-with-dependencies.jar --build-env BP_JVM_VERSION=17
   This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

4. 배포 후 작업 이름을 선택하여 football 작업의 개요 페이지를 엽니다. 실행을 선택하여 작업 실행을 시작합니다. 환경 변수와 같은 다양한 매개 변수를 사용하여 작업의 각 실행을 사용자 지정하거나 실행을 선택하여 실행을 트리거할 수 있습니다. 메시지는 작업이 실행 중임을 나타냅니다.

   

Azure CLI

5.1. 작업 만들기 및 실행

다음 단계를 사용하여 작업을 만들고 실행합니다.

1. 다음 명령을 사용하여 이전에 중단한 축구 광고판 폴더에서 샘플 프로젝트 폴더로 이동합니다.

   cd ..
   cd football
   

2. 다음 명령을 사용하여 Azure Spring Apps 인스턴스에서 작업을 만들고 서비스 레지스트리를 바인딩합니다.

   az spring job create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --bind-sr
   

3. 다음 명령을 사용하여 football 샘플 프로젝트를 작업에 배포합니다. 이 명령은 Azure에서 소스 코드를 업로드 및 컴파일하고 시작할 수 있도록 준비합니다.

   az spring job deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

4. 다음 명령을 사용하여 작업을 시작하고 EXECUTION_NAME 변수를 작업 실행 이름으로 설정합니다.

   export EXECUTION_NAME=$(az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --query name \
       --output tsv)
   

6. 작업 실행 결과 및 광고판 UI 확인

이제 작업 실행에 액세스하고 결과를 확인할 수 있습니다.

Azure Portal

다음 단계를 수행하여 유효성을 검사합니다.

1. 실행 창에서 작업 실행 결과를 확인합니다. 몇 초 정도 기다렸다가 새로 고쳐 상태가 완료됨으로 바뀌는지 확인하세요. 이 값은 작업 실행이 성공적으로 완료되었음을 의미합니다.

2. 로그 보기를 선택하여 작업 실행 로그를 쿼리합니다.

   

3. 브라우저 창에서 앱의 퍼블릭 엔드포인트를 열어 광고판 UI를 확인합니다. 앱은 열어 둡니다.

   

4. football 작업의 개요 페이지로 돌아가서 실행을 선택하여 실행을 다시 트리거합니다.

5. 브라우저의 엔드포인트 페이지로 돌아가서 새로 고침을 선택하여 다음 스크린샷과 같이 UI가 변경된 것을 확인합니다.

   

Azure CLI

다음 단계를 따라 유효성을 검사합니다.

1. 다음 명령을 사용하여 작업 이름 및 실행 이름을 사용하여 실행 결과를 쿼리합니다.

   az spring job logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --execution ${EXECUTION_NAME} \
       --all-instances
   

   작업 실행을 스트리밍하는 작업 로그는 다음 예제와 유사해야 합니다.

   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - No TaskExecutor has been set, defaulting to synchronous executor.
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is {} player summary before job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] launched with the following parameters: [{}]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [playerLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [playerLoad] executed in 200ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [gameLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [gameLoad] executed in 290ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [summarizationStep]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [summarizationStep] executed in 7ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] completed with the following parameters: [{}] and the following status: [COMPLETED] in 519ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is 1 player summary after job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseFactory - Shutting down embedded database: url='jdbc:hsqldb:mem:testdb'
   ...
   

2. 다음 명령을 사용하여 football-billboard 앱의 엔드포인트를 검색합니다.

   az spring app show \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --query properties.url
   

3. 브라우저 창에서 앱의 퍼블릭 엔드포인트를 열어 광고판 UI를 확인합니다. 앱은 열어 둡니다.

   

4. 다음 명령을 사용하여 작업을 다시 시작합니다.

   az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football
   

5. 브라우저의 엔드포인트 페이지로 돌아가서 새로 고침을 선택하여 다음 스크린샷과 같이 UI가 변경된 것을 확인합니다.

   

7. 리소스 정리

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

Azure Portal

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

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

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

Azure CLI

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

az group delete --name ${RESOURCE_GROUP}

8. 다음 단계

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

• Azure Spring 앱 샘플.
• Spring 개발자용 Azure
• Spring Cloud Azure 설명서