プラグインを開発した後、コンソールのプラグインマーケットプレイスページでリリースすることでアップロードできます。現在のプライマリアカウントまたは AI Gateway の権限を持つ RAM ユーザーのみがプラグインを表示して使用できます。組み込みプラグインとアップロードされたプラグインは、同じ方法で有効になります。
手順
AI Gateway コンソールにログインします。
左側のナビゲーションウィンドウで、[プラグイン] を選択します。上部のナビゲーションバーで、リージョンを選択します。
[プラグインマーケットプレイス] ページの右上隅にある [プラグインのリリース] をクリックします。
[プラグインのリリース] パネルでプラグインパラメーターを設定し、[アップロード] をクリックして、プラグインがリリースされるのを待ちます (このプロセスには約 30 秒かかる場合があります)。
パラメーター
説明
言語の選択
プラグインの開発に使用されるプログラミング言語を選択します。
プラグイン ID
プラグインの ID を指定します。
プラグイン名
プラグインの名前を指定します。
プラグインの説明
プラグインの説明を入力します。このパラメーターを設定すると、説明がプラグインカードに表示されます。
バージョンの説明
プラグインのバージョンの説明を入力します。
WASM ファイル
オンプレミスマシンでコンパイルおよび作成されたプラグインのバイナリファイルをアップロードします。ファイル名拡張子は .wasm である必要があります。
実行ステージ
ステージの処理順序: 認証ステージ > 権限付与ステージ > 統計ステージ > デフォルトステージ。プラグインの実行が他のプラグインの実行順序に依存しない場合は、ドロップダウンリストから [デフォルト] を選択します。
実行優先度
指定されたステージでのプラグインの実行優先度を指定します。値が大きいほど、優先度が高くなります。値を指定する場合は、10 の整数倍を入力することをお勧めします。
互換性のあるゲートウェイバージョン
[任意のバージョン] または [指定されたバージョン] を選択します。
任意のバージョン: プラグインは、任意のバージョンのゲートウェイにインストールできます。
指定されたバージョン: プラグインは、指定されたバージョン以降のバージョンのゲートウェイにのみインストールできます。
プラグインとポリシーの優先度
次のプラグインとポリシーは、上から下に優先度の降順で実行されます。
名前 | タイプ | 実行ステージ | 優先度 | 備考 |
IP アドレスのブラックリストとホワイトリスト | ポリシー | RBAC フィルター | ||
http-real-ip | プラグイン | 認証ステージ | 980 | トラフィック管理プラグイン |
ModelRouter | プラグイン | 認証ステージ | 900 | AI-API 組み込み |
ModelMapper | プラグイン | 認証ステージ | 800 | AI-API 組み込み |
フロントエンドアプリケーションのカナリアリリース | プラグイン | 認証ステージ | 450 | 伝送プロトコルプラグイン |
geo-ip | プラグイン | 認証ステージ | 440 | 伝送プロトコルプラグイン |
DeGraphQL | プラグイン | 認証ステージ | 430 | 伝送プロトコルプラグイン |
ブラウザーキャッシュコントロール | プラグイン | 認証ステージ | 420 | 伝送プロトコルプラグイン |
リクエスト/応答の変換 | プラグイン | 認証ステージ | 410 | 伝送プロトコルプラグイン |
OAuth2 認証 | プラグイン | 認証ステージ | 350 | 認証および権限付与プラグイン |
JWT 認証 | プラグイン | 認証ステージ | 340 | 認証および権限付与プラグイン |
HMAC 認証 | プラグイン | 認証ステージ | 330 | 認証および権限付与プラグイン |
基本認証 | プラグイン | 認証ステージ | 320 | 認証および権限付与プラグイン |
キー認証 | プラグイン | 認証ステージ | 310 | 認証および権限付与プラグイン |
外部認証 | プラグイン | 認証ステージ | 300 | 認証および権限付与プラグイン |
OPA | プラグイン | 認証ステージ | 225 | 認証および権限付与プラグイン |
リクエスト検証 | プラグイン | 認証ステージ | 220 | 伝送プロトコルプラグイン |
IP 制限 | プラグイン | 認証ステージ | 210 | セキュリティ保護プラグイン |
JWT ログアウト | プラグイン | 認証ステージ | 50 | 認証および権限付与プラグイン |
一般的な応答キャッシュ | プラグイン | 認証ステージ | 10 | 伝送プロトコルプラグイン |
クロスオリジンリソース共有 | プラグイン | 権限付与ステージ | 340 | セキュリティ保護プラグイン |
WAF | プラグイン | 権限付与ステージ | 330 | セキュリティ保護プラグイン |
リクエストブロッキング | プラグイン | 権限付与ステージ | 320 | セキュリティ保護プラグイン |
ボットブロッキング | プラグイン | 権限付与ステージ | 310 | セキュリティ保護プラグイン |
ai-data-masking | プラグイン | デフォルトステージ | 991 | AI プラグイン |
ai-statistics | プラグイン | デフォルトステージ | 990 | AI プラグイン |
ai-security-guard | プラグイン | デフォルトステージ | 850 | AI プラグイン |
ai-cache | プラグイン | デフォルトステージ | 800 | AI プラグイン |
ai-quota | プラグイン | デフォルトステージ | 750 | AI プラグイン |
ai-intent | プラグイン | デフォルトステージ | 700 | AI プラグイン |
ai-history | プラグイン | デフォルトステージ | 650 | AI プラグイン |
ai-token-ratelimit | プラグイン | デフォルトステージ | 600 | AI プラグイン |
ai-prompt-template | プラグイン | デフォルトステージ | 500 | AI プラグイン |
ai-prompt-decorator | プラグイン | デフォルトステージ | 450 | AI プラグイン |
ai-network-search | プラグイン | デフォルトステージ | 440 | AI プラグイン |
ai-transformer | プラグイン | デフォルトステージ | 410 | AI プラグイン |
ai-rag | プラグイン | デフォルトステージ | 405 | AI プラグイン |
traffic-tag | プラグイン | デフォルトステージ | 400 | トラフィック管理プラグイン |
ai-json | プラグイン | デフォルトステージ | 150 | AI プラグイン |
ai-proxy | プラグイン | デフォルトステージ | 110 | AI プラグイン |
canary-header | プラグイン | デフォルトステージ | 100 | トラフィック管理プラグイン |
キーベースのクラスターレート制限 | プラグイン | デフォルトステージ | 20 | トラフィック管理プラグイン |
キーベースのレート制限 | プラグイン | デフォルトステージ | 10 | トラフィック管理プラグイン |
同時実行制御/トラフィックシェーピング/サーキットブレーキング | ポリシー | Sentinel フィルター | ||
タイムアウト/リトライ/トラフィックレプリケーション/ヘッダー変更/HTTP 再書き込み/クロスドメイン | ポリシー | ルーターフィルター |
よくある質問
プラグインのリリースが失敗する原因は何ですか。
ほとんどの場合、プラグインの .wasm ファイルのバイナリ形式が無効であるため、プラグインの公開に失敗します。ローカル環境で WASM ファイルを正常にロードするデモ例については、「Go を使用したゲートウェイプラグインの開発」をご参照ください。