6.5. 예제 API 공급자 빠른 시작 통합 가져오기 및 게시
Fuse Online에서는 Fuse Online 환경으로 가져올 수 있는 빠른 시작 API 공급자를 제공합니다. 이 빠른 시작에는 작업 관리 API를 위한 OpenAPI 문서가 포함되어 있습니다. 빠른 시작 통합을 가져온 후 흐름을 검사한 다음 통합을 게시할 수 있습니다. 아래에 설명된 절차를 완료하면 TaskAPI 통합이 실행 중이며 실행될 준비가 된 것입니다.
API 공급자 빠른 시작 기능을 사용하면 API 공급자 통합을 구성, 게시 및 테스트하는 방법을 빠르게 확인할 수 있습니다. 그러나 이는 API 공급자 통합이 얼마나 유용할 수 있는지에 대한 실제 사례가 아닙니다. 실제 예제의 경우 이미 Fuse Online을 사용하여 몇 가지 간단한 통합을 게시한다고 가정합니다. 이러한 통합 실행을 트리거하기 위해 OpenAPI 문서를 정의할 수 있습니다. 이를 위해 각 OpenAPI 작업의 흐름을 편집하여 이미 게시한 간단한 통합과 거의 동일합니다.
사전 요구 사항
- Fuse Online은 브라우저에서 열려 있습니다.
절차
TaskAPI 빠른 시작 통합을 가져옵니다.
-
https://github.com/syndesisio/syndesis-quickstarts/tree/1.8/api-provider 로 이동하여
TaskAPI-export.zip을 다운로드합니다. - Fuse Online의 왼쪽 탐색 패널에서 통합을 클릭합니다.
- 오른쪽 상단에서 가져오기 를 클릭합니다.
-
다운로드한
TaskAPI-export.zip파일을 가져오기 페이지로 끕니다. Fuse Online은 파일을 가져왔음을 나타냅니다. - 왼쪽 탐색 패널에서 통합을 클릭하여 방금 가져온 TaskAPI 통합에 대한 항목을 확인합니다. 항목은 구성이 필요함을 나타내지만 이 통합은 게시할 준비가 되어 있습니다.
-
https://github.com/syndesisio/syndesis-quickstarts/tree/1.8/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이 통합 요약 페이지에 없는 경우 관리자는
OPENSHIFT_MANAGEMENT_URL_FOR3SCALE환경 변수를 설정했습니다. 이 환경 변수가 설정되면 Red Hat 3scale이 API 공급자 통합을 게시합니다. 즉 3scale이 통합 API에 대한 액세스를 제어합니다. 통합을 테스트하려면 3scale 대시보드를 열어 통합의 URL을 가져옵니다.Red Hat 3scale이 통합 API에 대한 액세스를 제어하지 않으려면 검색을 비활성화할 수 있습니다. 통합 요약 페이지를 확인하여 Fuse Online에서 이 작업을 수행합니다. 이 페이지에서 검색 비활성화 를 클릭합니다. Fuse Online에서 통합을 다시 게시하고 통합 실행을 호출하기 위한 외부 URL을 제공합니다.
각 API 공급자 통합에 대해 검색을 활성화하거나 비활성화할 수 있습니다.