5.5. 예제 API 공급자 빠른 시작 통합 가져오기 및 게시
Fuse Online에서는 Fuse Online 환경으로 가져올 수 있는 빠른 시작 API 공급자를 제공합니다. 이 빠른 시작에는 작업 관리 API를 위한 OpenAPI 문서가 포함되어 있습니다. 빠른 시작 통합을 가져온 후 흐름을 검사한 다음 통합을 게시할 수 있습니다. 아래에 설명된 절차를 완료하면 TaskAPI 통합이 실행 중이며 실행될 준비가 된 것입니다.
API 공급자 빠른 시작 기능을 사용하면 API 공급자 통합을 구성, 게시 및 테스트하는 방법을 빠르게 확인할 수 있습니다. 그러나 이는 API 공급자 통합이 얼마나 유용할 수 있는지에 대한 실제 사례가 아닙니다. 실제 예제의 경우 이미 Fuse Online을 사용하여 몇 가지 간단한 통합을 게시한다고 가정합니다. 이러한 통합 실행을 트리거하기 위해 OpenAPI 문서를 정의할 수 있습니다. 이를 위해 각 OpenAPI 작업의 흐름을 편집하여 이미 게시한 간단한 통합과 거의 동일합니다.
사전 요구 사항
- Fuse Online은 브라우저에서 열려 있습니다.
-
Fuse Online 환경에는 OCP에서 실행되는 Fuse Online 환경에 샘플 데이터 추가에 설명된 대로
Todo
샘플 앱 및 샘플 PostgreSQL 데이터베이스가 포함되어야 합니다.
절차
TaskAPI 빠른 시작 통합을 가져옵니다.
-
https://github.com/syndesisio/syndesis-quickstarts/api-provider 로 이동하여
TaskAPI-export.zip
을 다운로드합니다. - Fuse Online의 왼쪽 탐색 패널에서 통합을 클릭합니다.
- 오른쪽 상단에서 가져오기 를 클릭합니다.
-
다운로드한
TaskAPI-export.zip
파일을 가져오기 페이지로 끕니다. Fuse Online은 파일을 가져왔음을 나타냅니다. - 왼쪽 탐색 패널에서 통합을 클릭하여 방금 가져온 TaskAPI 통합에 대한 항목을 확인합니다. 항목은 구성이 필요함을 나타내지만 이 통합은 게시할 준비가 되어 있습니다.
-
https://github.com/syndesisio/syndesis-quickstarts/api-provider 로 이동하여
- TaskAPI 항목에서 를 클릭한 다음 편집을 클릭하여 이 API에서 제공하는 작업 목록을 표시합니다.
각 작업의 흐름을 검사하려면 다음을 수행합니다.
해당 흐름 편집 버튼을 클릭하여 해당 흐름에 대한 시각화를 표시합니다.
각 흐름에는 이미 데이터베이스 연결, 하나 이상의 데이터 매퍼 단계 및 흐름을 완료하는 Provided API 반환 단계가 있습니다.
- Invoke SQL 단계의 구성을 클릭하여 연결이 실행되는 SQL 문을 확인합니다. 그런 다음 취소 를 클릭하여 해당 작업의 시각화 흐름으로 돌아갑니다.
- 데이터 매퍼 단계의 경우 Configure (구성)를 클릭하여 매핑을 확인합니다. 그런 다음 취소 를 클릭하여 시각화로 돌아갑니다.
- 모든 작업 흐름의 마지막 단계인 Provided API return Path 단계의 경우 Configure 를 클릭하여 작업이 호출자에게 보낼 수 있는 HTTP 반환 코드를 확인합니다. 취소 를 클릭하여 시각화로 돌아갑니다.
- 하나의 작업 흐름을 검사한 후 Integrations> TaskAPI> Operation 드롭다운 메뉴를 클릭한 다음 다른 작업을 선택합니다.
- 이 단계의 하위 집합을 반복하여 각 흐름을 검사합니다.
흐름을 검사한 후 게시 를 클릭하고 원하는 경우 통합 이름을 편집한 다음 저장 및 게시 를 클릭합니다.
Fuse Online은 이 통합에 대한 요약 페이지를 표시하고 통합을 어셈블, 빌드, 배포 및 시작할 때 게시 진행 상황을 표시합니다.
TaskAPI 통합 요약 페이지에 실행 중이 표시되면 Fuse Online에 Task API 서비스의 외부 URL이 표시됩니다. 다음과 같습니다.
https://i-task-api-proj319352.6a63.fuse-ignite.openshiftapps.com/api/
여기에서 Fuse Online을 사용하면 Task API 서비스를 사용할 수 있습니다. REST API 호출은 이 기본 URL로 시작하는 URL을 지정합니다.
OpenShift Container Platform에서 Fuse Online을 사용하는 경우 외부 URL이 통합 요약 페이지에 없는 경우 관리자가 Red Hat 3scale 검색을 활성화했습니다. 즉, Red Hat 3scale은 통합 API에 대한 액세스를 제어하고 API 공급자 통합도 게시합니다. 통합을 테스트하려면 3scale 대시보드를 열어 통합의 URL을 가져옵니다.
Red Hat 3scale이 통합 API에 대한 액세스를 제어하지 않으려면 검색을 비활성화할 수 있습니다. 통합 요약 페이지를 확인하여 Fuse Online에서 이 작업을 수행합니다. 이 페이지에서 검색 비활성화 를 클릭합니다. Fuse Online에서 통합을 다시 게시하고 통합 실행을 호출하기 위한 외부 URL을 제공합니다.
각 API 공급자 통합에 대해 검색을 활성화하거나 비활성화할 수 있습니다.