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

レガシーLinkからLink 3.0への移行

Molly Exten
  • 更新

Link 3.0は、レガシーmabl Linkプロトコルをより高速で信頼性の高いトンネルに置き換えるもので、レガシーLinkサービスは2027年3月15日に終了します。この記事は、現在Link Agentを実行しているチームを対象としています。エージェントのアップグレード、新しいエンドポイントに向けたファイアウォールの開放、クラウドテストのトラフィックのLink 3.0への移行を順に説明し、レガシーサービスの終了後もテストがプライベート環境に到達し続けるようにします。Link 3.0で追加された機能については、mabl Link 3.0のリリースノートを参照してください。

2027年3月15日に起こること

2027年3月15日に、mablはレガシーLinkサービスを終了します。この日以降は次のようになります。

  • バージョン3.0より前のLink Agentは動作を停止します。
  • バージョン3.0以降のLink Agentは、アカウントがすでにLink 3.0プロトコルに移行している場合にのみ動作し続けます。移行していない場合、mablはクラウドテストのトラフィックをそのエージェントにルーティングできなくなります。

この日までに、この記事の手順を完了してください。移行はアカウントごとに行われ、各手順をいつ開始するかはお客様が決められます。

引き継がれる内容

Link 3.0に移行しても、テストの設定方法は変わりません。

  • トンネル名はそのまま使えます。トンネル名を指定している環境、データベース接続、デプロイメントイベントは、編集なしで引き続き動作します。
  • APIキーはそのまま使えます。既存の「Link Agent」APIキーはLink 3.0でも動作します。
  • 設定ファイルは、プロキシ設定、PAC設定、接続フィルターを含めて引き続き動作します。
  • 高可用性は同じように動作します。同じトンネル名を持つ複数のエージェントがトラフィックを分担します。

いくつかの点は変更されます。

  • ファイアウォールルール。 Link 3.0は、エージェントごとに生成されるホスト名ではなく、固定のエンドポイントに接続します。詳しくは、Link 3.0に向けてファイアウォールを開放するを参照してください。
  • サポートされるプラットフォーム。 Link 3.0は、Linux（x86-64およびarm64）、Appleシリコン搭載のmacOS、x86-64のWindowsで動作します。それ以外のホストでエージェントを実行している場合は、以下のコールアウトを参照してください。
  • メモリ。 アカウントの移行が完了するまで、各エージェントはレガシートンネルとLink 3.0トンネルの両方を保持します。詳しくは、Link Agentのサイジングとスケーリングを参照してください。
  • システムのプロキシ設定。 独自のプロキシ設定を持たないLink Agentは、PACスクリプトを含め、ホストのオペレーティングシステムのプロキシ設定に従うようになりました。エージェントに使用させたくないプロキシがホストに設定されている場合は、設定ファイルでproxyModeをnoneに設定してください。
  • 廃止されたオプション。 --connectionsオプションと--max-connection-attempts（-r）オプション、および設定ファイルのconnectionsとmaxConnectionAttemptsは、レガシープロトコルにのみ適用されます。Link 3.0はこれらを無視し、今後のリリースで削除される予定です。

移行は3つのフェーズで進みます。まず、エージェントとネットワークを準備します。次に、クラウド実行がレガシーLinkを使い続けている間に、mablがアカウントのLink 3.0を有効にし、すべてのエージェントが接続できることを確認します。最後に、mablがクラウド実行をLink 3.0に移行し、レガシープロトコルを終了します。

Intel Mac、ARM版Windows、またはarm64のAlpine Linux上のエージェント

レガシーLink AgentはJavaが動作する環境ならどこでも実行できますが、Link 3.0はIntelプロセッサー搭載のMac、ARM版Windows、arm64のAlpine Linuxをサポートしていません。これらのホスト上のエージェントはレガシープロトコルでのみ動作し続け、レガシーLinkの終了時に動作を停止します。移行の一環として、サポートされるホストへの移行（arm64コンテナの場合はDockerイメージのUbuntuバリアントへの移行）を計画してください。

Settings > Networkingを開き、リンクエージェントテーブルを確認します。

  1. 各エージェントのバージョンを確認します。すべてのエージェントがバージョン3.0以降で動作している必要があります。
  2. 各エージェントのホストがサポートされるプラットフォーム上にあり、両方のプロトコルを保持している間、提供するトンネルに十分なメモリがあることを確認します。詳しくは、Link Agentのサイジングとスケーリングを参照してください。
  3. 会社の複数のワークスペースにLink Agentがある場合は、各ワークスペースで同じ確認を行います。

すべてのLink Agentホストから、TCPポート443のapi.mabl.comと、次の2つのLink 3.0トンネルエンドポイントのいずれかへの送信接続を許可します。

  • TCPポート443のmabl-wss.link.mabl.com（WSSエンドポイント）。送信トラフィックがHTTPプロキシを経由するネットワークや、UDPをブロックしているネットワーク向けです。ほとんどのネットワークではこのエンドポイントを使用します。
  • UDPポート443のmabl-quic.link.mabl.com（QUICエンドポイント）。プロキシなしでmablに到達できるホスト向けです。QUICのほうが高速で、Link Agentは可能な場合にQUICを使用します。

