個人Linkトンネルは、クラウドのテスト実行を自分のコンピューター経由でルーティングします。これにより、mablクラウドで実行されるテストが、自分のマシン上の開発ビルドや、自分のコンピューターからしか到達できないサービスに到達できます。個人トンネルは自分専用です。他の人の実行がこのトンネルを経由することはなく、使用するために共有のLink Agentやトンネル名を用意する必要もありません。
個人トンネルは、デプロイ前のローカルの変更に対して、クラウド実行の完全な結果と診断情報を得ながらクラウドテストを実行する場合に使用します。個人トンネルは、Link 3.0で利用できます。
始める前に
- ワークスペースの所有者が、Settings > Networking > Link tunnel accessでAllow personal Link tunnels（個人Linkトンネルを許可）をオンにしている必要があります。詳しくは、Linkトンネルへのアクセスの制御を参照してください。
- 自分のコンピューターがサポートされているオペレーティングシステムを実行している必要があります。
- 自分のコンピューターが
api.mabl.comと、いずれかのLinkトンネルエンドポイントに到達できる必要があります。詳しくは、Link Agentの要件を参照してください。
個人トンネルを起動する
個人トンネルは、mablデスクトップアプリまたはmabl CLIから起動します。
mablデスクトップアプリから起動する
- mablデスクトップアプリにサインインします。
- mablアプリのメニューバーで、Edit > Link tunnelsに移動します。
- Personal tunnelsタブで、Personal tunnelの横にあるONをクリックします。
スイッチの下のステータスがOnと表示されたら、トンネルは準備完了です。その下のAgent detailsには、自分のコンピューターのエージェントが接続されていることと、ホストの健全性および接続品質の推移が表示されます。トンネルを停止するには、OFFをクリックします。デスクトップアプリからサインアウトした場合も、トンネルは停止します。
mabl CLIから起動する
自分のmablアカウントでサインインしてから、トンネルを起動します。
mabl auth login
mabl link-agents start --personal
個人トンネルは自分に属するため、サインイン済みのユーザーが必要です。APIキーでは起動できません。トンネルはCtrl-Cを押すまで実行され、停止前に処理中の接続が完了するのを待ちます。その他のオプションについては、mabl CLIでのLink Agentの実行を参照してください。
トンネルの名前について
個人トンネルは、自分で選んだ名前ではなく、コンピューターによって識別されます。複数のコンピューターで個人トンネルを起動した場合、それぞれが別のトンネルとなり、実行を開始するときにmablはコンピューターごとにトンネルを一覧表示します。
自分のコンピューター経由でテストを実行する
個人トンネルが1つ以上実行されている場合、手動でトリガーする実行のテストトラフィックを自分のコンピューター経由でルーティングできます。
- テスト実行の場合は、アドホック実行パネルでRoute test traffic through my computer（自分のコンピューター経由でテストトラフィックをルーティング）をオンにします。
- プラン実行の場合は、実行の横にあるドロップダウンを開いてプラン実行を構成を選択し、実行をトリガーする前にRoute test traffic through my computerをオンにします。
複数のコンピューターで個人トンネルを実行している場合、このオプションはRoute test traffic through my computersと表示され、リストが表示されます。1台のコンピューターを選択するか、All my machines（自分のすべてのマシン）を選択できます。All my machinesを選択すると、実行のトラフィックが実行中のすべての個人トンネルに分散されます。現在使用しているコンピューターには**(this computer)**と表示されます。
実行の開始時に個人トンネルがいずれも使用できない場合（トンネルが停止していた場合など）、実行は失敗せずに、環境の通常の経路で続行されます。
実行が個人トンネルを経由する場合、その実行は個人トンネルのみを使用します。環境自身のLinkトンネルはその実行では使用されないため、テストが行うすべてのリクエストは自分のコンピューターで解決され、送信されます。
アドホックなテスト専用
個人トンネルは、開発やテストの最中に自分で開始する実行を想定したものです。デプロイイベントやCI/CDパイプラインでは、常時稼働のLink Agentが提供するワークスペーストンネルまたは会社トンネルを使用してください。
自分のコンピューター上のサービスをテストする
個人トンネルを使用すると、クラウドテストは自分のコンピューターのlocalhostに到達できます。http://localhost:3000などのローカルURLをテストの対象に指定し、実行を自分のコンピューター経由でルーティングしてください。ブラウザーに関する詳細は、mabl Linkでのlocalhostのテストを参照してください。