다음을 통해 공유


빠른 시작: 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로 마이그레이션을 참조 하세요.

이 문서에서는 잘 알려진 PetClinic 샘플 앱을 사용하여 마이크로 서비스 애플리케이션을 Azure Spring Apps에 배포하는 방법을 설명합니다.

Pet Clinic 샘플은 마이크로 서비스 아키텍처 패턴을 보여줍니다. 다음 다이어그램에서는 Azure Spring Apps 엔터프라이즈 플랜의 PetClinic 애플리케이션 아키텍처를 보여줍니다.

Azure Spring Apps Enterprise 계획의 PetClinic 샘플 아키텍처를 보여 주는 다이어그램.

이 다이어그램에서 보여주는 Pet Clinic 샘플의 아키텍처 흐름과 관계는 다음과 같습니다.

  • Azure Spring Apps를 사용하여 프런트 엔드 앱과 백 엔드 앱을 관리합니다. 백 엔드 앱은 Spring Boot를 사용하여 빌드되며, 각 앱에서 HSQLDB를 영구 저장소로 사용합니다. 재정비된 프런트 엔드 앱은 독립 실행형 프런트 엔드 웹 애플리케이션으로 사용되는 Node.js가 포함된 Pet Clinic API Gateway 앱을 기반으로 하여 빌드됩니다.
  • Service Registry, Application Configuration Service, Spring Cloud Gateway, 애플리케이션 라이브 뷰를 포함하여 Azure Spring Apps에서 관리형 구성 요소를 사용합니다. Application Configuration Service는 Git 리포지토리 구성을 읽습니다.
  • Spring Cloud Gateway URL을 공개하여 요청을 백 엔드 서비스 앱으로 라우팅하고, 애플리케이션 라이브 뷰 URL을 공개하여 백 엔드 앱을 모니터링합니다.
  • Log Analytics 작업 영역을 사용하여 로그를 분석합니다.
  • Application Insights를 사용하여 성능을 모니터링합니다.

참고 항목

이 문서에서는 Azure Spring Apps에 빠르게 배포하기 위해 프로덕션 준비 상태가 아닌 메모리 내 데이터베이스를 사용하는 간소화된 PetClinic 버전을 사용합니다.

Tanzu 개발자 도구는 위험 지점인 애플리케이션 라이브 뷰에 대한 공용 액세스를 공개합니다. 프로덕션 환경에서는 이 액세스를 보호해야 합니다. 자세한 내용은 Azure Spring Apps 엔터프라이즈 플랜에서 Tanzu Dev Tools 구성Dev Tools 포털 구성 섹션을 참조하세요.

Pet Clinic 샘플은 마이크로 서비스 아키텍처 패턴을 보여줍니다. 다음 다이어그램에서는 Azure Spring Apps 표준 플랜의 PetClinic 애플리케이션 아키텍처를 보여줍니다.

Azure Spring Apps 표준 플랜의 PetClinic 샘플 아키텍처를 보여 주는 다이어그램.

이 다이어그램에서 보여주는 Pet Clinic 샘플의 아키텍처 흐름과 관계는 다음과 같습니다.

  • Azure Spring Apps를 사용하여 Spring Boot 앱을 관리합니다. 각 앱에서 HSQLDB를 영구 저장소로 사용합니다.
  • Azure Spring Apps에서 관리형 Spring Cloud Config Server 및 Eureka Service Registry 구성 요소를 사용합니다. Config Server는 Git 리포지토리 구성을 읽습니다.
  • API Gateway URL을 공개하여 서비스 앱에 대한 요청 부하를 분산하고, Admin Server URL을 공개하여 애플리케이션을 관리합니다.
  • Log Analytics 작업 영역을 사용하여 로그를 분석합니다.
  • Application Insights를 사용하여 성능을 모니터링합니다.

참고 항목

이 문서에서는 Azure Spring Apps에 빠르게 배포하기 위해 프로덕션 준비 상태가 아닌 메모리 내 데이터베이스를 사용하는 간소화된 PetClinic 버전을 사용합니다.

배포된 admin-server 앱은 위험 지점인 공용 액세스를 공개합니다. 프로덕션 환경에서는 Spring Boot Admin 애플리케이션을 보호해야 합니다.

Azure Spring Apps에 배포하기 위해 이 문서에서 제공하는 옵션은 다음과 같습니다.

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

1. 사전 요구 사항

2. Spring 프로젝트 준비

다음 단계에서 샘플을 로컬로 준비합니다.

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

    git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
    
  2. 프로젝트 루트 디렉터리로 이동한 후, 다음 명령을 사용하여 샘플 프로젝트를 로컬로 실행합니다.

    bash ./scripts/run_all_without_infra.sh
    
  3. 스크립트가 성공적으로 완료되면 브라우저에서 http://localhost:8080 주소로 이동하여 PetClinic 애플리케이션에 액세스합니다.