トンネルに必要なのは、2つのうちどちらか一方だけです。任意の更新パスを含む完全な一覧については、Link Agentの要件を参照してください。

許可リストにすでに*.link.mabl.comが含まれている場合、両方のエンドポイントがカバーされます。移行が完了するまでは、エージェントがレガシートンネルに*.link.mabl.comを使用するため、そのまま残しておいてください。

すべてのLink Agentをバージョン3.0以降にアップグレードします。アップグレード方法は、エージェントのインストール方法によって異なります。

  • zipまたはtar.bz2アーカイブからインストールし、自動更新を有効にしているエージェントは、起動時に最新バージョンをインストールします。各エージェントを再起動してから、Settings > Networkingでバージョン3.0以降と報告されていることを確認します。
  • 自動更新を無効にしているエージェント（disableAutoUpdates: true）は、手動でアップグレードする必要があります。Settings > Networkingから最新バージョンをダウンロードし、設定ファイルを残したまま、古いバージョンの代わりにインストールします。
  • DockerおよびKubernetesのエージェントには、バージョン3のイメージが必要です。mablhq/link-agent:3をプルするか、mablhq/link-agent:3-alpineまたはmablhq/link-agent:3-ubuntuでバリアントを固定し、コンテナを再起動します。AppleシリコンMacやARMクラウドインスタンスなどのarm64ホストでは、デフォルトのAlpineイメージがx86-64向けにのみ公開されているため、mablhq/link-agent:3-ubuntuを使用する必要があります。詳しくは、Dockerを用いたLinkの使用方法を参照してください。
  • Windowsのエージェントは、Windowsインストーラーに移行できます。インストーラーはエージェントをWindowsサービスとして実行し、独自のJavaランタイムを含んでいます。NSSMでセットアップしたサービスの置き換えについても説明しているWindowsでのLink Agentの使用を参照してください。

アップグレード後も、各エージェントはレガシープロトコルでのみ接続します。次の手順でmablがアカウントのLink 3.0を有効にすると、Link 3.0の使用を開始します。

すべてのエージェントがバージョン3.0以降で動作し、ファイアウォールが新しいエンドポイントを許可したら、mablに連絡してアカウントのLink 3.0を有効にするよう依頼します。カスタマーサクセスマネージャー、TAM、mablサポートなど、普段mablとのやり取りに使っている窓口からご連絡ください。

Link 3.0が有効になると、各Link Agentは再起動なしで両方のプロトコルで接続します。このフェーズでは、クラウドテストの実行は引き続きレガシートンネルを使用するため、Link 3.0を有効にしてもテストの実行方法は変わりません。

Settings > Networkingを開き、リンクエージェントテーブルのエンドポイント列を確認します。各エージェントには、使用しているエンドポイントが表示されます。

  • QUICまたはWSSは、エージェントがLink 3.0で接続していることを示します。
  • Legacyは、エージェントがレガシープロトコルで接続していることを示します。移行が完了するまでは、この接続が続きます。

すべてのエージェントで、Legacyと並んでQUICまたはWSSが使用中と表示されているはずです。UDPまたはTCPでmablに到達できないという警告が表示されているエージェントは、そのホストがLink 3.0のエンドポイントに到達できていません。そのホストのファイアウォールルールとプロキシ設定を見直してから、もう一度確認してください。さらに詳しい情報については、mabl Linkの問題のトラブルシューティングを参照してください。

すべてのエージェントがLink 3.0で接続したら、mablに知らせてください。mablがアカウントのクラウドテスト実行をLink 3.0に移行します。環境とトンネル名は変わりません。

切り替え後は、mabl Linkに依存するプランを実行し、以前と同じように成功することを確認してください。次の手順でレガシープロトコルが終了するまでは、問題が発生した場合にmablがクラウド実行をレガシーLinkに戻すことができるため、想定外の事象があればmablに報告してください。

レガシープロトコルを終了する

テストがLink 3.0で安定して実行されるようになったら、mablがアカウントのレガシープロトコルを無効にします。Link Agentはレガシー接続を閉じ、エンドポイント列にLegacyが表示されなくなります。

移行後

移行が完了すると、次のようになります。

  • 許可リストから{host}.link.mabl.comのエントリを削除できます。許可リストで*.link.mabl.comを使用している場合、mablが会社を専用のLinkインフラストラクチャに配置していない限り、エージェントが使用するエンドポイントに置き換えることができます。
  • 各Link Agentはレガシートンネルを保持しなくなるため、必要なメモリが少なくなります。詳しくは、Link Agentのサイジングとスケーリングを参照してください。
  • Link Agentは、起動時やネットワークの中断後に、より速く接続します。

Link 3.0には、レガシーLinkがサポートしていない機能もあります。

エージェントがLink 3.0に移行したら、同じネットワークに到達する複数のワークスペーストンネルを、会社内のすべてのワークスペースで共有する1つのトンネルに置き換えることもできます。詳しくは、ワークスペーストンネルから会社トンネルへの移行を参照してください。