29.2. 검색 가능한 서비스에 대한 기준
OpenShift(OCP) 클러스터에서 API 서비스를 3scale로 검색하려면 OCP 서비스가 아래 각 요소의 기준을 충족해야 합니다.
content-Type 헤더
API 사양의 Content-Type 헤더는 다음 값 중 하나여야 합니다.
-
application/swagger+json -
application/vnd.oai.openapi+json -
application/json
OpenShift Service Object YAML 정의
OpenShift Service Object YAML 정의에는 다음 메타데이터가 포함되어야 합니다.
-
discovery.3scale.net레이블: (필수) Set to "true". 3scale은 선택기 정의를 실행하여 검색이 필요한 모든 서비스를 찾을 때 이 라벨을 사용합니다. 다음 주석:
discovery.3scale.net/discovery-version: (선택 사항) 3scale 검색 프로세스의 버전입니다.discovery.3scale.net/scheme: (필수) 서비스가 호스팅되는 URL의 체계 부분입니다. 가능한 값은 "http" 또는 "https"입니다.discovery.3scale.net/port: (필수) 클러스터 내의 서비스의 포트 번호입니다.discovery.3scale.net/path: (선택 사항) 서비스가 호스팅되는 URL의 상대 기본 경로입니다. 경로가 root, "/"에 있는 경우 이 주석을 생략할 수 있습니다.discovery.3scale.net/description-path: 서비스에 대한 OpenAPI 서비스 설명 문서의 경로입니다.예를 들어 다음과 같습니다.
metadata: annotations: discovery.3scale.net/scheme: "https" discovery.3scale.net/port: '8081' discovery.3scale.net/path: "/api" discovery.3scale.net/description-path: "/api/openapi/json" labels: discovery.3scale.net: "true" name: i-task-api namespace: fuse관리 권한이 있는 OpenShift 사용자인 경우 OpenShift Console에서 API 서비스의 YAML 파일을 볼 수 있습니다.
- Applications > Services 를 선택합니다.
-
서비스를 선택하여 (예:
i-task-api)를 선택하여 세부 정보 페이지를 엽니다. - Actions> Edit YAML 을 선택하여 YAML 파일을 엽니다.
- 보기가 완료되면 취소를 선택합니다.
-
ovs-networkpolicy 플러그인이 있는 클러스터
-
OpenShift와 3scale 프로젝트 간 트래픽을 허용하려면
ovs-networkpolicy플러그인이 있는 클러스터에는 애플리케이션 프로젝트 내에 생성된 NetworkPolicy 오브젝트가 필요합니다. - NetworkPolicy 오브젝트 구성에 대한 자세한 내용은 네트워크 정책정보를 참조하십시오.