5장. Fuse Online 공용 REST API 엔드포인트를 호출하는 방법

프로세스

1. 클러스터 관리 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

   oc login -u admin -p admin

   이 절차에서는 syndesis-operator grant 명령에만 클러스터 관리 권한이 필요하지만 클러스터 관리자가 모든 단계를 수행하는 것으로 가정합니다.

2. Fuse Online이 실행 중인 OpenShift 프로젝트로 전환합니다. 이 프로젝트에서만 공용 API를 노출하고 있습니다. 예를 들면 다음과 같습니다.

   oc project fuse-online-north

3. syndesis-public-oauthproxy 서비스 계정에 역할을 부여합니다. OpenShift 프로젝트에서는 이 서비스 계정을 사용하여 OAuth 프록시 서비스를 실행합니다. 클러스터 관리 권한이 있는 사용자 계정을 지정합니다. 예를 들면 다음과 같습니다.

   syndesis-operator grant --user developer

   이 명령은 클러스터 역할 및 클러스터 역할 바인딩을 syndesis-public-oauthproxy 서비스 계정에 생성하고 할당합니다. ClusterRoleBinding 은 이 예에서 fuse-online-north 인 API를 노출하는 OpenShift 프로젝트의 이름을 지정합니다.

   • ClusterRole: syndesis-auth-delegator
   • ClusterRoleBinding: syndesis-fuse-online-north-auth-delegator

4. 클라이언트 서비스 계정을 생성하고 Fuse Online 공용 API에 액세스할 수 있는 권한을 부여합니다.

   1. 원하는 이름으로 OpenShift 서비스 계정을 생성합니다. 예를 들어 다음 명령은 cicd-client 서비스 계정을 생성합니다.

      oc create serviceaccount cicd-client

      공용 API 엔드포인트를 호출하는 명령은 이 계정을 사용하여 공용 API에 액세스합니다. 또한 API 엔드포인트에 대한 호출에 지정해야 하는 시크릿 토큰을 얻으려면 이 서비스 계정이 필요합니다. 이는 REST API 엔드포인트를 호출하기 위한 시크릿 토큰을 가져오는 데 사용됩니다.

   2. 클라이언트 서비스 계정에 Fuse Online 공용 API에 액세스할 수 있는 권한을 부여합니다. fuse-online-north 가 Fuse Online이 설치된 OpenShift 프로젝트의 이름이며 cicd-client 가 API 서비스 액세스를 위해 생성한 서비스 계정의 이름이면 다음 명령을 호출합니다.

      oc policy add-role-to-user edit system:serviceaccount:fuse-online-north:cicd-client`

5. syndesis 사용자 정의 리소스를 편집합니다.

   1. 일반적으로 편집기에서 리소스를 여는 다음 명령을 호출합니다.

      oc edit syndesis

   2. 공용 API를 사용하도록 리소스를 편집하고 routeHostname 의 설정으로 엔드포인트를 호출하는 Fuse Online 환경의 공용 주소를 지정합니다. ( Fuse Online을 설치하는 데 사용된 default-cr.yml 파일을 편집하고 공용 API를 활성화하고 엔드포인트의 경로 호스트 이름을 지정한 경우 리소스를 편집할 필요가 없습니다.)

      클러스터 설정에 따라 지정해야 하는 공용 주소가 결정됩니다. 자세한 내용은 경로에 대한 OpenShift 설명서를 참조하십시오. 다음 예에서 경로 호스트 이름은 Minishift 클러스터에 유효합니다.

      spec:
        addons:
          publicApi:
            enabled: true
            routeHostname: public-syndesis.192.168.64.63.nip.io

   3. 리소스를 저장(또는 닫기)합니다.

      syndesis 사용자 정의 리소스 트리거를 저장하면 Fuse Online 설치를 담당하는 syndesis-operator 가 공용 API OAuth 프록시 서비스를 배포합니다.

      syndesis 사용자 정의 리소스를 편집할 필요가 없는 경우 공용 API OAuth 프록시 서비스가 이미 배포되었습니다. 이는 publicApi 가 활성화되고 Fuse Online을 설치하는 데 사용된 default-cr.yml 파일에 지정된 경로가 있기 때문일 수 있습니다.