1.11. バックエンドのインテグレーションをテストするためのプロダクトへのリクエスト送信
3scale API プロバイダーは、プロダクトにコマンドラインリクエストを送信して、プロダクトに追加した最初のマッピングルールに基づき、バックエンドのインテグレーションをテストすることができます。
テストリクエストを送信するには、テストするバックエンドが含まれる APIcast 設定をプロモートする必要があります。実際の APIcast 設定は、プロダクトに追加したバックエンド、ならびに対応するマッピングルール、アプリケーション、およびアプリケーションプランで設定されます。
3scale は、リクエストの呼び出しで指定したパスに従って、リクエストをプロダクトのバックエンドに送付します。バックエンドをプロダクトに追加する際に、プロダクトのバックエンドごとに バックエンドパス を設定します。言い換えると、それぞれのバックエンドは固有のパスを持ちます。
前提条件
- プロダクトに追加された 1 つまたは複数の バックエンド
- プロダクトに追加された各バックエンドの マッピングルール
- アクセスポリシーを定義するための アプリケーションプラン
- アプリケーションプランを参照する アプリケーション
手順
新しい APIcast 設定をステージング環境にプロモートします。
- [Your_product_name] > Integration > Configuration の順に移動します。
APIcast Configuration セクションで、Promote v.[n] to Staging APIcast をクリックします。
- v.[n] は、プロモート先のバージョン番号を表します。
- プロモートする変更がなければ、Nothing to promote のテキストと共にボタンがグレーアウト表示されます。
Staging APIcast セクションで、Promote v.[n] to Production APIcast をクリックして APIcast 設定を実稼働環境にプロモートします。
- v.[n] は、プロモート先のバージョン番号を表します。
- プロモートする変更がなければ、Nothing to promote のテキストと共にボタンがグレーアウト表示されます。
API プロダクトへのリクエストをテストするには、Example curl for testing に記載のコマンドをコピーして、ターミナルで実行します。
-
curl
コマンドの例は、プロダクトの最初のマッピングルールに基づいています。 - コマンドを実行すると、テスト中のバックエンドからの結果が含まれる HTML レスポンスが返されるはずです。
-
レスポンスが返されない場合は、プロダクトからキャッチオールマッピングルールを削除し、新しい APIcast 設定をステージング、続いて実稼働環境にプロモートし、
curl
のサンプルコマンドを実行します。
-
次のステップ
上限や課金ルールなどのメトリクスおよびメソッドを変更すると、レスポンスが異なることを確認することができます。プロダクトのすべてのアプリケーションプランに関して、プロダクトへのリクエストをテストする際には、メソッドおよびメトリクスを変更します。詳細は、使用状況の詳細を把握するためのメソッドの指定およびメトリクスの追加 を参照してください。
プロダクトの設定を変更したら、API への呼び出しを行う前に、更新した設定を必ずステージング環境および実稼働環境にプロモートする必要があります。ステージング環境にプロモートする保留中の変更がある場合には、管理ポータルの Integration メニュー項目の横に感嘆符が表示されます。