적용 대상: 개발자 | 프리미엄
이 문서에서는 Azure API Management의 자체 호스팅 게이트웨이 구성 요소를 Docker 환경에 배포하는 단계에 대해 설명합니다.
참고 항목
Docker에서 자체 호스팅 게이트웨이를 호스팅하는 것은 평가 및 개발 사용 사례에 가장 적합합니다. 프로덕션 용도로 Kubernetes가 권장됩니다. Helm을 사용하거나 배포 YAML 파일을 사용하여 Kubernetes에 자체 호스팅 게이트웨이를 배포하는 방법을 알아봅니다.
필수 조건
- 다음 빠른 시작을 완료합니다. Azure API Management 인스턴스를 만듭니다.
- Docker 환경 만들기: 데스크톱용 Docker 는 개발 및 평가 목적에 적합한 옵션입니다. Docker 자체에 대한 모든 Docker 버전, 해당 기능 및 포괄적인 설명서에 대한 자세한 내용은 Docker 설명서를 참조하세요.
- Azure API Management 인스턴스에서 게이트웨이 리소스를 프로비전합니다.
참고 항목
자체 호스팅 게이트웨이는 x86-64 Linux 기반 Docker 컨테이너로 패키지됩니다.
Docker에 자체 호스팅 게이트웨이 배포
배포 + 인프라에서 자체 호스팅 게이트웨이를 선택합니다.
배포하려는 게이트웨이 리소스를 선택합니다.
설정> 및 배포를 선택합니다.
토큰 텍스트 상자의 액세스 토큰은 기본 만료 및 비밀 키 값을 사용하여 자동으로 생성됩니다. 필요한 경우 컨트롤 중 하나 또는 둘 다에서 원하는 값을 선택하여 새 토큰을 생성합니다.
배포 스크립트 아래에서 Docker가 선택되어 있는지 확인합니다.
환경 옆에 있는 env.conf 파일 링크를 선택하여 파일을 다운로드합니다.
실행 텍스트 상자의 오른쪽 끝에 있는 복사 아이콘을 선택하여 Docker 명령을 클립보드에 복사합니다.
명령을 터미널(또는 명령) 창에 붙여넣습니다. 필요에 따라 포트 매핑 및 컨테이너 이름을 조정합니다. 이 명령은 다운로드한 환경 파일이 현재 디렉터리에 있다고 가정합니다.
docker run -d -p 80:8080 -p 443:8081 --name <gateway-name> --env-file env.conf mcr.microsoft.com/azure-api-management/gateway:<tag>명령을 실행합니다. 이 명령은 Microsoft Artifact Registry의 컨테이너 이미지를 사용하여 컨테이너 를 실행하고 컨테이너의 HTTP(8080) 및 HTTPS(8081) 포트를 호스트의 포트 80 및 443에 매핑하도록 Docker 환경에 지시합니다.
다음 명령을 실행하여 게이트웨이 컨테이너가 실행 중인지 확인합니다.
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-gatewayAzure Portal로 돌아가 서 개요를 선택하고 방금 배포한 자체 호스팅 게이트웨이 컨테이너가 정상 상태를 보고했는지 확인합니다.
팁
console docker container logs <gateway-name> 명령을 사용하여 자체 호스팅 게이트웨이 로그의 스냅샷을 봅니다.
docker container logs --help 명령을 사용하여 모든 로그 보기 옵션을 확인합니다.
관련 콘텐츠
- 자체 호스팅 게이트웨이에 대한 자세한 내용은 자체 호스팅 게이트웨이 개요를 참조하세요.
- 자체 호스팅 게이트웨이에 대한 사용자 지정 도메인 이름을 구성합니다.