3. 클라우드 환경 준비

이 섹션에서는 Azure Spring Apps 서비스 인스턴스를 만들고 Azure 클라우드 환경을 준비하는 방법을 설명합니다.

3.1. Azure 포털

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

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

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

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

  2. Azure 서비스 탭에서 컴퓨팅>Azure Spring Apps를 선택합니다.

    Azure Spring 앱이 강조 표시된 리소스 만들기 페이지를 보여 주는 Azure Portal의 스크린샷.

  3. Azure Spring Apps 만들기 페이지의 기본 사항 탭에서 양식을 작성합니다.

    기본 사항 탭이 선택된 Azure Spring 앱 만들기 페이지를 보여 주는 Azure Portal의 스크린샷.

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

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

    진단 탭이 선택되고 새로 만들기 단추가 강조 표시된 Azure Spring 앱 만들기 페이지를 보여 주는 Azure Portal의 스크린샷.

  5. Azure Spring Apps 만들기 페이지의 Application Insights 탭으로 이동한 다음, 새로 만들기를 선택하여 새 Application Insights 인스턴스를 만듭니다. 새 Application Insights 리소스 만들기 페이지에서 필요에 따라 Application Insights 이름을 업데이트하고 리소스 모드작업 영역 기반을 선택한 다음, 확인을 선택하여 만들기를 확인합니다.

    새 Application Insights 만들기 리소스 창이 표시된 Azure Spring 앱 만들기 페이지를 보여 주는 Azure Portal의 스크린샷.

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

  7. 알림 아이콘(종 모양)을 선택하여 배포 프로세스를 모니터링합니다. 배포가 완료되면 대시보드에 고정을 선택하여 서비스 개요 페이지의 바로 가기를 Azure Portal 대시보드에 만들 수 있습니다.

    리소스 배포와 리소스로 이동 및 대시보드에 고정 단추가 있는 알림 창을 보여 주는 Azure Portal의 스크린샷.

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

  9. 탐색 창에서 Config Server를 선택합니다.

  10. Config Server 페이지에서 URI에 대해 https://github.com/Azure-Samples/spring-petclinic-microservices-config.git을 입력한 다음, 유효성 검사를 선택합니다.

    기본 URI와 유효성 검사 단추가 강조 표시된 Config Server 페이지를 보여 주는 Azure Portal의 스크린샷.

  11. 유효성 검사 후 적용을 선택하여 Config Server 구성을 완료합니다.

4. Azure Spring Apps에 앱 배포

이제 Azure Spring Apps에 앱을 배포할 수 있습니다.

다음 단계를 따라 Azure Spring Apps용 Maven 플러그 인을 사용하여 마이크로 서비스 애플리케이션을 배포합니다.

  1. 샘플 프로젝트 디렉터리로 이동하고 다음 명령을 사용하여 Azure Spring Apps에 대한 앱을 구성합니다.

    ./mvnw -P spring-apps com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config
    
  2. 다음 목록에서는 명령 상호 작용을 설명합니다.

    • 구성할 자식 모듈 선택([1-2,4,6] 형식과 같이 쉼표로 구분하여 번호 입력, 모두 선택하려면 ENTER 키): 모두 선택하려면 Enter 키를 누릅니다.
    • OAuth2 로그인: OAuth2 프로토콜에 따라 Azure에 대한 로그인 권한을 부여합니다.
    • 구독 선택: 만든 Azure Spring Apps 인스턴스의 구독 목록 번호를 선택합니다. 기본값은 목록의 첫 번째 구독입니다. 기본 번호를 사용하는 경우 Enter 키를 직접 누릅니다.
    • 배포할 Azure Spring Apps 선택: 만든 Azure Spring Apps 인스턴스의 목록 번호를 선택합니다. 기본 번호를 사용하는 경우 바로 Enter 키를 누릅니다.
    • 공용 액세스를 공개할 앱 선택([1-2,4,6] 형식과 같이 쉼표로 구분하여 번호 입력, 아무것도 선택하지 않으려면 ENTER 키): admin-serverapi-gateway에 대해 1,5를 입력합니다.
    • 위의 모든 구성 저장 확인(y/n): y를 누릅니다. n을 누르면 구성이 POM 파일에 저장되지 않습니다.
  3. 다음 명령을 사용하여 각 애플리케이션을 빌드하고 배포합니다.

    ./mvnw azure-spring-apps:deploy
    
  4. OAuth2 로그인 프롬프트의 경우 OAuth2 프로토콜에 따라 Azure에 로그인하는 권한을 부여합니다.

    참고 항목

    Azure Spring Apps에 배포하는 데 걸리는 시간은 최대 25분입니다.

