3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Postmanのテスト実行オプションとそれぞれの実行場所 (ローカル or クラウド)と注意点について

Last updated at Posted at 2024-10-08

Postmanを活用したテストには複数の実行オプション(機能・サービス)があるが、実行オプションによってテスト実行場所(ローカル実行なのか、クラウド実行なのか、など)に違いがある。

次のイメージに、5種類のPostmanテスト実行オプションとそれぞれの実行場所とユースケースを整理している。

ブラウザアプリからの実行における例外
Postmanブラウザアプリ からリクエストを手動送信する場合、エージェントを指定することになるが、Cloudエージェント を選択した場合、例外的にPostmanクラウドを経由したリクエスト送信になる。
なお、デスクトップアプリの場合は、ローカル、すなわちアプリインスタンスの実行環境からのリクエスト送信となる。

テスト実行オプションと実行場所

(1) APIリクエスト1つずつ手動送信

PostmanアプリからのAPIリクエストを1つずつ手動実行するパターン。

Screenshot 2024-10-08 at 18.10.14.png

上述のとおり、ブラウザアプリからの実行で、クラウドエージェントを利用する場合は、例外的にPostmanクラウド経由のリクエスト送信となることに注意。

Screenshot 2024-10-08 at 18.10.38.png

(2) コレクションランナー(手動実行)

コレクションやフォルダーのAPIリクエスト群のテストをまとめて実行するコンポーネント。コレクションランナーには下記の実行タイプがあるが、Functionの手動実行とパフォーマンステストの場合はローカルからの実行となる。

  • Functional: 機能テスト(手動 or スケジュール実行)
  • Performance: パフォーマンステスト

ただし、上述のとおり、ブラウザアプリからの実行で、クラウドエージェントを利用する場合は、例外的にPostmanクラウド経由のリクエスト送信となることに注意。

Screenshot 2024-10-08 at 18.11.17.png

コレクションランナーについて詳しくはこちらのページが参考になる。

(3) コレクションランナー(スケジュール実行) / モニター

コレクションランナーのFunctionのスケジュール実行パターンにおいては、Postmanクラウドからの実行となる。

また、モニターという監視・観測用コンポーネントでもコレクションテストをスケジュール実行するが、これもPostmanクラウドからの実行となる。

Screenshot 2024-10-08 at 18.17.13.png

Screenshot 2024-10-08 at 18.19.05.png

モニターについて詳しくは下記ページが参考になる。

(4) Postman CLI / Newman

Postman CLI / Newmanいづれも、コマンドライン・インターフェースであり、シェルやプログラム実行、CI/CD などの継続的自動実行に活用される。これらはローカル、コマンドライン実行環境からのリクエスト送信となる。

newman-running-in-terminal.gif

Postmanのコマンドラインインターフェースのオプションについて詳しくはこちらのページが参考になる。

(5) Postman Flows

Postman Flowsでは、Deploy前のフローとDeploy後のフローでは実行箇所がことなる。

  • Deploy前のフロー:ローカル実行
  • Deploy後のフロー(Action) : Postmanクラウド実行

postman-flows-overview.gif

Postman Flowsについて詳しくはこちらのページが参考になる。

クラウド実行パターンで気をつける点

APIリクエスト送信元のIPアドレスレンジ(Postmanクラウドのレンジ)

PostmanクラウドからAPIリクエストが送信される場合、当然ながら送信元IPはPostmanクラウドのIPレンジのいづれかということになる。PostmanクラウドはAWS上に構築されているが、残念ながら特定の固定IPレンジでサービスを提供しているというわけではないので、もしどうしても固定のIPレンジで許可設定を行う必要がある場合は、広い範囲になるが、AWS IPアドレスレンジを許可いただく必要がある。これについて詳しくはこちらのページに詳細が書かれている。

この点について対象となるとは次の5つのシナリオである。

  • ブラウザアプリからの実行で、クラウドエージェントからのリクエスト送信
  • コレクションランナー(スケジュール実行) からの実行
  • モニターからの実行
  • コレクションのカスタムWebhookからの実行
  • DeployされたPostman Flowsのフロー実行

ただし、モニターについては例外があり、Postman Professional または Enterpriseプランをご利用の場合は、モニターは固定の静的IPをもつモニターがサポートされている。これについて詳しくは下記ページが参考になる。

3
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?