プラグインを開発した後、クラウドネイティブ API Gateway コンソールのプラグインページで、カスタムプラグインとしてプラグインをアップロードできます。アップロードしたプラグインは、Alibaba Cloud アカウントまたはクラウドネイティブゲートウェイに対する権限を持つ Resource Access Management (RAM) ユーザーの認証情報を使用して表示および使用できます。組み込みプラグインとアップロードされたプラグインは同じ方法で有効になります。
手順
API 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 | 送信 |
OAuth | プラグイン | 承認 | 350 | 認証 |
jwt-auth | プラグイン | 承認 | 340 | 認証 |
hmac-auth | プラグイン | 承認 | 330 | 認証 |
basic-auth | プラグイン | 承認 | 320 | 認証 |
キー認証 | プラグイン | 承認 | 310 | 認証 |
外部認証 | プラグイン | 承認 | 300 | 認証 |
OPA | プラグイン | 承認 | 225 | 認証 |
リクエスト検証 | プラグイン | 承認 | 220 | 送信 |
IP アドレス ブロック | プラグイン | 承認 | 210 | セキュリティ |
JWTログアウト | プラグイン | 承認 | 50 | 認証 |
一般的なレスポンスキャッシュ | プラグイン | 承認 | 10 | 送信 |
CORS | プラグイン | 認証 | 340 | セキュリティ |
WAF | プラグイン | 認証 | 330 | セキュリティ |
リクエストブロック | プラグイン | 認証 | 320 | セキュリティ |
bot-detect | プラグイン | 認証 | 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 履歴 | プラグイン | デフォルト | 650 | AI |
ai-token-ratelimit | プラグイン | デフォルト | 600 | AI |
AI プロンプト テンプレート | プラグイン | デフォルト | 500 | AI |
ai-prompt-decorator | プラグイン | デフォルト | 450 | AI |
ai-network-search | プラグイン | デフォルト | 440 | AI |
ai-transformer | プラグイン | デフォルト | 410 | AI |
ai-rag | プラグイン | デフォルト | 405 | AI |
トラフィックタグ | プラグイン | デフォルト | 400 | スロットリング |
ai-json | プラグイン | デフォルト | 150 | AI |
ai-proxy | プラグイン | デフォルト | 110 | AI |
カナリーヘッダー | プラグイン | デフォルト | 100 | スロットリング |
cluster-key-rate-limit | プラグイン | デフォルト | 20 | スロットリング |
キーレート制限 | プラグイン | デフォルト | 10 | スロットリング |
同時実行制御/速度制限/サーキットブレーカー | ポリシー | Sentinel フィルター | ||
タイムアウト/リトライ/トラフィック レプリケーション/ヘッダー変更/HTTP 再書き込み/CORS | ポリシー | ルータフィルタ |
よくある質問
プラグインの公開が失敗する原因は何ですか?
ほとんどの場合、プラグインの公開が失敗するのは、プラグインの .wasm ファイルが不正なバイナリ形式であることが原因です。 .wasm ファイルをオンプレミス環境にロードするデモについては、「Go でプラグインを開発する」をご参照ください。