gRPC API 가져오기(미리 보기)

아티클
03/12/2024

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

이 문서에서는 API Management에서 gRPC 서비스 정의를 API로 가져오는 방법을 보여줍니다. 그런 다음, API Management에서 API를 관리하고, 액세스를 보호하고, 다른 정책을 적용하고, gRPC API 요청을 게이트웨이를 통해 gRPC 백 엔드에 전달할 수 있습니다.

API Management에 gRPC API를 추가하려면 다음을 수행해야 합니다.

API의 Protobuf(프로토콜 버퍼) 정의 파일을 API Management에 업로드
gRPC 서비스의 위치 지정
API Management에서 API 구성

API Management는 단항, 서버 스트리밍, 클라이언트 스트리밍 및 양방향 스트리밍과 같은 유형의 gRPC 서비스 메서드를 사용하여 통과를 지원합니다. gRPC에 대한 배경 정보는 gRPC 소개를 참조하세요.

참고 항목

gRPC API 가져오기는 미리 보기로 제공됩니다. 현재 gRPC API는 API Management 인스턴스에 대한 관리되는 게이트웨이가 아닌 자체 호스팅 게이트웨이에서만 지원됩니다.
현재 gRPC API 테스트는 Azure Portal의 테스트 콘솔 또는 API Management 개발자 포털에서 지원되지 않습니다.

필수 조건

API Management 인스턴스. 아직 없는 경우 Azure API Management 인스턴스 만들기 빠른 시작을 완료합니다.
인스턴스에 프로비전된 게이트웨이 리소스입니다. 아직 없는 경우 Azure API Management에서 자체 호스팅 게이트웨이 프로비전을 참조하세요.
로컬에서 사용할 수 있는 gRPC Protobuff(.proto) 파일 및 HTTPS를 통해 액세스할 수 있는 gRPC 서비스입니다.

gRPC API 추가

포털

Azure Portal에서 API Management 인스턴스로 이동합니다.
왼쪽 메뉴에서 API>+ API 추가를 선택합니다.
새 API 정의에서 gRPC를 선택합니다.
gRPC API 만들기 창에서 전체를 선택합니다.
gRPC API의 경우 다음 설정을 지정해야 합니다.
1. 업로드 스키마에서 가져올 API와 연결된 로컬 .proto 파일을 선택합니다.
2. gRPC 서버 URL에 gRPC 서비스의 주소를 입력합니다. 주소는 HTTPS를 통해 액세스할 수 있어야 합니다.
3. 게이트웨이에서 API를 노출하는 데 사용할 게이트웨이 리소스를 선택합니다.
  
  Important
  
  공개 미리 보기에서는 자체 호스팅 게이트웨이만 선택할 수 있습니다. 관리 게이트웨이는 지원되지 않습니다.
나머지 설정을 입력하여 API를 구성합니다. 이러한 설정은 첫 번째 API 가져오기 및 게시 자습서에 설명되어 있습니다.
만들기를 실행합니다.

API가 API 목록에 추가됩니다. API의 설정 탭으로 이동하여 설정 업데이트를 확인할 수 있습니다.