다음을 통해 공유

Azure API Management 자체 호스팅 게이트웨이를 Azure Container Apps에 배포

  • 아티클

적용 대상: 개발자 | 프리미엄

이 문서에서는 Azure API Management의 자체 호스팅 게이트웨이 구성 요소를 Azure Container Apps에 배포하는 단계를 제공합니다.

컨테이너 앱에 자체 호스팅 게이트웨이를 배포하여 동일한 Azure Container Apps 환경에서 호스트되는 API에 액세스합니다.

필수 조건

  • 다음 빠른 시작 Azure API Management 인스턴스 만들기를 완료합니다.

  • Azure CLI의 경우:

    참고 항목

    이 문서의 Azure CLI 명령 예제에는 containerapp Azure CLI 확장이 필요합니다. az containerapp 명령을 사용하지 않은 경우 첫 번째 az containerapp 명령을 실행할 때 확장이 동적으로 설치됩니다. Azure CLI 확장에 대해 자세히 알아보세요.

API Management 인스턴스에서 게이트웨이 프로비전

자체 호스팅 게이트웨이를 배포하려면 먼저 Azure API Management 인스턴스에서 게이트웨이 리소스를 프로비전합니다. 단계에 대해서는 자체 호스팅 게이트웨이 프로비전을 참조하세요. 이 문서의 예제에서 게이트웨이 이름은 my-gateway입니다.

API Management에서 게이트웨이 배포 설정 가져오기

게이트웨이를 배포하려면 게이트웨이의 토큰 및 구성 엔드포인트 값이 필요합니다. Azure Portal에서 이러한 값을 확인할 수 있습니다.

  1. Azure Portal에 로그인하고 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴에 있는 배포 및 인프라에서 게이트웨이를 선택합니다.
  3. 프로비전한 게이트웨이 리소스를 선택하고 배포를 선택합니다.
  4. 토큰 및 구성 엔드포인트 값을 복사합니다.

컨테이너 앱에 자체 호스팅 게이트웨이 배포

Azure Portal, Azure CLI 또는 기타 도구를 사용하여 자체 호스팅 게이트웨이 컨테이너 이미지를 컨테이너 앱에 배포할 수 있습니다. 이 문서에서는 Azure CLI를 사용하는 단계를 보여 줍니다.

컨테이너 앱 환경 만들기

먼저 az containerapp env create 명령을 사용하여 컨테이너 앱 환경을 만듭니다.

#!/bin/bash
az containerapp env create --name my-environment --resource-group myResourceGroup \
    --location centralus

이 명령은 다음을 만듭니다.

  • 컨테이너 앱을 그룹화하는 데 사용하는 my-environment라는 컨테이너 앱 환경
  • Log Analytics 작업 영역

자체 호스팅 게이트웨이에 대한 컨테이너 앱 만들기

환경의 컨테이너 앱에 자체 호스팅 게이트웨이를 배포하려면 az containerapp create 명령을 실행합니다.

먼저 API Management 게이트웨이 리소스의 토큰 및 구성 엔드포인트 값에 대한 변수를 설정합니다.

#!/bin/bash
endpoint="<API Management configuration endpoint>"
token="<API Management gateway token>"

az containerapp create 명령을 사용하여 컨테이너 앱을 만듭니다.

#!/bin/bash
az containerapp create --name my-gateway \
    --resource-group myResourceGroup --environment 'my-environment' \
    --image "mcr.microsoft.com/azure-api-management/gateway:2.5.0" \
    --target-port 8080 --ingress external \
    --min-replicas 1 --max-replicas 3 \
    --env-vars "config.service.endpoint"="$endpoint" "config.service.auth"="$token" "net.server.http.forwarded.proto.enabled"="true"

이 명령은 다음을 만듭니다.

  • myResourceGroup 리소스 그룹의 my-gateway라는 컨테이너 앱. 이 예제에서는 mcr.microsoft.com/azure-api-management/gateway:2.5.0 이미지를 사용하여 컨테이너 앱을 만듭니다. 자체 호스팅 게이트웨이 컨테이너 이미지에 대해 자세히 알아봅니다.

  • 포트 8080의 컨테이너 앱에 대한 외부 수신 지원

  • 최소 1개 및 최대 3개의 컨테이너 앱 복제본

  • 환경 변수에 전달된 구성 값을 사용하여 자체 호스팅 게이트웨이에서 API Management 인스턴스로의 연결. 자세한 내용은 자체 호스팅 게이트웨이 컨테이너 구성 설정을 참조하세요.

    참고 항목

    Azure Container Apps 수신은 자체 호스팅 게이트웨이 컨테이너 앱에 HTTPS 요청을 HTTP로 전달합니다. 여기서 net.server.http.forwarded.proto.enabled 환경 변수는 자체 호스팅 게이트웨이가 X-Forwarded-Proto 헤더를 사용하여 요청의 원래 프로토콜을 결정하도록 true로 설정됩니다.

