Red Hat Summit1장. 개요
Red Hat Fuse on OpenShift는 API 서비스에 대한 벤더 중립 및 이식 가능한 오픈 설명 형식인 OpenAPI 2.0 사양을 준수하는 REST API 를 설계하는 데 사용할 수 있는 웹 기반 API 편집기인 API Policy를 제공합니다. API Cryostat는 Apicurio Studio 오픈 소스 프로젝트(https://www.apicur.io/)의 "조명" 버전입니다. 즉, API Builder 세션은 상태 비저장이며 각 세션이 끝나면 API 정의를 JSON 파일로 저장해야 합니다.
API window를 사용하여 REST API 정의를 기반으로 사전 Fuse 프로젝트를 생성할 수도 있습니다. 그런 다음 Fuse 개발 환경에서 프로젝트의 Camel 경로를 완료하고 프로젝트를 빌드할 수 있습니다. 마지막으로 OpenShift에서 Fuse에 결과 REST 서비스를 배포할 수 있습니다.
다음은 API Cryostat를 사용하여 Fuse on OpenShift 애플리케이션 솔루션에 REST API를 통합하는 방법에 대한 개요입니다.
- OpenShift 프로젝트에 API Cryostat를 서비스로 추가합니다.
API desktop에서 다음을 수행합니다.
- API Cryostat를 사용하여 API 정의를 만듭니다. REST API 정의를 JSON 파일로 로컬 파일 시스템에 저장합니다. API 정의가 완료되지 않은 경우에도 편집 세션 중 언제든지 API 정의를 저장할 수 있습니다.
- API Cryostat에 API 정의를 업로드합니다.
- 현재 REST API 정의를 기반으로 Fuse Camel 프로젝트를 생성합니다. API Cryostat는 전체 Maven 프로젝트가 포함된 다운로드 가능한 zip 파일을 제공합니다.
- Fuse 개발 환경에서 생성된 Fuse 프로젝트에서 제공하는 스케일톤 구현을 완료합니다.
- Fuse 애플리케이션을 빌드하고 OpenShift에 배포합니다.
- (선택 사항) 3scale 서비스 검색 기능을 사용하여 Fuse 애플리케이션을 Red Hat 3scale API Management와 통합하여 Fuse 애플리케이션을 찾고 구성합니다.
1.1. OpenShift 프로젝트에 API Builder를 서비스로 추가
OpenShift 서비스 카탈로그에서 OpenShift 프로젝트에 API Builder를 서비스로 추가할 수 있습니다. OpenShift 환경 외부의 URL에서 이 인스턴스에 액세스할 수 있습니다.
사전 요구 사항
- OpenShift 시스템 관리자가 권장하는 지침에 따라 API Builder에 액세스할 수 있는 호스트 이름을 가져옵니다.
명령 창에서 다음 명령을 실행하여
apidesigner-ui및fuse-apidesigner-generator를 포함한 OpenShift 이미지 및 템플릿의 Fuse가 OpenShift 클러스터에 설치되어 있는지 확인합니다.oc get is -n openshift
이미지 및 템플릿이 사전 설치되지 않았거나 제공된 버전이 최신 버전이 아닌 경우 OpenShift 이미지 및 템플릿에 Fuse를 설치(또는 업데이트)하여 OpenShift 가이드 의 Fuse에 설명된 대로 설치(또는 업데이트)합니다.
절차
OpenShift 프로젝트에 API Builder를 서비스로 추가하려면 다음을 수행합니다.
명령 창에서 OpenShift 서버에 로그인합니다.
oc login -u developer -p developer
새 프로젝트 네임스페이스를 생성합니다. 예를 들어 다음 명령은 test 라는 새 프로젝트를 생성합니다.
oc new-project test
-
웹 브라우저에서 OpenShift 콘솔을 열고 자격 증명(예: 사용자 이름
developer및 암호developer)을 사용하여 로그인합니다. 카탈로그 를 클릭합니다. Catalog(카탈로그 검색) 필드에
API Cryostat를입력한 다음 Red Hat Fuse API Creator를 선택합니다.Red Hat Fuse API Splunk 마법사의 정보 단계가 열립니다.
다음을 클릭합니다.
Red Hat Fuse API Splunk 마법사의 구성 단계가 열립니다.
-
이미지 스트림 네임스페이스 필드에
openshift를 입력합니다. -
ROUTE_HOSTNAME 필드에 API Splunk 인스턴스에 액세스할 수 있는 외부 호스트 이름(예:
apidesigner-myproject.192.168.64.43.nip.io)을 입력합니다. 구성 단계에서 나머지 설정의 기본값을 수락하고 생성 을 클릭합니다.
템플릿 마법사의 결과 단계가 열립니다.
- 닫기를 클릭합니다.
OpenShift 웹 콘솔의 내 프로젝트 창에서 프로젝트를 선택합니다(예: test ).
프로젝트의 개요 탭이 열리고 apidesigner-ui 애플리케이션이 표시됩니다.
- apidesigner-ui 배포의 왼쪽에 있는 화살표를 클릭하여 배포 세부 정보를 확장하고 확인합니다.
API Creator 인스턴스의 링크를 클릭합니다(예:
https://apidesigner-myproject.192.168.64.43.nip.io).API Splunk가 새 웹 브라우저 창 또는 탭에서 열립니다.
API Splunk 인스턴스를 열 수 없는 경우 다음 구문을 사용하여 ROUTE_HOSTNAME을 추가하도록 컴퓨터의 /etc/hosts 파일을 편집해야 할 수 있습니다. 여기서 $OPENSHIFT_IP_ADDR 은 OpenShift 서버의 IP 주소이고 apidesigner.my-minishift.apicurio.io 는 7 단계에서 지정한 ROUTE_HOSTNAME입니다.
$OPENSHIFT_IP_ADDR apidesigner.my-minishift.apicurio.io
