8.8. 与功能相关的后端自定义资源

• metrics 映射键名称将用作 system_name。在以下示例中： metric01、metric02 和 hits。
• 在所有指标和方法中，指标 metrics 键名称都必须是唯一的。
• unit 和 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

• 映射键名称的methods 将用作 system_name。在以下示例中：Method01 和 Method02.
• 在所有指标和方法中，methods 映射键名称必须是唯一的。
• 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, pattern, increment 和 metricMethodRef 是必填字段。
• metricMethodRef 包含对现有指标或方法映射键名称 system_name 的引用。在以下示例中，hits。

流程

• 将后端映射规则添加到新的 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:后端已成功同步。
  • Failed:同步过程中出现错误。
• observedGeneration:这是一个帮助字段，用于确认状态信息已更新为最新的资源规格。