컨테이너 앱이 실행 중인지 확인

  1. Azure Portal에 로그인하고 컨테이너 앱으로 이동합니다.

  2. 컨테이너 앱의 개요 페이지에서 상태가 실행 중인지 확인합니다.

  3. /status-012345678990abcdef의 상태 엔드포인트에 테스트 요청을 보냅니다. 예를 들어 다음과 유사한 curl 명령을 사용합니다.

    curl -i https://my-gateway.happyvalley-abcd1234.centralus.azurecontainerapps.io/status-012345678990abcdef

    성공한 요청은 200 OK 응답을 반환합니다.

팁

CLI에서 az containerapp show 명령을 실행하여 컨테이너 앱의 상태를 확인할 수도 있습니다.

게이트웨이가 정상 상태인지 확인

  1. Azure Portal에 로그인하고 API Management 인스턴스로 이동합니다.

  2. 왼쪽 메뉴에 있는 배포 및 인프라에서 게이트웨이를 선택합니다.

  3. 개요 페이지에서 게이트웨이의 상태를 확인합니다. 게이트웨이가 정상이면 일반 게이트웨이 하트비트를 보고합니다.

    포털의 게이트웨이 상태 스크린샷

예제 시나리오

다음 예제에서는 자체 호스팅 게이트웨이를 사용하여 동일한 환경의 컨테이너 앱에서 호스트되는 API에 액세스하는 방법을 보여 줍니다. 다음 다이어그램에 표시된 것처럼 자체 호스팅 게이트웨이는 인터넷에서 액세스할 수 있지만 API는 컨테이너 앱 환경 내에서만 액세스할 수 있습니다.

자체 호스팅 게이트웨이를 사용하는 예제 시나리오 다이어그램

  1. 자체 호스팅 게이트웨이와 동일한 환경에서 API를 호스트하는 컨테이너 앱 배포
  2. API를 API Management 인스턴스로 추가
  3. 자체 호스팅 게이트웨이를 통해 API 호출

자체 호스팅 게이트웨이와 동일한 환경에서 API를 호스트하는 컨테이너 앱 배포

예를 들어 예제 음악 앨범 API를 컨테이너 앱에 배포합니다. 자체 호스팅 게이트웨이를 사용하여 나중에 API에 액세스하려면 자체 호스팅 게이트웨이와 동일한 환경에서 API를 배포합니다. 이 예제에 사용된 리소스에 대한 자세한 단계 및 정보는 빠른 시작: 로컬 소스 코드에서 빌드 및 Azure Container Apps에 배포를 참조하세요. 축약된 단계는 다음과 같습니다.

  1. Python 소스 코드를 로컬 컴퓨터에 다운로드합니다. 원할 경우 원하는 다른 언어로 소스 코드를 다운로드합니다.

  2. 소스 코드를 로컬 폴더로 추출하고 containerapps-albumapi-python-main/src 폴더로 변경합니다.

  3. 다음 az containerapp up 명령을 실행하여 자체 호스팅 게이트웨이와 동일한 환경에 있는 컨테이너 앱에 API를 배포합니다. 명령의 끝에는 현재 폴더를 컨테이너 앱의 원본으로 지정하는 .이 있습니다.

    #!/bin/bash
az containerapp up --name albums-api \
    --resource-group myResourceGroup --location centralus \
    --environment my-environment --source .

  4. 컨테이너 앱이 실행 중이며 명령 출력에서 반환된 FQDN의 외부에서 액세스할 수 있는지 확인합니다. 기본적으로 API는 /albums 엔드포인트에서 액세스할 수 있습니다. 예: https://albums-api.happyvalley-abcd1234.centralus.azurecontainerapps.io/albums/albums

내부 수신을 위해 API 구성

