mabl Linkを使用すると、mablクラウドからプライベートネットワーク内のアプリケーションに対してテストを実行できるほか、mablデスクトップアプリやmablエージェントでそのアプリケーションに対するテストを作成できます。Link Agentが接続されたら、テストトラフィックをそのトンネル経由で送信するようにワークスペースを設定します。
この記事では、次の方法について説明します。
- mabl Link経由でテストトラフィックをルーティングする
- 自分のコンピューター経由で実行をルーティングする
- Linkトンネル経由でテストをトレーニングする
- Linkトンネル経由でmablエージェントを使ってテストを作成する
- mabl Link経由でテストをローカル実行する
- mabl Link経由でのテストトラフィックのルーティングを停止する
- デプロイイベントでLinkトンネルをオーバーライドする
mabl Link経由でのテストトラフィックのルーティング
mabl Link経由で実行するようにテストを設定する前に、ネットワークページ (Settings > Networking) でLink Agentのステータスが接続済みになっていることを確認してください。接続済みのLink Agentが表示されない場合は、Link Agentのセットアップおよびmabl Linkの問題のトラブルシューティングを参照してください。
mabl Linkは環境レベルで設定します。Linkトンネルを環境に関連付けると、その環境で実行されるすべてのプランとテストのトラフィックがトンネル経由で送信されます。テスト環境の一部だけがプライベートな場合は、mabl Linkが必要なテスト専用の環境をmablに作成してください。
既存の環境にLinkを追加する
既存の環境でmabl Linkを使用するように設定するには、環境ページ (テスト環境設定 > 環境) に移動し、次の手順を実行します。
- mabl Linkで使用する環境を開きます。
- 編集用の鉛筆アイコンをクリックします。
- リンクエージェントを使用するチェックボックスをオンにします。
- リンクエージェントリストから1つ以上のトンネルを選択します。
- 設定を保存します。
mabl Link経由でのテストトラフィックのルーティング
このリストには、ワークスペース自身のトンネルに加えて、会社内のすべてのワークスペースで使用できる会社スコープのトンネルが表示されます。複数のトンネルを選択した場合、mablは各接続をいずれかのトンネル経由で送信し、最初のトンネルが宛先に到達できなければ別のトンネルを試します。
新しい環境にLinkを追加する
mabl Linkを使用する環境を作成するには、環境ページ (テスト環境設定 > 環境) に移動し、次の手順を実行します。
- ＋環境を追加をクリックします。
- 環境に名前を付けます。
- リンクエージェントを使用するチェックボックスをオンにします。
- リンクエージェントリストから1つ以上のトンネルを選択します。
- 設定を保存します。
データベース接続
データベースクエリでもLinkトンネルを使用できます。データベース接続にmabl リンクエージェントのオーバーライドを設定するか、mabl Linkを使用する環境でクエリを実行してください。詳しくは、プライベートデータベースへのクエリの実行を参照してください。
テスト出力内のmabl Link
mablクラウドでテストがmabl Link経由で実行される場合、URLはお使いのネットワーク内のLink Agentホストによって解決されます。テスト出力の冒頭には、その実行が使用するトンネルを示す行が表示されます。
Link tunnels: {tunnel-name}
Linkを有効にしたテスト実行やプラン実行に問題がある場合は、mabl Linkの問題のトラブルシューティングを参照して、問題の切り分け方法を確認してください。
自分のコンピューター経由での実行のルーティング
開発ビルドなど、自分のコンピューターからしか到達できない対象に対してクラウドテストを実行するには、個人Linkトンネル経由で実行をルーティングします。自分のコンピューターで個人トンネルを起動し、実行を開始するときにRoute test traffic through my computer（自分のコンピューター経由でテストトラフィックをルーティング）を選択します。
個人トンネルを使用する実行は、個人トンネルのみを経由します。その実行では、環境自身のLinkトンネルは使用されません。個人トンネルは、自分で開始するアドホックな実行を想定したものです。デプロイイベントやCI/CDパイプラインでは、ワークスペーストンネルまたは会社トンネルを使用してください。
Linkトンネル経由でのテストのトレーニング
mablデスクトップアプリでブラウザーテストをトレーニングする際、トレーニング用ブラウザーはLinkトンネル経由でアプリケーションに到達できます。別のネットワーク内にあるステージング環境など、自分のコンピューターからは到達できないプライベート環境に対してテストをトレーニングする場合に使用します。Linkトンネル経由のトレーニングは、Link 3.0で利用できます。
始める前に
- mablデスクトップアプリのバージョン2.71.0以降を使用してください。それより古いバージョンでは、更新を求めるメッセージが表示されます。
- ワークスペースに、Link 3.0で接続されたLink Agentを持つLinkトンネルが必要です。エージェントがレガシープロトコルのみを使用しているトンネルは一覧に表示されません。詳しくは、レガシーLinkからLink 3.0への移行を参照してください。
- 自分のロールがLinkトンネルへのアクセスを許可されている必要があります。この設定は、ワークスペースの所有者がSettings > Networking > Link tunnel accessで行います。詳しくは、Linkトンネルへのアクセスの制御を参照してください。
Linkトンネル経由でトレーニングする
- mablデスクトップアプリで、新しいブラウザーテストのトレーニングを開始するか、既存のテストを編集用に開きます。
- トレーニングの設定画面で、オプションの設定を展開します。
- mabl Linkセクションで、mabl Link トンネル経由でトレーニングを選択します。
- Link トンネルリストからトンネルを選択します。選択した環境がmabl Linkを使用している場合、リストの先頭にはその環境で最初に接続されているトンネルが表示されます。
- トレーナーを起動します。
トレーナーの起動中は、mabl Link に接続していますと表示されます。トレーナーが開くと、トレーニング用ブラウザーのトラフィックは、選択したトンネルのLink Agentが動作しているネットワークから送信されます。DNS名もそのネットワークで解決されるため、トレーナーはクラウド実行がそのトンネル経由で到達するのと同じホストに到達します。
トンネルは、トレーナーを起動するたびに選択します。mablはトンネルの選択をテストと一緒に保存しません。同じトンネル経由でテストをクラウドで実行するには、環境がmabl Linkを使用するように設定してください。
Linkトンネル経由のトレーニングは、ブラウザーテストに適用されます。モバイルのクラウドトレーニングでは、mabl Linkは利用できません。
トンネルが利用できない場合
| メッセージ | 対処方法 |
|---|---|
| No Link tunnel in this workspace has a connected agent to train through. | トンネルでLink Agentを起動するか、Settings > Networkingで既存のエージェントがLink 3.0で接続されていることを確認してください。 |
| This workspace's Link tunnel access does not include your role. | ワークスペースの所有者に、Settings > Networking > Link tunnel accessで自分のロールを追加してもらってください。 |
| Training over a mabl Link tunnel requires desktop app version 2.71.0 or later. | mablデスクトップアプリを更新してください。 |
Linkトンネル経由でのmablエージェントによるテストの作成
mablエージェントがクラウドでテストを作成または編集する際、そのセッションのブラウザートラフィックは、クラウド実行と同じように、選択した環境のLinkトンネル経由で送信されます。mabl Link経由でのテストトラフィックのルーティングで説明しているとおり、環境でmabl Linkをオンにし、少なくとも1つのLink Agentラベルを設定しておく必要があります。
環境を指定する場所は、セッションの開始方法によって異なります。
- Webアプリでは、Generateを選択する前に、プランニングチャットのTest informationセクションで環境を選択します。
- mabl MCPでは、クラウド作成ツールに環境を渡します。
- mabl CLIでは、クラウド作成コマンドに環境を渡します。
セッションの開始時に、環境のラベルを持つLink Agentが1つも接続されていない場合、エージェントはセッションにUnable to connect to Link tunnelと投稿し、mabl Linkなしで続行します。その後、ブラウザーがアプリケーションを読み込めない時点でセッションは失敗します。そのラベルのLink Agentを起動してから、セッションをもう一度開始してください。
mabl Link経由でのテストのローカル実行
mabl CLIでローカル実行するテストも、トラフィックをmabl Link経由で送信できます。これにより、自分のコンピューターから直接到達できないプライベート環境にローカル実行から到達できます。mabl tests runに--via-linkを追加します。
# Use the environment's Link tunnels
mabl tests run --id {test-id} --environment-id {environment-id} --via-link
# Use a specific tunnel instead
mabl tests run --id {test-id} --via-link --link-tunnel qa-env-01
--link-tunnelは繰り返し指定して複数のトンネルを使用できます。指定した場合、その実行では環境のトンネルの代わりに指定したトンネルが使用されます。mabl Link経由のローカル実行にはLink 3.0が必要です。また、CLIがAPIキーでサインインしている場合を除き、自分のロールがLinkトンネルアクセスで許可されている必要があります。
テスト環境でのmabl Linkの無効化
mabl Link経由でのテストトラフィックのルーティングを停止するには、環境でLinkをオフにします。
- mablアプリで環境ページに移動します：テスト環境設定 > 環境
- 更新する環境を開きます。
- 編集用の鉛筆アイコンをクリックして、環境の編集ページを開きます。
- リンクエージェントを使用するチェックボックスをオフにします。
- 設定を保存します。
これで、この環境で実行されるテストとプランは、mabl Link経由でテスト対象アプリケーションに接続しなくなります。アドレスの解決は、代わりにmablクラウドが行います。
デプロイイベントでのLink Agent名のオーバーライド
開発者がローカル開発環境に対してテストを行う必要がある場合など、シナリオによっては、環境が使用するトンネルを一時的にオーバーライドする必要があります。mablデプロイイベントを使用すると、別のトンネル名を渡すことで、環境に設定されているトンネルをオーバーライドできます。
デプロイイベントで使用するトンネルをオーバーライドするには、次のパラメーターをJSONリクエストボディに追加します。
"plan_overrides":{"link_agent_labels":["your-tunnel-name-here"]}
link_agent_labelsはトンネル名のリストです。単一の名前を指定するlink_agent_labelは非推奨となり、link_agent_labelsに置き換えられました。