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：这是一个帮助字段，用于确认状态信息已更新为最新的资源规格。

• backendUsages
• applicationPlans

前提条件

• 3scale 管理员权限或具有删除命名空间中具有删除权限的 OpenShift 角色，其中包含您要删除的 后端 CR。要识别谁可以删除特定的后端自定义资源，请运行 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