3.3. API에 대한 Fuse Online 및 3scale 검색 구성
API 공급자 통합을 생성하는 경우 Red Hat 3scale에서 해당 통합을 위해 API를 검색할 수 있습니다. 기본 동작은 3scale에서 자동 검색에 대해 API가 노출되지 않는다는 것입니다.
3scale 검색을 활성화하면 나중에 선택적으로 비활성화할 수 있습니다.
3.3.1. API 3scale 검색을 사용하도록 Fuse Online 구성
API 공급자 통합을 생성하는 경우 Red Hat 3scale에서 해당 통합을 위해 API를 검색할 수 있습니다. 기본 동작은 3scale에서 자동 검색에 대해 API가 노출되지 않는다는 것입니다. 검색을 활성화하면 3scale 사용자 인터페이스에 대한 URL을 제공해야 합니다.
Fuse Online을 설치하기 전에 API의 3scale 검색을 사용하도록 Fuse Online을 구성하려면 Fuse Online을 구성하는 사용자 지정 리소스 속성에 대한 설명을 참조하십시오.
설치 후 syndesis
사용자 정의 리소스를 업데이트하여 검색을 활성화할 수 있습니다. 이를 위한 지침은 이 주제에서 확인할 수 있습니다. 검색을 활성화하면 리소스를 업데이트할 때 연결된 OpenShift 프로젝트에만 적용됩니다.
3scale 서비스 검색을 활성화하면 다음을 의미합니다.
기본 동작은 3scale이 API 공급자 통합을 게시하는 것입니다. 3scale에서 API 공급자 통합을 게시하는 경우:
- Fuse Online에서는 실행 중인 API 공급자 통합을 위한 외부 URL을 제공하지 않습니다.
- API는 3scale에서만 액세스할 수 있습니다. 엔드포인트를 노출하려면 3scale의 구성이 필요합니다. 자세한 내용은 Red Hat 3scale API Management, Service Discovery 를 참조하십시오.
- API 공급자 통합 작성자는 해당 통합을 위해 3scale 검색을 비활성화할 수 있습니다. 즉, 각 API 공급자 통합 작성자는 통합의 API를 검색할 수 있는지 여부를 선택할 수 있습니다.
사전 요구 사항
- Fuse Online은 OCP 현장에 설치됩니다.
-
oc
클라이언트 툴이 설치되고 Fuse Online이 설치된 OCP 클러스터에 연결됩니다. - API 검색을 활성화하려는 프로젝트에 Fuse Online을 설치할 수 있는 권한이 있습니다.
- OpenShift 클러스터에서 3scale 프로젝트의 이름을 알고 있습니다.
프로세스
Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.
oc login -u developer -p developer
Fuse Online이 실행 중인 OpenShift 프로젝트로 전환합니다. 이 프로젝트에만 검색을 활성화할 수 있습니다. 예를 들면 다음과 같습니다.
oc project my-fuse-online-project
3scale 프로젝트에서 Fuse Online 통합을 볼 수 있는 권한을 추가합니다.
oc adm policy add-cluster-role-to-user view system:serviceaccount:<3scale-project>:amp
예를 들어 OpenShift의 3scale 프로젝트 이름이
my3scale
인 경우 다음과 같습니다.oc adm policy add-cluster-role-to-user view system:serviceaccount:my3scale:amp
syndesis
사용자 정의 리소스를 편집합니다.일반적으로 편집기에서 리소스를 여는 다음 명령을 호출합니다.
oc edit syndesis
managementUrlFor3scale
을 3scale 사용자 인터페이스의 URL로 설정하여 리소스를 편집합니다. 결과는 다음과 같습니다.spec: components: server: features: managementUrlFor3scale: https://3scale-admin.apps.mycluster.com
Copy to clipboardCopiedspec: components: server: features: managementUrlFor3scale: https://3scale-admin.apps.mycluster.com
- 리소스를 저장합니다.
선택 사항입니다. 전환한 프로젝트에 대해 검색이 켜져 있는지 확인하려면 다음 명령을 호출합니다.
oc describe dc/syndesis-server
discovery가 켜지면 이 명령의 출력은
OPENSHIFT_MANAGEMENT_URL_FOR3SCALE
환경 변수가 사용자 정의 리소스에서 지정한 URL로 설정되어 있음을 표시합니다.
결과
syndesis
사용자 정의 리소스 트리거의 변경으로 Fuse Online 설치를 담당하는 syndesis-operator
를 트리거하여 syndesis-server
를 재배포합니다. 전환한 OpenShift 프로젝트에서 새로운 기본 동작은 API가 3scale의 검색에 노출된다는 것입니다.
syndesis-server DeploymentConfig
오브젝트를 편집하여 OPENSHIFT_MANAGEMENT_URL_FOR3SCALE
환경 변수를 설정하지 마십시오. syndesis-operator
가 변경 사항을 되돌리기 때문에 이 작업이 작동하지 않습니다. syndesis-operator
는 Fuse Online이 syndesis
사용자 정의 리소스에 따라 배포되고 항상 배포되도록 합니다.
3.3.2. API의 3scale 검색을 비활성화하도록 Fuse Online 구성
API 의 3scale 검색을 활성화하기 위해 Fuse Online 구성에 설명된 절차를 수행한 경우 각 API 공급자 통합 작성자는 통합 API를 검색할 수 있는지 여부를 선택할 수 있습니다. 예를 들어 Fuse Online에서 API 공급자 통합을 편집하고 테스트하려는 경우 예를 들어 통합 API를 3scale에서 검색할 수 없는 기본 동작을 재구성할 수 있습니다. 이렇게 하려면 managementUrlFor3scale
키와 값을 지정하는 줄이 주석 처리되도록 Fuse Online syndesis
사용자 정의 리소스를 업데이트합니다. 이렇게 하면 3scale의 검색이 비활성화됩니다. 그런 다음 검색 가능한 API와 함께 게시된 API 공급자 통합을 다시 게시합니다.
사전 요구 사항
- Fuse Online은 OCP 현장에 설치됩니다.
- 검색을 비활성화하려는 프로젝트에 Fuse Online을 설치할 수 있는 권한이 있습니다.
-
oc
클라이언트 툴이 설치되고 Fuse Online이 설치된 OCP 클러스터에 연결됩니다. - API의 3scale 검색을 사용할 수 있도록 Fuse Online 구성에 설명된 대로 3scale 검색이 OpenShift 프로젝트에서 활성화되었습니다.
프로세스
Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.
oc login -u developer -p developer
3scale 검색이 활성화된 OpenShift 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.
oc project my-fuse-online-project
syndesis
사용자 정의 리소스를 편집합니다.일반적으로 편집기에서 리소스를 여는 다음 명령을 호출합니다.
oc edit syndesis
managementUrlFor3scale
키와 값을 지정하는 행 시작 부분에 해시 기호(#
)를 삽입하여 리소스를 편집합니다. 이렇게 하면 행이 주석으로 만들어 검색을 비활성화합니다. 결과는 다음과 같아야 합니다.spec: components: server: features: # managementUrlFor3scale: https://3scale-admin.apps.mycluster.com
Copy to clipboardCopiedspec: components: server: features: # managementUrlFor3scale: https://3scale-admin.apps.mycluster.com
리소스를 저장합니다.
이렇게 하면
syndesis
사용자 정의 리소스가 업데이트됩니다. 이번 업데이트에서는OPENSHIFT_MANAGEMENT_URL_FOR3SCALE
환경 변수가 제거됩니다.syndesis
사용자 정의 리소스 트리거의 변경으로 Fuse Online 설치를 담당하는syndesis-operator
를 트리거하여syndesis-server
를 재배포합니다. 새로운 기본 동작은 API가 더 이상 3scale의 검색에 노출되지 않는다는 것입니다.
syndesis-server DeploymentConfig
오브젝트를 편집하여OPENSHIFT_MANAGEMENT_URL_FOR3SCALE
환경 변수의 설정을 제거하지 마십시오.syndesis-operator
가 변경 사항을 되돌리기 때문에 이 작업이 작동하지 않습니다.syndesis-operator
는 Fuse Online이syndesis
사용자 정의 리소스에 따라 배포되고 항상 배포되도록 합니다.검색이 활성화되었으며 검색을 비활성화한 프로젝트에서 생성된 API 공급자 통합을 다시 게시합니다.
즉, API 공급자 통합이 생성된 프로젝트에 대해 검색을 활성화하는 동안 해당 통합 API 검색을 비활성화한 경우 API 공급자 통합을 다시 게시할 필요가 없습니다.
결과
관련 OpenShift 프로젝트에서 생성된 API 공급자 통합을 위한 API는 더 이상 3scale에서 검색할 수 없습니다.
Fuse Online에서 관련 프로젝트에 있는 API 공급자 통합을 게시(또는 다시 게시)할 때 Fuse Online은 API 공급자 통합 작업을 호출하기 위한 외부 URL을 제공합니다.