8.6. 3scale OpenAPI 사용자 정의 리소스 배포

절차

1. OAS 문서가 포함된 보안을 정의합니다. 예를 들어 다음 콘텐츠를 사용하여 myoasdoc1.yaml 을 생성할 수 있습니다.

   openapi: "3.0.2"
   info:
     title: "some title"
     description: "some description"
     version: "1.0.0"
   paths:
     /pet:
       get:
         operationId: "getPet"
         responses:
           405:
             description: "invalid input"

2. 시크릿을 생성합니다. 예를 들어 다음과 같습니다.

   $ oc create secret generic myoasdoc1 --from-file myoasdoc1.yaml
   
   secret/myoasdoc1 created

3. OpenAPI CR을 정의합니다. OAS 문서가 포함된 보안에 대한 참조를 지정해야 합니다. 예를 들어 myopenapicr1.yaml 파일을 생성할 수 있습니다.

   apiVersion: capabilities.3scale.net/v1beta1
   kind: OpenAPI
   metadata:
     name: myopenapicr1
   spec:
     openapiRef:
       secretRef:
         name: myoasdoc1

4. 방금 정의한 리소스를 생성합니다. 예를 들어 다음과 같습니다.

   $ oc create -f myopenapicr1.yaml

   지정된 예제의 출력은 다음과 같습니다.

   openapi.capabilities.3scale.net/myopenapicr1 created

절차

1. OpenShift 계정에서 Operator > 설치된 Operator로 이동합니다.
2. 3scale Operator를 클릭합니다.
3. YAML 탭을 선택합니다.

4. OpenAPI 사용자 지정 리소스를 생성합니다. 예를 들어 다음과 같습니다.

   apiVersion: capabilities.3scale.net/v1beta1
   kind: OpenAPI
   metadata:
     name: openapi1
   spec:
     openapiRef:
       url: "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml"
     providerAccountRef:
       name: mytenant

5. 저장을 클릭합니다. 3scale Operator가 OpenAPI CR을 생성하는 데 몇 초가 걸립니다.

검증

1. OpenShift의 3scale 제품 개요 페이지에서 Synced 조건이 True 로 표시되는지 확인합니다.
2. 3scale 계정으로 이동합니다.
3. OAS 문서가 있는지 확인합니다. 위의 예에서는 openapi1 이라는 새 OAS 문서가 표시됩니다.