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"

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc create -f myopenapicr1.yaml

   Copy to Clipboard Toggle word wrap

   주어진 예에서 출력은 다음과 같습니다.

   openapi.capabilities.3scale.net/myopenapicr1 created

   Copy to Clipboard Toggle word wrap

절차

1. OpenShift 계정에서 Operator > 설치된 운영자로 이동합니다.
2. 3scale 연산자를 클릭합니다.
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

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

검증

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