자습서: Azure Container Apps에서 Spring용 관리 게이트웨이에 연결(미리 보기)

Spring용 게이트웨이는 마이크로 서비스 아키텍처의 일부로 API 요청을 라우팅, 관리 및 처리하는 효율적이고 강력한 방법을 제공합니다. 외부 요청을 다른 서비스로 라우팅하여 필터링, 부하 분산 등과 같은 다양한 기능을 추가하는 API 게이트웨이 역할을 합니다. 이 문서에서는 컨테이너 앱에 요청을 전송하는 게이트웨이를 만드는 방법을 알아봅니다.

이 자습서에서는 다음을 알아봅니다.

필수 조건

• 활성 구독이 있는 Azure 계정. 아직 없는 경우 무료로 만들 수 있습니다.
• Azure CLI

고려 사항

Azure Container Apps의 Spring용 게이트웨이에서 실행하는 경우 다음 세부 정보를 알고 있어야 합니다.

설정

Spring용 게이트웨이 작업을 시작하기 전에 먼저 필요한 리소스를 만들어야 합니다.

다음 명령을 실행하여 리소스 그룹 및 Container Apps 환경을 만듭니다.

1. 애플리케이션 구성을 지원하는 변수를 만듭니다. 이러한 값은 이 단원의 목적을 위해 제공됩니다. 이 단원에서는 Spring 샘플 앱에 대한 관리자의 액추에이터 엔드포인트를 사용합니다.

   export LOCATION=eastus
   export RESOURCE_GROUP=my-spring-cloud-resource-group
   export ENVIRONMENT=my-spring-cloud-environment
   export JAVA_COMPONENT_NAME=mygateway
   export APP_NAME=myapp
   export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-admin-for-spring-client:latest"
   

   변수	설명
   LOCATION	컨테이너 앱 및 Java 구성 요소를 만드는 Azure 지역 위치입니다.
   ENVIRONMENT	데모 애플리케이션의 Azure Container Apps 환경 이름입니다.
   RESOURCE_GROUP	데모 애플리케이션에 대한 Azure 리소스 그룹 이름입니다.
   JAVA_COMPONENT_NAME	컨테이너 앱용으로 만들어진 Java 구성 요소의 이름입니다. 이 경우 Spring Java 구성 요소에 대한 게이트웨이를 만듭니다.
   IMAGE	컨테이너 앱에 사용되는 컨테이너 이미지입니다.

2. Azure CLI를 사용하여 Azure에 로그인합니다.

   az login
   

3. 리소스 그룹을 만듭니다.

   az group create --name $RESOURCE_GROUP --location $LOCATION
   

4. 컨테이너 앱 환경을 만듭니다.

   az containerapp env create \
       --name $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION
   

   이 환경은 Spring용 게이트웨이 구성 요소와 컨테이너 앱을 모두 호스트하는 데 사용됩니다.

Spring Java용 게이트웨이 구성 요소 사용

이제 Container Apps 환경이 있으므로 Spring Java 구성 요소에 대한 게이트웨이를 사용하여 컨테이너 앱을 만들어 요청을 라우팅할 수 있습니다.

1. Spring Java 구성 요소에 대한 게이트웨이를 만듭니다.

   az containerapp env java-component gateway-for-spring create \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
   

2. FQDN(정규화된 도메인 이름)이 있는 컨테이너 앱을 만듭니다.

   az containerapp create \
       --name $APP_NAME \
       --resource-group $RESOURCE_GROUP \
       --environment $ENVIRONMENT \
       --image $IMAGE \
       --ingress external \
       --target-port 8080 \
       --query properties.configuration.ingress.fqdn
   

   이 명령은 구성 데이터를 사용하는 컨테이너 앱의 URL을 반환합니다. 다음 단계에서 사용할 수 있도록 URL을 텍스트 편집기로 복사합니다.

게이트웨이 경로를 업데이트하여 요청 라우팅

1. 다음 콘텐츠를 사용하여 YAML 파일을 만듭니다. 이전 단계의 컨테이너 앱 FQDN으로 바꿉 <MYAPP_URL> 다.

   springCloudGatewayRoutes:
   - id: "route1"
     uri: "<MYAPP_URL>"
     predicates:
       - "Path=/myapp/{path}"
     filters:
       - "SetPath=/actuator/{path}"
   

2. 다음 명령을 실행하여 경로 구성으로 Spring용 게이트웨이 구성 요소를 업데이트합니다.

   az containerapp env java-component gateway-for-spring update \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \ 
       --route-yaml <PTAH_TO_ROUTE_YAML_FILE> \
       --query properties.ingress.fqdn
   

   이 명령은 게이트웨이 경로를 업데이트하고 구성 데이터를 사용하는 게이트웨이의 URL을 반환합니다.

   이 명령은 게이트웨이의 URL을 반환합니다. 경로를 /myapp/health 사용하여 이 URL을 방문하면 요청을 앱의 actuator/health 엔드포인트로 라우팅하고 {"status":"UP","groups":["liveness","readiness"]}반환해야 합니다.

리소스 정리

이 자습서에서 만든 리소스는 Azure 청구서에 영향을 줍니다. 이러한 서비스를 장기간 사용하지 않을 예정이면 다음 명령을 실행하여 이 자습서에서 만든 모든 항목을 제거합니다.

az group delete --resource-group $RESOURCE_GROUP

경로 파일 형식

Spring용 게이트웨이 구성 요소는 ID, URI, 조건자 및 필터를 사용하여 속성을 통한 경로 정의를 지원합니다. 자세한 내용은 Spring Cloud Gateway 설명서를 참조 하세요. 다음은 이러한 속성을 구성하는 방법을 보여 주는 YAML 파일 예제입니다.

  springCloudGatewayRoutes:
  - id: "route1"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v1/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"
  - id: "route2"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v2/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"

Spring용 게이트웨이에 허용되는 구성 목록(#configurable-properties)

다음 표에서는 앱에 대해 구성할 수 있는 게이트웨이 구성 요소 속성에 대해 설명합니다. 자세한 내용은 Spring Cloud Gateway Common 애플리케이션 속성을 참조 하세요.

일반 구성

다음 목록에서는 일반적인 구성에 대해 설명합니다.

• 관련 구성 로깅
  • logging.level.*
  • logging.group.*
  • logging.* 네임스페이스의 다른 모든 구성은 금지되어야 합니다. 예를 들어, logging.file을 사용하여 로그 파일을 작성하는 것은 금지되어야 합니다.