8.9. 기능과 관련된 사용자 정의 리소스

• ApplicationPlans 맵핑 키 이름은 system_name 으로 사용됩니다. 아래 예에서 plan01 및 plan02.

절차

• 다음 예와 같이 새로운 3scale 제품에 애플리케이션 계획을 추가합니다.

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Product
  metadata:
    name: product1
  spec:
    name: "OperatedProduct 1"
    applicationPlans:
      plan01:
        name: "My Plan 01"
        setupFee: "14.56"
      plan02:
        name: "My Plan 02"
        trialPeriod: 3
        costMonth: 3

• period,value 및 metricMethodRef 는 필수 필드입니다.
• metricMethodRef 참조는 제품 또는 백엔드 참조일 수 있습니다. 선택적 backend 필드를 사용하여 백엔드 지표 소유자를 참조합니다.

절차

• 다음 예와 같이 3scale 제품의 애플리케이션 계획에 대한 제한을 정의합니다.

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Product
  metadata:
    name: product1
  spec:
    name: "OperatedProduct 1"
    metrics:
      hits:
        description: Number of API hits
        friendlyName: Hits
        unit: "hit"
    applicationPlans:
      plan01:
        name: "My Plan 01"
        limits:
          - period: month
            value: 300
            metricMethodRef:
              systemName: hits
              backend: backendA
          - period: week
            value: 100
            metricMethodRef:
              systemName: hits

• 에서 pricePerUnit 및 metricMethodRef 는 필수 필드입니다.
• 에서 및 에 대한 유효성을 검사합니다. 모든 규칙에 대해 의 값은 ~ 보다 작으며 동일한 지표의 겹치는 범위는 허용되지 않습니다.
• metricMethodRef 참조는 제품 또는 백엔드 참조일 수 있습니다. 선택적 backend 필드를 사용하여 백엔드 지표 소유자를 참조합니다.

절차

• 다음 예와 같이 3scale 제품의 애플리케이션 계획에 대한 가격 규칙을 정의합니다.

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Product
  metadata:
    name: product1
  spec:
    name: "OperatedProduct 1"
    metrics:
      hits:
        description: Number of API hits
        friendlyName: Hits
        unit: "hit"
    applicationPlans:
      plan01:
        name: "My Plan 01"
        pricingRules:
          - from: 1
            to: 100
            pricePerUnit: "15.45"
            metricMethodRef:
              systemName: hits
          - from: 1
            to: 300
            pricePerUnit: "15.45"
            metricMethodRef:
              systemName: hits
              backend: backendA

• issuerType: 타사 IdP와 통합할 때 Red Hat Single Sign-On(RH-SSO)과 나머지 가치를 사용할 때 keycloak 의 가치.
• issuerEndpoint: 이 파일에 필요한 자격 증명이 있는 URL입니다.

사전 요구 사항

• RH-SSO를 구성해야 합니다. Red Hat Single Sign-On 구성을 참조하십시오.
• 타사 ID 공급자와 HTTP 통합을 구성해야 합니다.

추가 리소스

• 제품 CRD 참조.

• 지표 맵 키 이름은 system_name 으로 사용됩니다. 아래 예에서는 metric01 및 hits 입니다.
• 지표 맵의 키 이름은 모든 지표 및 방법에서 고유해야 합니다.
• 단위 및 friendlyName 은 필수 필드입니다.
• hits 지표를 추가하지 않으면 운영자가 생성합니다.

절차

• 다음 예와 같이 새로운 3scale 백엔드에 제품 지표를 추가합니다.

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Product
  metadata:
    name: product1
  spec:
    name: "OperatedProduct 1"
    metrics:
      metric01:
        friendlyName: Metric01
        unit: "1"
      hits:
        description: Number of API hits
        friendlyName: Hits
        unit: "hit"

• 메서드 맵 키 이름은 system_name 으로 사용됩니다. 아래 예제에서는 다음을 수행합니다. Method01 및 Method02.
• 메서드 는 모든 지표 및 방법에서 키 이름을 매핑해야 합니다.
• friendlyName 은 필수 필드입니다.

절차

• 다음 예와 같이 새로운 3scale 제품에 메서드를 추가합니다.

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Product
  metadata:
    name: product1
  spec:
    name: "OperatedProduct 1"
    methods:
      method01:
        friendlyName: Method01
      method02:
        friendlyName: Method02

• httpMethod,패턴,increment 및 metricMethodRef 는 필수 필드입니다.
• metricMethodRef 에는 기존 지표 또는 메서드 맵 키 이름 system_name 에 대한 참조가 있습니다. 아래 예에서, hits.

절차

• 다음 예와 같이 새로운 3scale 백엔드에 제품 매핑 규칙을 추가합니다.

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Product
  metadata:
    name: product1
  spec:
    name: "OperatedProduct 1"
    metrics:
      hits:
        description: Number of API hits
        friendlyName: Hits
        unit: "hit"
    methods:
      method01:
        friendlyName: Method01
    mappingRules:
      - httpMethod: GET
        pattern: "/pets"
        increment: 1
        metricMethodRef: hits
      - httpMethod: GET
        pattern: "/cars"
        increment: 1
        metricMethodRef: method01

• path 는 필수 필드입니다.
• backendUsages 맵 키 이름은 백엔드의 system_name 에 대한 참조입니다. 아래 예제에서는 backendA 및 backendB 입니다.

절차

• 다음 예와 같이 제품에 백엔드를 추가하여 사용을 선언적으로 정의합니다.

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Product
  metadata:
    name: product1
  spec:
    name: "OperatedProduct 1"
    backendUsages:
      backendA:
        path: /A
      backendB:
        path: /B

• productId: 3scale 제품의 내부 식별자입니다.

• 조건: status.Conditions Kubernetes 공통 패턴을 나타냅니다. 다음과 같은 유형이 있습니다.

  • 실패: 동기화하는 동안 오류가 발생했습니다. 이 작업은 다시 시도합니다.
  • 동기화됨: 제품이 성공적으로 동기화되었습니다.
  • 잘못된: 올바르지 않은 객체입니다. 일시적인 오류는 아니지만 잘못된 사양에 대해 보고하고 변경해야 합니다. Operator는 다시 시도하지 않습니다.
  • 고아: 사양은 존재하지 않는 리소스를 참조합니다. Operator가 다시 시도합니다.
• observedGeneration: 최신 리소스 사양을 사용하여 상태 정보가 업데이트되었는지 확인합니다.
• state: 3scale 제품 내부 상태는 3scale API에서 읽습니다.
• providerAccountHost: 백엔드가 동기화되는 3scale 공급자 계정 URL입니다.