8.8. 기능과 관련된 백엔드 사용자 정의 리소스

• 메트릭 맵 키 이름은 system_name 으로 사용됩니다. 아래 예에서 metric01,metric02 가 에 도달합니다.
• 지표 맵 키 이름은 모든 메트릭 및 방법 간에 고유해야 합니다.
• 단위 및 friendlyName 은 필수 필드입니다.
• hits 지표를 추가하지 않으면 Operator가 이 지표를 생성합니다.

절차

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

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Backend
  metadata:
    name: backend-1
  spec:
    name: "My Backend Name"
    privateBaseURL: "https://api.example.com"
    metrics:
      metric01:
        friendlyName: Metric01
        unit: "1"
      metric02:
        friendlyName: Metric02
        unit: "1"
      hits:
        description: Number of API hits
        friendlyName: Hits
        unit: "hit

• 방법 맵 키 이름은 system_name 으로 사용됩니다. 아래 예제에서는 Method01 및 Method02.
• 맵 키 이름은 모든 메트릭 및 방법 간에 고유해야 합니다.
• FriendlyName 은 필수 필드입니다.

절차

• 다음 예와 같이 새 3scale 백엔드에 백엔드 메서드를 추가합니다.

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Backend
  metadata:
    name: backend-1
  spec:
    name: "My Backend Name"
    privateBaseURL: "https://api.example.com"
    methods:
      method01:
        friendlyName: Method01
      method02:
        friendlyName: Method02

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

절차

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

  apiVersion: capabilities.3scale.net/v1beta1
  kind: Backend
  metadata:
    name: backend-1
  spec:
    name: "My Backend Name"
    privateBaseURL: "https://api.example.com"
    mappingRules:
      - httpMethod: GET
        pattern: "/pets"
        increment: 1
        metricMethodRef: hits
      - httpMethod: GET
        pattern: "/pets/id"
        increment: 1
        metricMethodRef: hits
    metrics:
      hits:
        description: Number of API hits
        friendlyName: Hits
        unit: "hit"

• backendId: 3scale 백엔드의 내부 식별자입니다.

• conditions: status.Conditions Kubernetes 일반적인 패턴을 나타냅니다. 이러한 유형 또는 상태:

  • invalid: BackendSpec 의 구성 조합이 지원되지 않습니다. 이는 일시적인 오류가 아니지만 진행하기 전에 해결해야 하는 상태를 나타냅니다.
  • synced: 백엔드가 성공적으로 동기화되었습니다.
  • 실패: 동기화 중 오류가 발생했습니다.
• observedGeneration: 상태 정보가 최신 리소스 사양으로 업데이트되었는지 확인하는 도우미 필드입니다.

• backendUsages
• applicationPlans

사전 요구 사항

• 3scale 관리자 권한 또는 삭제하려는 백엔드 CR이 포함된 네임스페이스에서 삭제 권한이 있는 OpenShift 역할. 특정 백엔드 사용자 정의 리소스를 삭제할 수 있는 사용자를 확인하려면 oc policy who-can delete 명령을 실행합니다. 예를 들어 CR의 이름이 mybackend 이면 다음 명령을 실행합니다.

  oc policy who-can delete product.capabilities.3scale.net/mybackend

• 백엔드 CR을 사용하여 유효한 테넌트에 대한 링크를 삭제합니다.

절차

• oc delete 명령을 실행하여 백엔드 사용자 정의 리소스 를 삭제합니다. 예를 들어 mybackend.yaml 파일에 정의된 백엔드를 배포한 경우 다음 명령을 실행합니다.

  oc delete -f mybackend.yaml

  또는 oc delete 명령을 실행하고 정의에 지정된 대로 백엔드의 이름을 지정할 수 있습니다. 예를 들어 다음과 같습니다.

  oc delete backend.capabilities.3scale.net/mybackend