참고:
- 이 자습서에서는 Oracle Cloud에 액세스해야 합니다. 무료 계정에 등록하려면 Oracle Cloud Infrastructure Free Tier 시작하기를 참조하십시오.
- Oracle Cloud Infrastructure 인증서, 테넌시 및 구획에 대한 예제 값을 사용합니다. 실습을 완료하려면 이 값을 클라우드 환경에 해당하는 값으로 대체하십시오.
OCI REST API 호출을 사용하여 API Gateway 뒤에서 전용 OCI 스트리밍 토픽 소비
소개
Oracle Cloud Infrastructure(OCI) Streaming 서비스는 대용량 데이터 스트림을 실시간으로 입수하고 사용할 수 있는 확장 가능하며 내구성 있는 전담 관리 솔루션을 제공합니다. 게시-구독 메시징 모델에서 데이터가 연속적이고 순차적으로 생성되고 처리되는 모든 사용 사례에 OCI Streaming을 사용합니다.
이 시나리오에서는 액세스를 제어하고 보호하려면 공용 API 게이트웨이를 사용하여 전용 OCI 스트리밍 토픽을 노출하고 소비해야 합니다.
목표
이 사용지침서에서는 API 게이트웨이 REST API 호출을 사용하여 OCI 스트리밍 토픽을 소비하는 방법을 보여줍니다.
필요 조건
- 관리자 레벨 액세스 권한이 있는 Oracle 계정
- 리소스를 생성할 구획입니다.
- 로컬 OCI-CLI 설정, 도움이 필요한 경우 CLI 자습서 설치를 참조하십시오.
- 서브넷 2개(전용 및 공용)의 VCN입니다. 네트워크 자습서 생성을 참조하십시오.
- 서브넷에 전용 및 공용 서브넷에 대해 서비스 게이트웨이 및 포트 443에 대한 적절한 수신 규칙이 있는지 확인하십시오.
- OCI Streaming 주제 OCI Stream 튜토리얼 생성
- 테스트를 위해 설치된 로컬 Python 버전 3
작업 1: OCI 스트리밍에서 세부정보 가져오기
-
스트림으로 이동하여 OCID를 기록하고 메시징 아래의 분석 및 AI를 누른 다음 스트리밍을 누르고 스트림을 선택합니다.
-
OCID 및 메시지 엔드포인트는 API 게이트웨이에 필요합니다.
작업 2: 공용 API 게이트웨이 생성
-
개발자 서비스의 API 관리에서 게이트웨이를 누른 다음 게이트웨이 생성을 누릅니다.
작업 3: API 게이트웨이에 대한 배치 생성
-
태스크 2에서 생성된 API 게이트웨이를 선택하고 배치를 누른 다음 배치 생성을 누릅니다.
-
이제 your_ocid_for_stream를 아래의 스트림 OCID로 바꿔 접두어를 생성하고 이름을 publicTopic로 채웁니다.
/20180418/streams/your_ocid_for_stream
-
다음을 누릅니다.
-
다음을 누릅니다.
-
groupCursors에 대한 경로 1 만들기: 이 자습서의 Task 2에서 수집한 끝점 및 스트림 OCID를 사용하여 URL을 만들고 URL을 작성합니다.
<streaming_endpoint>/20180418/streams/<stream_ocid>/groupCursors
참고: 스트림을 소비하기 위해 스트리밍용 OCI REST API는 두 개의 끝점인 groupCursors 및 메시지를 사용하므로 해당 두 경로를 생성해야 합니다. 이제 다음과 같이 경로, 방법, 백엔드 유형과 같은 필요한 정보를 제공합니다.
-
+Another route를 누르고 messages에 대해 Route 2를 추가합니다. 동일한 URL을 사용하지만 끝에 /messages로 끝나는 끝점은 다릅니다.
-
publicTopic으로 이동하고 API 게이트웨이 끝점을 확인합니다.
작업 4: 스트리밍에 테스트 메시지 생성
-
스트리밍 페이지로 이동하고 테스트 메시지 생성을 누릅니다.
-
이러한 메시지는 작업 5에서 사용됩니다.
작업 5: API 게이트웨이 뒤에서 REST API를 통한 OCI 스트리밍 소비
-
샘플 Python 소비 코드 consume_rest_api_oci_lab.py를 다운로드합니다.
-
이 자습서 앞부분에서 수집한 값으로 표시된 대로 API Gateway 끝점 및 스트림 OCID의 값을 변경하십시오.
-
Python 코드를 실행하여 제대로 작동하는지 확인합니다.
python3 consume_rest_api_oci_lab.py
관련 링크
수락
- 작성자 - Joao Tarla(Oracle LAD A-Team 솔루션 엔지니어)
추가 학습 자원
docs.oracle.com/learn에서 다른 실습을 탐색하거나 Oracle Learning YouTube 채널에서 더 많은 무료 학습 콘텐츠에 액세스할 수 있습니다. 또한 education.oracle.com/learning-explorer을 방문하여 Oracle Learning Explorer가 됩니다.
제품 설명서는 Oracle Help Center를 참조하십시오.
Consume a private OCI Streaming topic behind an API Gateway using OCI REST API call
F80887-01
April 2023
Copyright © 2023, Oracle and/or its affiliates.