현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
확장 프로그램을 사용하여 외부 리소스를 API 프록시에 통합할 수 있습니다. 예를 들어 Google Cloud Storage와 같은 Google Cloud Platform 서비스를 통합할 수 있습니다. 런타임 시 API 프록시는 확장 프로그램을 사용하여 외부 리소스와 요청 및 응답을 교환합니다.
확장 프로그램 런타임 프레임워크
런타임 시 확장 프로그램은 API 프록시와 외부 리소스 간의 요청과 응답을 처리하는 중간 역할을 합니다.
다음은 런타임 시 확장 프로그램을 통한 처리가 작동하는 방식을 간략하게 설명합니다.
- 클라이언트 요청은 API 프록시에 도달하고 요청 흐름은 프록시 정책을 통해 진행됩니다.
- 요청 흐름은 환경에 배포된 확장 프로그램에 데이터를 전달하도록 구성된 프록시의 확장 프로그램 콜아웃 정책에 도달합니다. 데이터에는 확장 프로그램이 나타내는 외부 리소스에 요청을 전송하는 데 필요한 값이 포함됩니다.
- 확장 프로그램은 외부 리소스에 요청을 보낸 다음 응답을 수신합니다.
- 확장 프로그램은 확장 프로그램 콜아웃 정책으로 응답을 다시 전달하여 프록시 코드에 의해 처리됩니다.
- 요청 흐름은 클라이언트에 응답을 반환할 때까지 프록시를 통해 계속됩니다.
확장 프로그램 사용
각 확장 프로그램은 특정 외부 리소스를 염두에 두고 개발 및 구성됩니다. 확장 프로그램을 사용하려면 Apigee Edge 관리자 및 API 프록시 개발자가 다음의 대략적인 단계를 따릅니다.
- Apigee Edge 조직 관리자가 확장 프로그램을 구성하고 배포합니다. 비즈니스의 요구에 맞는 값으로 모듈을 구성합니다. 이 구성은 API 프록시 개발자가 사용하도록 포커스가 맞춰진 확장 프로그램 인스턴스를 만듭니다. 예를 들어 필요한 사용자 인증 정보를 포함하여 Google Cloud Storage의 특정 버킷에 액세스하도록 확장 프로그램을 구성할 수 있습니다.
- API 프록시 개발자는 프록시에 확장 프로그램 콜아웃 정책을 추가하여 API 프록시에 구성된 확장 프로그램을 사용합니다. 정책의 구성은 다음을 지정합니다.
- 사용할 확장 프로그램을 구성합니다.
- 호출할 확장 프로그램 작업 (확장 프로그램에 대한 함수 호출이라고 생각함)입니다.
- 작업 호출과 함께 전달할 작업 매개변수입니다. 런타임 시 정책은 확장 프로그램을 사용하여 프록시 흐름의 일부로 외부 리소스에 액세스합니다.
확장 프로그램 관련 문서
다음 주제는 확장 프로그램에 대한 자세한 정보를 제공합니다.
- 확장 프로그램에 관한 실습 소개는 튜토리얼: 확장 프로그램 추가 및 사용을 참고하세요.
- Apigee Edge에 포함된 확장 프로그램에 대한 참고 자료는 확장 프로그램 참조 개요를 확인하세요.
- 확장 프로그램을 추가, 삭제, 배포하는 데 사용할 수 있는 관리 API에 대한 참조는 Extensions API를 참고하세요.