Nexus Studioをインストールして最初のテストを実行する

新規トライアルから定期実行まで、7つのステップで完了します。その後のセクションで詳細を説明します。インストーラーのダウンロード、検証、マシンのアクティベーション、テストの実行です。テストはお使いのマシン上で実行され、外部に送信されるのはライセンス確認のみです。

最初の7分間

新規トライアルから定期実行まで、Studioが想定する順序で進めます。初回セットアップでは数百MBのブラウザをダウンロードするため、所要時間は接続環境によって異なります。

1. トライアルを開始してインストールします。アカウントにサインインし、利用規約に同意して、クレジットカード不要の30日間トライアルを開始してください。インストーラーをダウンロードし、SHA-256を確認して実行し、ライセンスキーでこのマシンをアクティベートします。その後、ワークスペースフォルダーを開くか作成し、セットアップガイドですべてインストールを選択します（詳細）。
2. 最初のテストを記録します（Nexus Recorder）。PatrolでNexus Recorderタブを開き、記録するURLとテスト名を入力して、記録を開始を選択します。表示されたブラウザウィンドウでフローをクリックして進め、ウィンドウを閉じるか停止して保存を選択してください。Studioがワークスペースにテストファイルを書き込みます。テスト内容を記述したい場合や、すでにあるテストを取り込みたい場合は、AIライターやTest Adapterでも作成できます。
3. サンドボックスでリハーサルします（3回実行）。記録が保存されたら、サンドボックスで実行（ヘッドあり）を選択します。サンドボックスでの実行はエビデンスや履歴に何も書き込まず、3回のリハーサルではそれぞれ異なるブラウザが使用されます。Patrolのサンドボックス終了待ちカードが0/3から3/3までカウントし、テストは初回本番実行の準備完了へと移動します。APIテストにはサンドボックスがなく、初回押下時から本番実行されます。
4. 最初の本番実行。パトロール実行タブでテストを選択し、サンドボックスのチェックを外した状態でパトロールを本番実行を選択します。本番実行ではエビデンスと履歴に書き込みが行われます。PlaywrightテストはChromium、Firefox、WebKitで実行され、SeleniumテストはChromiumとFirefoxで実行されます。
5. 判定結果を確認します。Patrolは各ブラウザにおける状態ごとにすべてのテストを色分けし、エディタ上部の実行ストリップが各ブラウザの動作状況を言葉で表示します。状態は14種類の判定（verdict）のいずれかです。SECUREは単独で成功、FLAKYは再試行時のみ成功、BREACHEDは実際の問題の検出、TIMEOUTは時間内に応答がなかったことを示し、破損していることの証明ではありません。
6. エビデンスを開きます。メニューバーで表示を選択し、次にエビデンスロッカーを選択します。各レコードは、レポート、メタデータ、テレメトリ、未加工ログで開きます。失敗には理由を添えて実際のバグまたは誤検知のマークを付けます。最初の判定によって証拠保全（chain of custody）が開始され、検証機能が変更された最初のレコードを特定します。
7. スケジュールを設定します（WatchまたはCI/CD）。パトロール実行タブのWatchは、タイマーによって無人で選択項目を再実行します（5分ごと〜24時間ごと、または特定の日時に1回）。Studioのマシンが起動している必要があり、TelegramやSlackを連携している場合は状態が変化したときにのみ通知されます。パイプラインの場合は、実行、次に環境とCI/CDを選択します。画面上にGitHub ActionsまたはGitLab CIファイルが生成されます（CI/CDからテストを実行する）。CIでエンジンを実行するマシンはアクティベート済みマシンとみなされ、プランの対象としてカウントされます。

システム要件

16 GBのRAMを搭載したWindows 11 x64では、このマシンでPlaywrightテストを実行するために必要なのはインストーラーだけです。「任意」とマークされた各行は、指定された機能でのみ必要となり、Studioのセットアップ画面でチェックされます。

インストーラーをダウンロード

1. ダウンロードを開き、Windows 向けダウンロードを選択してください。ページにはバージョン、リリース日、サイズ、SHA-256 が表示されます。同じインストーラーはアカウント内のダウンロードにもあります。
2. ライセンスをまだお持ちでない場合は、メールアドレスまたは Google でアカウントにサインインし、概要で利用規約に同意して 30 日間のトライアルを開始してください。Studio をアクティベートするまで 30 日間のカウントは始まりません。

