8.7. 部署 3scale ActiveDoc 自定义资源

流程

1. 创建 secret.例如：

   $ oc create secret generic myoasdoc1 --from-file myoasdoc1.yaml
   
   secret/myoasdoc1 created

   Copy to Clipboard Toggle word wrap

2. 定义 ActiveDoc CR。确保指定包含 OAS 文档的 secret 的引用。例如，您可以创建 myactivedoccr1.yaml 文件：

   apiVersion: capabilities.3scale.net/v1beta1
   kind: ActiveDoc
   metadata:
     name: myactivedoccr1
   spec:
     name: "Operated ActiveDoc From secret"
     activeDocOpenAPIRef:
       secretRef:
         name: myoasdoc1

   Copy to Clipboard Toggle word wrap

3. 创建您刚刚定义的资源。例如：

   $ oc create -f myactivedoccr1.yaml

   Copy to Clipboard Toggle word wrap

   对于给定示例，输出为：

   activedoc.capabilities.3scale.net/myactivedoccr1 created

   Copy to Clipboard Toggle word wrap

验证

1. 登录您的 Red Hat OpenShift Container Platform (OCP)管理员帐户。
2. 导航到 Operators > Installed Operators。
3. 点 Red Hat Integration - 3scale。
4. 点 Active Doc 选项卡。
5. 确认存在 OAS 文档。请参考上面的示例，您会看到一个名为 myactivedoccr1 的新 OAS 文档。

流程

1. 在 OpenShift 帐户中，进入到 Operators > Installed operators。
2. 点 3scale operator。
3. 点 Active Doc 选项卡。

4. 创建 ActiveDoc CR。例如：

   apiVersion: capabilities.3scale.net/v1beta1
   kind: ActiveDoc
   metadata:
     name: myactivedoccr1
   spec:
     openapiRef:
       url: "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml"
     providerAccountRef:
       name: mytenant

   Copy to Clipboard Toggle word wrap

5. 可选。对于 self-managed APIcast，在 ActiveDoc CR 中，将 productionPublicBaseURL 和 stagingPublicBaseURL 字段设置为部署的 URL。例如：

   apiVersion: capabilities.3scale.net/v1beta1
   kind: ActiveDoc
   metadata:
     name: myactivedoccr1
   spec:
     openapiRef:
       url: "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml"
     productionPublicBaseURL: "https://production.my-gateway.example.com"
     stagingPublicBaseURL: "https://staging.my-gateway.example.com"

   Copy to Clipboard Toggle word wrap
6. 点 Save。3scale Operator 创建 ActiveDoc CR 需要几秒钟。

验证

1. 登录您的 Red Hat OpenShift Container Platform (OCP)管理员帐户。
2. 导航到 Operators > Installed Operators。
3. 点 Red Hat Integration 3scale。
4. 点 Active Doc 选项卡。
5. 确认存在 OAS 文档。请参考上面的示例，您会看到一个名为 myactivedoccr1 的新 OAS 文档。