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

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

이 문서에서는 Azure API Management의 자체 호스팅 게이트웨이 구성 요소를 Docker 환경에 배포하는 단계에 대해 설명합니다.

Important

Azure API Management 자체 호스팅 게이트웨이 버전 0 및 버전 1 컨테이너 이미지에 대한 지원은 해당 구성 API v1과 함께 2023년 10월 1일에 종료됩니다. 구성 API v2와 함께 자체 호스팅 게이트웨이 v2.0.0 이상을 사용하려면 마이그레이션 가이드를 사용합니다. 사용 중단 설명서에서 자세히 알아보기

참고 항목

Docker에서 자체 호스팅 게이트웨이를 호스트하는 것은 평가 및 개발 사용 사례에 가장 적합합니다. 프로덕션 용도로 Kubernetes가 권장됩니다. Helm을 사용하여 배포하거나 배포 YAML 파일을 사용하여 Kubernetes에 자체 호스팅 게이트웨이를 배포하는 방법을 알아봅니다.

필수 조건

• 다음 빠른 시작 Azure API Management 인스턴스 만들기를 완료합니다.
• Docker 환경을 만듭니다. 데스크톱용 Docker는 개발 및 평가 목적을 위한 좋은 옵션입니다. Docker 자체에 대한 모든 Docker 버전, 해당 기능 및 포괄적인 설명서에 대한 자세한 내용은 Docker 설명서를 참조하세요.
• API Management 인스턴스에서 게이트웨이 리소스 프로비저닝

참고 항목

자체 호스팅 게이트웨이는 x86-64 Linux 기반 Docker 컨테이너로 패키지됩니다.

Docker에 자체 호스팅 게이트웨이 배포

1. 배포 및 인프라 아래에서 게이트웨이를 선택합니다.

2. 배포하려는 게이트웨이 리소스를 선택합니다.

3. 배포를 선택합니다.

4. 토큰 텍스트 상자의 액세스 토큰은 기본 만료 및 비밀 키 값을 사용하여 자동으로 생성되었습니다. 필요한 경우 컨트롤 중 하나 또는 둘 다에서 원하는 값을 선택하여 새 토큰을 생성합니다.

5. 배포 스크립트 아래에서 Docker가 선택되어 있는지 확인합니다.

6. 환경 옆에 있는 env.conf 파일 링크를 선택하여 파일을 다운로드합니다.

7. 실행 텍스트 상자의 오른쪽 끝에 있는 복사 아이콘을 선택하여 Docker 명령을 클립보드로 복사합니다.

8. 명령을 터미널(또는 명령) 창에 붙여넣습니다. 필요에 따라 포트 매핑 및 컨테이너 이름을 조정합니다. 명령은 다운로드한 환경 파일이 현재 디렉터리에 있는 것으로 가정합니다.

   docker run -d -p 80:8080 -p 443:8081 --name <gateway-name> --env-file env.conf mcr.microsoft.com/azure-api-management/gateway:<tag>
   

9. 명령을 실행합니다. 이 명령은 Microsoft Artifact Registry에서 컨테이너 이미지를 사용하여 컨테이너를 실행하고 컨테이너의 HTTP(8080) 및 HTTPS(8081) 포트를 호스트의 포트 80 및 443에 매핑하라고 Docker 환경에 지시합니다.

10. 아래 명령을 실행하여 게이트웨이 컨테이너가 실행되고 있는지 확인합니다.

    docker ps
    CONTAINER ID        IMAGE                                                 COMMAND                  CREATED             STATUS              PORTS                                         NAMES
    895ef0ecf13b        mcr.microsoft.com/azure-api-management/gateway:latest   "/bin/sh -c 'dotnet …"   5 seconds ago       Up 3 seconds        0.0.0.0:80->8080/tcp, 0.0.0.0:443->8081/tcp   my-gateway
    

11. Azure Portal로 돌아가서 개요를 클릭하고 방금 배포한 자체 호스팅 게이트웨이 컨테이너가 정상 상태를 보고하는지 확인합니다.

    

팁

console docker container logs <gateway-name> 명령을 사용하여 자체 호스팅 게이트웨이 로그의 스냅샷을 봅니다.

docker container logs --help 명령을 사용하여 모든 로그 보기 옵션을 확인합니다.

다음 단계

• 자체 호스팅 게이트웨이에 대한 자세한 내용은 Azure API Management 자체 호스팅 게이트웨이 개요를 참조하세요.
• 자체 호스팅 게이트웨이에 대한 사용자 지정 도메인을 구성합니다.