4.4. 自定义 3scale API 管理 APIcast 策略

流程

1. 使用 3scale API 管理操作器注入自定义策略。
2. 如果您没有在 OpenShift 主集群中部署 APIcast 网关，请 建立对主 OpenShift 集群上的内部注册表的访问。
3. 下载 3scale 2.15 APIcast OpenShift 模板。

4. 要修改模板，请将默认 镜像 目录替换为内部注册表中的完整镜像名称。

   image: <registry>/<project>/amp-apicast:latest

5. 使用 OpenShift 模板部署 APIcast，并指定您的自定义镜像：

   $ oc new-app -f customizedApicast.yml

流程

1. 在包含自定义策略的目录中，添加一个可识别外部 Lua 库的文件。

   文件的名称必须是 Roverfile。在 JSON 到 XML 自定义 策略示例中，Roverfile 具有此内容：

   luarocks {
   	group 'production' {
   		module { 'xml2lua' },
   	}
   }

   lua-rover 是 LuaRocks 的一个打包程序。lua-rover 为依赖项提供传输锁定。LuaRocks 是 Lua 模块的软件包管理器。

2. 在包含自定义策略的目录中，添加一个 lua-rover 锁定文件。

   文件的名称必须是 Roverfile.lock。在 JSON to XML 自定义策略示例中，Roverfile.lock 具有此内容：

   xml2lua 1.5-2||productionbash-4.4

   Roverfile 和 Roverfile.lock 一起启用 APIcast 或 3scale 操作器来获取依赖的库。

3. 在定义自定义策略的文件中，添加一行来指定 Lua 依赖项。JSON to XML 自定义策略示例指定这一行：

   local xml2lua = require("xml2lua")

4. 在用于构建自定义策略的 Dockerfile 中，复制 Roverfile 和 Roverfile.lock，并运行 rover install。JSON to XML 自定义策略示例将以下行添加到其 Dockerfile 中：

   COPY Roverfile .
   COPY Roverfile.lock .
   
   RUN rover install --roverfile=/opt/app-root/src/Roverfile

   您的 Dockerfile 可以使用 APIcast 或 3scale operator 来构建策略。

5. 在自定义策略的 Makefile 中，指定任何自定义策略的 build 目标。

   例如，构建 目标可能类似如下：

   TARGET_IMAGE="apicast/json_to_xml:latest"
   # IP="http://localhost:8080"
   
   build:
   	docker build . --build-arg IMAGE=registry.redhat.io/3scale-amp2/apicast-gateway-rhel8:3scale2.15 -t $(TARGET_IMAGE)