명령이 실행되면 다음 예제와 비슷한 형식으로 모두 성공적으로 배포했음을 나타내는 출력이 로그에 표시됩니다.

[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:admin-server-default-xx-xx-xxx  Status:Running Reason:null       DiscoverStatus:UP
[INFO] Getting public url of app(admin-server)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io

...

[INFO] Getting public url of app(api-gateway)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io

2. Spring 프로젝트 준비

다음 섹션의 Azure에 배포 단추를 누르면 Spring PetClinic 리포지토리에서 소스 코드를 배포하는 Azure Portal 환경이 시작됩니다. 로컬 준비 단계는 필요하지 않습니다.

3. 클라우드 환경 준비

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

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

3.1. Azure 포털

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

3.2. Azure 리소스 만들기

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

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

    Resource Manager 템플릿을 Azure에 배포하는 단추.

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

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

    사용자 지정 배포 페이지를 보여 주는 Azure Portal의 스크린샷.

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

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

    사용자 지정 배포 알림 창이 열려 있는 개요 페이지를 보여 주는 Azure Portal의 스크린샷.

4. Azure Spring Apps에 앱 배포

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

5. 앱 유효성 검사

다음 섹션에서는 배포의 유효성을 검사하는 방법을 설명합니다.

5.1. 애플리케이션에 액세스

배포가 완료되면 다음 스크린샷과 같이 배포 출력에서 Spring Cloud Gateway URL을 확인할 수 있습니다.

배포 출력 페이지를 보여 주는 Azure Portal의 스크린샷.

게이트웨이 URL을 엽니다. 애플리케이션은 다음 스크린샷과 비슷하게 표시됩니다.

Azure Spring Apps Enterprise 계획에서 실행되는 PetClinic 애플리케이션의 스크린샷.

5.2. 애플리케이션 로그 쿼리

Pet Clinic의 각 기능을 둘러보면 Log Analytics 작업 영역에서 각 애플리케이션의 로그를 수집합니다. 다음 스크린샷과 같이 사용자 지정 쿼리를 사용하여 로그를 확인할 수 있습니다.

PetClinic 애플리케이션에 대한 쿼리의 로그 페이지와 엔터프라이즈 계획에 대한 결과를 보여 주는 Azure Portal의 스크린샷.

5.3. 애플리케이션 모니터링

Application Insights는 다음 애플리케이션 추적 맵에 표시된 대로 애플리케이션 종속성을 모니터링합니다.

Azure Spring Apps Enterprise 계획에 대한 애플리케이션 맵 페이지를 보여 주는 Azure Portal의 스크린샷.

배포 출력에서 Application Live View URL을 확인할 수 있습니다. 다음 스크린샷과 같이 Application Live View URL을 열어 애플리케이션 런타임을 모니터링합니다.

PetClinic 애플리케이션에 대한 애플리케이션 라이브 뷰 스크린샷.

5.1. 애플리케이션에 액세스

배포 로그 출력의 URL 정보를 사용하여 이름이 지정된 api-gateway 앱에서 공개하는 URL(예: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io)을 엽니다. 애플리케이션은 다음 스크린샷과 비슷하게 표시됩니다.

Azure Spring Apps에서 실행되는 PetClinic 애플리케이션의 스크린샷.

5.2. 애플리케이션 로그 쿼리

Pet Clinic의 각 기능을 둘러보면 Log Analytics 작업 영역에서 각 애플리케이션의 로그를 수집합니다. 다음 스크린샷과 같이 사용자 지정 쿼리를 사용하여 로그를 확인할 수 있습니다.

PetClinic 애플리케이션에 대한 쿼리의 로그 페이지와 결과를 보여 주는 Azure Portal의 스크린샷.

5.3. 애플리케이션 모니터링

Application Insights는 다음 애플리케이션 추적 맵에 표시된 대로 애플리케이션 종속성을 모니터링합니다.

Application Insights 인스턴스에 대한 애플리케이션 맵 페이지를 보여 주는 Azure Portal의 스크린샷.

다음 스크린샷과 같이 admin-server 앱에서 공개하는 URL을 열어 Spring Boot Admin Server를 통해 애플리케이션을 관리합니다.

현재 애플리케이션 인스턴스를 나열하는 PetClinic 애플리케이션에 대한 Spring Boot 관리 서버 페이지의 스크린샷.

6. 리소스 정리

후속 빠른 시작 및 자습서를 계속 사용하려는 경우 이러한 리소스를 그대로 유지할 수 있습니다. 리소스가 더 이상 필요하지 않은 경우 Azure 요금이 청구되지 않도록 필요하지 않은 리소스를 정리할 수 있습니다.

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

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

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

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

다음 단계를 사용하여 전체 리소스 그룹을 삭제합니다.

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

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

7. 다음 단계

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