会社スコープのLinkトンネルは、1つのワークスペースではなく会社に属するトンネルで、会社内のすべてのワークスペースがそのトンネル経由でテストを実行できます。複数のチームが同じプライベート環境をテストしていて、ワークスペースごとにLink Agentを用意するのではなく、1組のLink Agentを運用および保守したい場合に使用します。
この記事では、会社トンネルのセットアップ方法と管理方法について説明します。既存のワークスペーストンネルを会社トンネルに置き換えるには、ワークスペーストンネルから会社トンネルへの移行を参照してください。会社スコープのトンネルは、Link 3.0で利用できます。
会社トンネルをセットアップする
会社トンネルのセットアップには、アカウント管理者の権限が必要です。
- 会社のダッシュボードを開きます。mablアプリの右上にあるワークスペースのドロップダウンを展開し、Manage company(会社の管理)の下にある会社名をクリックします。
- APIキータブを開き、Create keyをクリックします。
- キーのタイプとしてリンクエージェントを選択します。キーに名前を付け、有効期限を設定して、Create keyをクリックします。
- キーをコピーして安全な場所に保管します。キーは後から再表示できません。
- ワークスペースキーの場合と同じ方法で、会社キーとトンネル名を指定してLink Agentを起動します。詳しくは、Link Agentのセットアップを参照してください。
エージェントが接続されると、会社のダッシュボードのネットワークページに表示されます。このページには、会社トンネルを提供するすべてのエージェントが一覧表示されます。トンネルテーブルには、各トンネルを使用しているワークスペースが表示されます。
多くのワークスペースが共有するトンネルでは、1つのワークスペースに必要な容量よりも余裕を持って計画し、複数のエージェントでトンネルを提供してください。詳しくは、Link Agentのサイジングとスケーリングを参照してください。
会社トンネルを管理する
アカウント管理者は、ワークスペースの所有者がSettings > Networkingでワークスペースのエージェントを管理するのと同じように、アカウントダッシュボードのネットワークページから会社トンネルのエージェントを管理します。これには、エージェントのメンテナンスモードへの切り替えやシャットダウンが含まれます。
- アクセス: アカウント管理者は、ネットワークページのLinkトンネルアクセスセクションで、どのロールがmablデスクトップアプリおよびCLIから会社トンネルに到達できるか、またmablサポートが会社トンネルに到達できるかどうかを選択します。詳しくは、Linkトンネルへのアクセスの制御を参照してください。会社トンネルでは、ロールの設定は会社内のどのワークスペースのそのロールにも適用されます。
- アクティビティ: エージェントの接続やトンネルへのアクセスなど、会社トンネルのイベントは、ワークスペースのアクティビティフィードではなく、会社のダッシュボードのアクティビティフィードに表示されます。
ワークスペーストンネルを会社に移行する
ワークスペースが会社トンネルと同じ名前の独自のトンネルを持っている場合、会社トンネルに接続済みのエージェントがある限り、会社トンネルが優先されます。そのワークスペースのテストは会社トンネル経由で実行されます。会社トンネルに接続済みのエージェントがない場合、テストはワークスペーストンネルにフォールバックします。
環境を編集せずにワークスペースを会社トンネルへ移行するには、同じ名前の会社トンネルを起動します。接続が確立され次第、トラフィックは会社トンネルへ移ります。すべてのワークスペースが同じネットワークに対して同じ名前を使用している場合は、1つの会社トンネルがそれらすべてを引き継ぎます。移行中は、1つのLink Agentが両方のトンネルを提供でき、設定ファイルの変更は再起動なしで適用されます。
名前の計画、移行手順、ロールバック方法については、ワークスペーストンネルから会社トンネルへの移行を参照してください。
会社トンネルに置き換えられるべきではない独自のトンネルがワークスペースに必要な場合は、ワークスペーストンネルに別の名前を付けてください。
会社トンネルとワークスペーストンネルの見分け方
トンネルは名前で識別されます。環境、データベース接続、デプロイイベントのリンクエージェントリストには、会社トンネルがワークスペース自身のトンネルと並んで表示され、区別を示す印は付きません。
トンネルが会社トンネルかどうかを確認するには、会社のダッシュボードのネットワークページでそのトンネルを探してください。このページには、すべての会社トンネルとそのエージェントが一覧表示されます。ワークスペーストンネルと会社トンネルが同じ名前を持つ場合は、ワークスペーストンネルを会社に移行するで説明しているルールに従って、どちらがトラフィックを処理するかが決まります。