ダウンロードの確認

ダウンロードページの SHA-256 は、公開されているインストーラーのフィンガープリントです。実行する前に、ダウンロードしたファイルと比較してください。PowerShell でファイルが存在するフォルダーから以下を実行します:

(Get-FileHash -Algorithm SHA256 ".\<installer file name>").Hash -eq "<SHA-256 from the Download page>"

Trueはそのファイルが弊社の公開したものであることを意味します。大文字・小文字は問いません。Falseはそうでないことを意味します。ファイルを削除し、再度ダウンロードして、実行しないでください。

Windows SmartScreenが「Windows によって PC が保護されました」というメッセージで新しいインストーラーを停止する場合があります。確認結果がTrueである場合にのみ先へ進んでください。詳細情報を選択し、次に実行を選択してください。

このマシンをアクティベート

1. インストーラーを実行し、Nexus Studioを開いてください。
2. ライセンスキーをコピーしてください。キーはアカウントに一度だけ表示されます：トライアル開始直後、または有料プランのLicense & machinesでGet license keyを選択したときです。キーのハッシュのみを保管しているため、紛失した場合は再発行してください。
3. 有効化されるまで、StudioはLicense画面で開きます。ライセンスキーフィールドにキーを貼り付けて、Activateを選択してください。キーはnxs_live_で始まり、61文字です；コピー時に混入したスペースや改行は無視されます。
4. ステータスにアクティブと表示されます。トライアルの場合、30 日間のカウントがここから開始されます。

キーはこのマシンを有効化するために一度だけ送信され、Studioはキーを保持しません。以降、Studioは独自にライセンスを確認します。同じ画面のWhat leaves this machineには、次回の確認時に送信される正確なリクエストの内容（含まれる情報）が表示されます。

アクティベーションが拒否された場合は、メッセージにその理由が表示されます: キーが無効である、プランのすべてのマシンが使用中である、このマシンで既にトライアルが利用されている、ライセンスの支払いが完了していない、またはライセンスサーバーにアクセスできないのいずれかです。

ワークスペースを開いてセットアップを実行

この処理はお客様のマシン上で行われ、テスト内容も結果も弊社には一切届きません。

1. フォルダーを開いてください。テストとエビデンスは1つのワークスペースフォルダーにまとめて管理されます。New folderとCreate hereを選択して新規作成するか、すでにワークスペースとして使用しているフォルダーがある場合はOpen existingを選択してください。
2. セットアップ。ワークスペースは、npm installとplaywright installを使用してパッケージとブラウザを一度だけインストールします。セットアップガイドのすべてインストールで不足しているものが順番に実行され、必要な行がすべて揃うと続行のロックが解除されます。これにはネットワーク接続が必要です。その後は、ライセンス確認を除き、ワークスペースはオフラインで動作します。adbは実機のAndroidスマートフォンでのみ必要です。
3. 続いてテスト本体です。作成し、リハーサルを行い、本番実行して、判定結果を確認します。最初の7分間のステップ2から6です。

Studioツアーですべての画面をご確認いただけます。

アップデート

アップデートが自動的に行われることはありません。Update nowを選択するまで、何もダウンロードもインストールもされません。あとはワンクリックで完了します。

1. 新しいバージョンが公開されると、Studio のメニューバーの下に通知行が表示されます: Nexus Studio とバージョン名、が利用可能です、ならびに今すぐ更新と後でが表示されます。この通知はライセンスチェックとともに署名されて届きます。Studio は検証できないアップデートに対しては何も表示しません。
2. Update nowを選択するまで、何もダウンロードされません。その後、Studioは downloads.sentinel-nexusstudio.com からHTTPS経由でインストーラーをダウンロードし、署名された通知とSHA-256を照合して検証します。この通知自体に追加の接続は発生せず、ライセンスチェック以外ではこのダウンロードのみが行われます。
3. 検証に合格するとStudioが閉じ、確認事項なしでプログレスバーの表示のみで新バージョンがインストールされ、Studioが再び開きます。検証に失敗した場合はファイルが削除され、何もインストールされずに理由が表示されてTry againが提示されます。
4. アップデート後、各ワークスペース内のエンジンのコピーは自動的に新しいバージョンに更新されます。テスト、エビデンス、設定が変更されることはありません。

