メインコンテンツへスキップ

Link Agentのセットアップ

Molly Exten
  • 更新

mabl Linkを使用すると、ステージングやlocalhostなどの組織内の環境に対してmablクラウドからテストを実行できます。この記事では、ネットワークとmablクラウドの間にセキュアトンネルを確立するアプリケーションである、mabl Link Agentをインストールして実行する方法について説明します。

開始する前に

Link Agentのインストール先を決定してください。テスト対象のアプリケーションに到達できる、ネットワーク内の常時稼働のサーバーまたはVMをお勧めします。Link Agentの要件を満たしていることを確認し、割り当てるCPUとメモリの量についてはLink Agentのサイジングとスケーリングを参照してください。

自分のクラウド実行を自分のコンピューター経由でルーティングするだけであれば、何もインストールする必要はなく、キーを作成する必要もありません。代わりに、mablデスクトップアプリまたはmabl CLIから個人Linkトンネルを開始してください。

Link Agentには "Link Agent" のAPIキーが必要です。このキーによって、トンネルの所有者が決まります。

  • ワークスペースキーは、そのワークスペースだけが使用できるトンネルを作成します。作成するには、Settings > APIsに移動し、[+ APIキーを作成] をクリックして、タイプに [リンクエージェント] を選択し、キーに名前を付けます。APIキーを作成できるのはワークスペースの所有者だけです。
  • 会社キーは、会社内のすべてのワークスペースが使用できるトンネルを作成します。会社キーは、アカウント管理者が会社ダッシュボードで作成します。会社スコープのLinkトンネルを参照してください。

Link Agentは、テスト対象のアプリケーションに到達できるマシンにインストールします。ホストに合ったインストール方法を選択してください。

ホスト インストール方法
Windows Windowsインストーラーは、独自のJavaランタイムを含むLink AgentをWindowsサービスとしてインストールし、インストール中にトンネルとプロキシの設定を尋ねます。
LinuxまたはmacOS LinuxおよびmacOSインストーラーは、起動時に開始されるサービスとしてLink Agentをインストールし、インストール中にトンネルとプロキシの設定を尋ねます。
コンテナープラットフォーム Dockerイメージには、Link Agentに必要なものがすべて含まれています。Kubernetesについては、Kubernetesでmabl Linkを実行を参照してください。
mabl CLIがインストールされたコンピューター Javaなしでmabl CLIからLink Agentを実行します。mabl Linkを試す場合や、短期間だけ使用するトンネルに最適です。

インストーラーは、Link Agentをオペレーティングシステムのサービスマネージャーに登録するため、起動時に開始され、停止した場合は再起動されます。追加の作業なしでLink Agentを実行し続けることができます。

アーカイブからのインストール

サービスとしてではなくLink Agentを実行するには、Settings > Networkingからzipまたはtar.bz2アーカイブをダウンロードしてホストにコピーし、展開します。

# Extract the tar.bz2 archive:
tar xjf link-agent.tbz2

# Or extract the zip archive:
unzip link-agent.zip

アーカイブからLink Agentを実行するには、Java 11以降が必要です。後でサービスとしてインストールすることにした場合に備えて、アーカイブにはLinuxおよびmacOSインストーラーのinstall.shも含まれています。

インストーラーは、インストール中にトンネルの設定を尋ね、Link Agentを自動的に起動します。アーカイブから実行するには、展開したディレクトリでターミナルを開き、APIキーとトンネル名を指定して起動します。

  • APIキー: ステップ1で取得した "Link Agent" のAPIキー。
  • 名前: 英小文字、数字、ダッシュから成る1～24文字のトンネル名。正規表現の^[a-z0-9-]{1,24}$に一致する必要があります。
# Run the Link Agent in the foreground
bin/link-agent --api-key {your-api-key} --name qa-env-01

# Run the Link Agent with a configuration file
bin/link-agent --config /path/to/config.yaml

設定ファイルの使用

Link Agent設定ファイルを使用すると、APIキーをコマンドラインに含めずに済み、1つのエージェントで複数のトンネルにサービスを提供できます。Link Agentは実行中に設定ファイルを監視するため、再起動せずにトンネルの追加や削除、プロキシ設定の変更を行えます。監視を無効にするには、--no-config-reloadを指定してエージェントを起動します。

同じ名前でエージェントを起動し続ける限り、トンネルは同じIDを保持します。同じ名前の複数のエージェントは、そのトンネルのトラフィックを分担します。高可用性設定を参照してください。

HTTPフォワードプロキシのサポート

ネットワークで必要な場合は、基本認証が必要なプロキシやプロキシ自動設定 (PAC) も含め、HTTPフォワードプロキシを使用するようにLink Agentを設定できます。Link Agentに独自のプロキシ設定がない場合は、ホストのオペレーティングシステムのプロキシ設定に従います。

Link Agentを起動した後、mablアプリのネットワークページ (Settings > Networking) に移動します。会社トンネルの場合は、代わりに会社ダッシュボードの [ネットワーク] ページを開きます。

Link Agentは [リンクエージェント] テーブルに表示されます。起動中は、[ステータス] が [エージェントを初期化しています]、[アナウンス中]、[トンネルを確立しています] などの段階を経て進みます。1～2分以内に [接続済み] と表示されるはずです。

[エンドポイント] 列には、エージェントがmablに到達する方法が表示されます。Link 3.0の場合は QUIC または WSS、アカウントがまだレガシーLinkプロトコルを使用している間は Legacy (レガシー) です。エージェントがmablに到達できないという警告が列に表示される場合は、送信トラフィックの要件を確認してください。

Settings > Networkingのリンクエージェントテーブル。qa-01トンネルに接続され、QUICを使用中のLink Agentが表示されている

Link Agentが接続されない場合は、mabl Linkの問題のトラブルシューティングを参照してください。

次のステップ

関連記事