이제 샘플 API를 호스트하는 컨테이너 앱을 업데이트하여 컨테이너 환경에서만 수신을 사용하도록 설정합니다. 이 설정은 배포한 자체 호스팅 게이트웨이에서만 API에 액세스하도록 제한합니다.

  1. Azure Portal에 로그인하고 컨테이너 앱으로 이동합니다.
  2. 왼쪽 메뉴에서 수신을 선택합니다.
  3. 수신을 사용으로 설정합니다.
  4. 수신 트래픽에서 컨테이너 앱 환경으로 제한을 선택합니다.
  5. 나머지 설정을 검토하고 저장을 선택합니다.

API를 API Management 인스턴스로 추가

다음은 API Management 인스턴스에 API를 추가하고 API 백 엔드를 구성하는 예제 단계입니다. 자세한 내용은 Azure API Management에 API 추가를 참조하세요.

API를 API Management 인스턴스로 추가

  1. 포털에서 자체 호스팅 게이트웨이를 구성한 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴에서 API>+ API 추가를 선택합니다.
  3. HTTP를 선택하고 전체를 선택합니다. 다음 설정을 입력합니다.
    1. 표시 이름: 설명이 포함된 이름을 입력합니다. 예: 앨범 API.
    2. 웹 서비스 URL: API를 호스트하는 컨테이너 앱의 내부 FQDN을 입력합니다. 예: http://albums-api.internal.happyvalley-abcd1234.centralus.azurecontainerapps.io
    3. URL 체계: HTTP(S)를 선택합니다.
    4. API URL 접미사: 원하는 접미사를 입력합니다. 예: albumapi.
    5. 게이트웨이: 프로비전한 자체 호스팅 게이트웨이를 선택합니다. 예: my-gateway.
  4. 시나리오에 따라 다른 API 설정을 구성합니다. 만들기를 실행합니다.

API 작업 추가

  1. 왼쪽 메뉴에서 API>앨범 API를 선택합니다.
  2. + 작업 추가를 선택합니다.
  3. 작업 설정을 입력합니다.
    1. 표시 이름: 작업에 대한 설명이 포함된 이름을 입력합니다. 예: 앨범 가져오기.
    2. URL: 가져오기를 선택하고 엔드포인트에 대해 /albums를 입력합니다.
    3. 저장을 선택합니다.

자체 호스팅 게이트웨이를 통해 API 호출

컨테이너 앱에서 실행되는 자체 호스팅 게이트웨이의 FQDN을 사용하여 API를 호출합니다. Azure Portal의 컨테이너 앱 개요 페이지에서 FQDN을 찾거나 다음 az containerapp show 명령을 실행합니다.

#!/bin/bash
az containerapp show --name my-gateway --resource-group myResourceGroup \
    --query "properties.configuration.ingress.fqdn" --output tsv

예를 들어 다음 curl 명령을 실행하여 /albumapi/albums 엔드포인트에서 API를 호출합니다. API에 구독 키가 필요한 경우 API Management 인스턴스에 대한 유효한 구독 키를 요청의 헤더로 전달합니다.

curl -i https://my-gateway.happyvalley-abcd1234.centralus.azurecontainerapps.io/albumapi/albums -H "Ocp-Apim-Subscription-Key: <subscription-key>"

테스트가 성공하면 백 엔드는 성공적인 HTTP 응답 코드와 일부 데이터로 응답합니다.

HTTP/1.1 200 OK
content-length: 751
content-type: application/json
date: Wed, 28 Feb 2024 22:45:09 GMT
[...]

[{"id":1,"title":"You, Me and an App Id","artist":"Daprize","price":10.99,"image_url":"https://aka.ms/albums-daprlogo"},{"id":2,"title":"Seven Revision Army","artist":"The Blue-Green Stripes","price":13.99,"image_url":"https://aka.ms/albums-containerappslogo"},{"id":3,"title":"Scale It Up","artist":"KEDA Club","price":13.99,"image_url":"https://aka.ms/albums-kedalogo"},{"id":4,"title":"Lost in Translation","artist":"MegaDNS","price":12.99,"image_url":"https://aka.ms/albums-envoylogo"},{"id":5,"title":"Lock Down Your Love","artist":"V is for VNET","price":12.99,"image_url":"https://aka.ms/albums-vnetlogo"},{"id":6,"title":"Sweet Container O' Mine","artist":"Guns N Probeses","price":14.99,"image_url":"https://aka.ms/albums-containerappslogo"}]

팁

Application Insights에 대한 API 로깅을 사용하도록 설정한 경우 로그를 쿼리하여 요청 및 응답을 확인할 수 있습니다.

관련 콘텐츠