4.4. カスタム 3scale API Management APIcast ポリシー

手順

1. 3scale API Management Operator を使用してカスタムポリシーを挿入 します。
2. APIcast ゲートウェイをメインの OpenShift クラスターにデプロイしていない場合には、メインの OpenShift クラスター上の内部レジストリーへの アクセスを確立します。
3. 3scale 2.15 APIcast OpenShift テンプレートを ダウンロードします。

4. テンプレートを変更するには、デフォルトの image ディレクトリーを内部レジストリーの完全なイメージ名に置き換えます。

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

5. カスタマイズしたイメージを指定し、OpenShift テンプレートを使用して APIcast をデプロイします。

   $ oc new-app -f customizedApicast.yml

手順

1. カスタムポリシーが含まれるディレクトリーに、外部 Lua ライブラリーを識別するファイルを追加します。

   ファイルの名前は Roverfile である必要があります。JSON to 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 Operator が依存関係ライブラリーをフェッチできます。

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 ターゲットを指定します。

   たとえば、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)