カスタムポリシーの開発

前提条件のインストールが終わったら、Flex Gateway ポリシー開発キット (PDK) を使用してカスタムポリシーを開発できます。

カスタムポリシーのライフサイクルは、PDK で実行するすべてのカスタムポリシー開発ステップで構成されます。下記の手順には、PDK の外部で実行され、すべての Flex Gateway ポリシーに共通するステップ (ポリシーの適用など) は含まれません。

新しいプロジェクトを作成した後は、いくつかのステップを繰り返し実行します。たとえば、ポリシーのソースコードを書いている間に一度戻ってパラメーターを追加したり、ソースコードをデバッグしてからポリシーを再コンパイルしたりする場合などです。

PDK でカスタムポリシーを作成する手順は、次のとおりです。

新しいプロジェクトを作成します。
スキーマ定義を作成します。

definition/gcl.yaml ファイルを修正して、カスタムポリシーのメタデータと設定パラメーターを定義します。
Rust でカスタムポリシー機能を設定します。

Rust のコード例を使用して、src/lib.rs ファイルでカスタムロジックを実装します。
カスタムポリシーをコンパイルします。

ポリシーをコンパイルすると、ポリシーを Exchange にアップロードして Flex Gateway にデプロイするために必要な WebAssembly バイナリファイルと設定ファイルが作成されます。
PDK デバッグプレイグラウンドでポリシーをデバッグします。

PDK に用意されているプレイグラウンドを使用して、カスタムポリシーの機能をローカルにデバッグします。
インテグレーションテストを作成します。

カスタムポリシーが他のサービスと互換性があることを確認し、新しいポリシーのバージョンごとに回帰エラーが発生しないことを確認するために、インテグレーションテストを作成します。
ポリシーを Exchange でパブリッシュします。

ポリシーを Exchange でパブリッシュし、Flex Gateway 設定でテストするためのポリシーのベータ版を配布します。ポリシーを Flex Gateway にデプロイするには、ステップ 9 を参照してください。
ポリシーを Exchange でリリースします。

Exchange でポリシーをリリースして、本番対応のポリシーを配布します。
カスタムポリシーを本番環境にデプロイするには、Flex Gateway にデプロイされている API インスタンスにポリシーを適用します。
ステップ 2 に戻って、この API インスタンスの新しいバージョンを設定します。