3.6. 使用操作器部署 APIcast 网关自助管理解决方案

流程

1. 创建一个包含 3scale 系统管理门户端点信息的 OpenShift secret：

   oc create secret generic ${SOME_SECRET_NAME} --from-literal=AdminPortalURL=${MY_3SCALE_URL}

   • ${SOME_SECRET_NAME} 是 secret 的名称，只要它与现有 secret 不冲突，可以是您想要的任何名称。

   • ${MY_3SCALE_URL} 是包含 3scale 访问令牌和 3scale 系统门户端点的 URI。如需了解更多详细信息，请参阅 THREESCALE_PORTAL_ENDPOINT

     示例

     oc create secret generic 3scaleportal --from-literal=AdminPortalURL=https://access-token@account-admin.3scale.net

     有关机密内容的更多信息，请参阅 管理门户配置 secret 参考。

2. 为 APIcast 创建 OpenShift 对象

   apiVersion: apps.3scale.net/v1alpha1
   kind: APIcast
   metadata:
     name: example-apicast
   spec:
     adminPortalCredentialsRef:
       name: SOME_SECRET_NAME

   spec.adminPortalCredentialsRef.name 必须是包含 3scale 系统管理门户端点信息的现有 OpenShift secret 的名称。

3. 确认与 APIcast 对象关联的 OpenShift Deployment 的 readyReplicas 字段是否为 1，以验证 APIcast 容器集正在运行并已就绪。或者，等待字段设置为：

   $ echo $(oc get deployment apicast-example-apicast -o jsonpath='{.status.readyReplicas}')
   1

流程

1. 使用配置文件创建 secret：

   $ curl https://raw.githubusercontent.com/3scale/APIcast/master/examples/configuration/echo.json -o $PWD/config.json
   
   oc create secret generic apicast-echo-api-conf-secret --from-file=$PWD/config.json

   配置文件必须名为 config.json。这是一个 APIcast CRD 引用 要求。

   有关机密内容的更多信息，请参阅 管理门户配置 secret 参考。

2. 创建 APIcast 自定义资源 ：

   $ cat my-echo-apicast.yaml
   apiVersion: apps.3scale.net/v1alpha1
   kind: APIcast
   metadata:
     name: my-echo-apicast
   spec:
     exposedHost:
       host: YOUR DOMAIN
     embeddedConfigurationSecretRef:
       name: apicast-echo-api-conf-secret
   
   $ oc apply -f my-echo-apicast.yaml

   1. 以下是嵌入式配置 secret 的示例：

      apiVersion: v1
      kind: Secret
      metadata:
        name: SOME_SECRET_NAME
      type: Opaque
      stringData:
        config.json: |
          {
            "services": [
              {
                "proxy": {
                  "policy_chain": [
                    { "name": "apicast.policy.upstream",
                      "configuration": {
                        "rules": [{
                          "regex": "/",
                          "url": "http://echo-api.3scale.net"
                        }]
                      }
                    }
                  ]
                }
              }
            ]
          }

3. 在创建 APIcast 对象时设置以下内容：

   apiVersion: apps.3scale.net/v1alpha1
   kind: APIcast
   metadata:
     name: example-apicast
   spec:
     embeddedConfigurationSecretRef:
       name: SOME_SECRET_NAME

   spec.embeddedConfigurationSecretRef.name 必须是包含网关配置的现有 OpenShift secret 的名称。

4. 确认与 APIcast 对象关联的 OpenShift Deployment 的 readyReplicas 字段是否为 1，以验证 APIcast 容器集正在运行并已就绪。或者，等待字段设置为：

   $ echo $(oc get deployment apicast-example-apicast -o jsonpath='{.status.readyReplicas}')
   1