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


OpenAPI CR(사용자 정의 리소스)은 개발자 포털의 ActiveDocs에 사용할 수 있는 OAS(OpenAPI 사양) 문서를 가져오는 한 가지 방법입니다. OAS는 API에 특정 프로그래밍 언어를 사용하지 않는 표준입니다. 사용자와 컴퓨터는 소스 코드 액세스, 문서 또는 네트워크 트래픽 검사 없이 API 제품의 기능을 더 쉽게 이해할 수 있습니다.

사전 요구 사항

  • 3scale 2saas On-Premises 인스턴스에 대한 관리자 권한이 있는 사용자 계정입니다.
  • API를 정의하는 OAS 문서입니다.
  • OpenAPI CR을 테넌트에 연결하는 방법에 대한 이해.

3scale 백엔드 및 제품을 만들 수 있도록 OpenAPI CR(사용자 정의 리소스)을 배포합니다.

참고

운영자는 시크릿의 콘텐츠만 읽습니다. Operator는 시크릿에서 필드 이름을 읽지 않습니다.

사전 요구 사항

  • OpenAPI CRD를 포함할 네임스페이스에는 OpenAPI CRD가 연결되는 테넌트를 식별하는 보안이 포함되어 있습니다. 보안 이름은 다음 중 하나입니다.

    • threescale-provider-account
    • 사용자 정의

    이 시크릿에는 3scale SaaS의 URL과 해당 3scale SaaS의 테넌트에 액세스하기 위한 인증 정보가 포함된 토큰이 포함되어 있습니다.

절차

  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
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동