実行場所

Nexus Studio はお手元の Windows 11 PC 上で動作し、それ以外に何も必要ありません。

• お使いのPC: Nexus Studio をインストールし、ワークスペースを開いて実行します。スケジュール実行はPCが起動している間のみ行われます。
• ミニPC（オプション）: 常時起動する専用の Windows 11 マシンで、ワークステーションを占有することなく夜間のリグレッションテストやスケジュール実行を行えます。Watch はスケジュールを維持し、エビデンスはそのディスクに保存されます。
• ワークスペースごとのランタイム: 各ワークスペースは、Nexus Studio の Docker 画面でエンジンのテストスイート実行場所を選択します。このマシン、同じディスク上のランナーコンテナ内のこのマシンの Docker、または同じコンテナイメージを実行する SSH 経由の VPS から選択できます。2つのワークスペースでテスト対象となる2つのアプリケーションが、それぞれ異なるランタイムを使用することも可能です。3つのうちどれかが必須というわけではなく、設定1つで切り替えられます。Nexus Studio 自体は常に Windows 上にとどまります。
• VPS は Ubuntu 24.04 LTS（Docker Engine および Compose v2 搭載）を実行し、SSH 鍵認証でアクセスします。エビデンスは取得するまでそこに保持されます。VPS 自身がライセンスをチェックし、プランのマシンとしてカウントされます。詳細はプランとマシンをご覧ください。
• 実機のAndroid端末は、USBデバッグを有効にした状態でUSB経由でStudioのマシンに接続します；Devices & Mobileに最初の端末向けガイドがあります。端末を使ったテスト、SeleniumとPythonのスイート、およびインフラの混乱テストは常にStudio自身のマシン上で実行されます。

スケジューラである Watch は、ワークスペースのランタイムが Local に設定されている場合のみ、Nexus Studio 独自のマシン上で動作します。VPS 上で実行をスケジュールするには、CI をご利用ください: CI/CD からテストを実行する。

インフラをご自身で管理する これらのセットアップを選択する際の参考として、ご自身のマシン、クラウドQAプラットフォーム、レンタルサーバーを比較しています：エビデンスの保存場所、アクセスできるユーザー、およびコストの観点から比較しています。

Nexus Studio はトンネルなしでどのように localhost をテストしますか？

お客様専用のQAアプライアンス。トンネルも、ステージングURLの外部公開も不要で、テストデータがネットワークの外に出ることもありません。Windows 11、Ubuntu 24.04 LTS、Docker、またはSSH上で動作します。BASE_URLにより、localhostやプライベートなステージングURL上のアプリケーションをそのまま指定してテストスイートを実行できます。

• テスト終了後も起動したままになっている開発サーバー。

  NEXUS_APP_START はすべての実行前にアプリを起動し、実行が終了・失敗・中断された場合（Ctrl+C を含む）にプロセスツリー全体を停止します。

• 起動しなかったアプリに対するグリーンの実行結果。

  実行は準備完了 URL が応答するまで待機します（500 未満のステータス、0.5 秒ごとに確認）。アプリが起動できない場合、実行は開始されません: CONFIG_ERROR APP_DID_NOT_START（末尾 40 行のログを表示）。

• すでに起動中のアプリの 2 つ目のコピー。

  NEXUS_APP_REUSE=true はすでに応答しているアプリをそのまま使用し、実行後も起動したままにします。false の場合、他のものが同じ場所で応答していると実行を停止します。

• ビルドと紐付けられない結果。

  各実行では、アプリの package.json バージョンとテスト対象の git コミットが記録されます。

• Docker と SSH。

  Docker ではアプリはこのマシン上で動作し、コンテナは host.docker.internal として localhost の BASE_URL に到達します。SSH 経由の場合はリモートホスト上で起動します。

プログラムとその引数のみ、シェルなし: npm run dev、pnpm dev、または node server.js。nexus app check を使うと Studio でテストでき、起動・待機・停止を行います。すべてのログは evidence/run-context/ に保存されます。