Azure 劇作家

Azure Playwright は、クラウドを使用して、さまざまなオペレーティングシステムとブラウザーの組み合わせ間で同時に、はるかに高い並列化で Playwright テストを実行できるようにするフルマネージドの Azure サービスです。これは、より幅広いシナリオ範囲でテスト実行が高速化されることを意味し、品質を犠牲にすることなく機能の提供を高速化するのに役立ちます。 Playwright ワークスペースを使用すると、より迅速かつ自信を持って機能をリリースできます。

作業を開始する準備はできましたか? クイックスタートガイドにジャンプしてください。

お役立ちリンク

開始する

次の手順に従って、サービスで既存の Playwright テストスイートを実行します。

[前提条件]

アクティブなサブスクリプションを持つ Azure アカウント。 Azure サブスクリプションをお持ちでない場合は、始める前に無料アカウントを作成してください。
Azure アカウントには、所有者、共同作成者、またはクラシック管理者ロールのいずれかが割り当てられている必要があります。
Playwright テストを実行しているマシンに Azure CLI をインストールする必要があります。

ワークスペースの作成

Azure アカウントを使用して Azure portal にサインインします。

ワークスペースを作成します。

ポータルの左上隅にあるメニューボタンを選択し、リソースの作成を選択します。
検索ボックスに「Playwright Workspaces」と入力します。
[Playwright Workspaces] カードを選択し、[作成] を選択します。

新しい Playwright Workspaces を構成するには、次の情報を指定します:

フィールド	Description
Subscription	この Playwright Workspaces に使用する Azure サブスクリプションを選択します。
リソースグループ	既存のリソースグループを選択します。または、[新規作成] を選択し、新しいリソースグループの一意の名前を入力します。
名前	ワークスペースを識別する一意の名前を入力します。名前には英数字のみを使用できます。また、3 から 64 文字の間で指定する必要があります。
場所	ワークスペースをホストする地理的な場所を選択します。この場所は、テスト実行結果が格納される場所も決定します。

注

必要に応じて、[タグ] タブでさらに詳細を構成できます。タグは名前と値のペアであり、同じタグを複数のリソースやリソースグループに適用することで、リソースを分類したり、統合された課金を表示したりできるようにします。

リソースの構成が完了したら、[確認および作成] を選択します。
すべての構成設定を確認し、[作成] を選択して Playwright Workspaces のデプロイを開始します。
プロセスが完了すると、デプロイ成功メッセージが表示されます。
新しいワークスペースを表示するには、[Go to resource]\(リソースに移動\) を選択します。

Azure Playwright パッケージをインストールする

このコマンドを実行して、サービスパッケージをインストールします
```
npm init @azure/playwright
```

サービスパッケージをインストールすると、 playwright.service.config.ts

サービス構成は、次の役割を果たします。

Playwright を Playwright ワークスペースに誘導して認証します。
必要に応じて、サービス操作のタイムアウトをオーバーライドします。

プロジェクトで @playwright/test バージョン 1.47 以降が使用されていることを確認します。

リージョンエンドポイントの取得

Azure portal で、セットアップの [リージョンエンドポイントの追加] の下にあるコマンドをコピーします。

エンドポイント URL はワークスペースリージョンに対応します。ワークスペースの作成時に選択したリージョンに応じて、Azure portal に異なるエンドポイント URL が表示される場合があります。

環境を設定する

前のステップで取得した PLAYWRIGHT_SERVICE_URL がご使用の環境で使用可能であることを確認します。

環境を管理するには dotenv モジュールを使用することをお勧めします。 dotenvでは、.env ファイルを使用して環境変数を定義します。

秘密 .env 漏洩しないように、 .gitignore ファイルにファイルを追加することを忘れないでください。

npm i --save-dev dotenv

.env ファイル

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/playwrightworkspaces/workspace-id/browsers

認証を設定する

Azure Playwright ワークスペースで Playwright テストを実行するには、サービスを使用してテストを実行している Playwright クライアントを認証する必要があります。これはローカル開発マシンまたは CI マシンである可能性があります。

このサービスには、2 つの認証方法 (Microsoft Entra ID とアクセストークン) が用意されています。

Microsoft Entra ID では Azure 資格情報が使用され、アクセスをセキュリティで保護するために Azure アカウントへのサインインが必要になります。あるいは、Playwright ワークスペースからアクセストークンを生成し、セットアップで使用することもできます。

Microsoft Entra ID を使用して認証を設定する

Microsoft Entra ID は、このサービスの既定かつ推奨される認証です。ローカル開発マシンから、Azure CLI を使用してサインインできます

az login

注: 複数の Microsoft Entra テナントの一部である場合は、ワークスペースが属するテナントにサインインしてください。テナント ID は Azure portal から取得できます (「 Microsoft Entra テナントの検索」を参照してください)。 ID を取得したら、コマンド az login --tenant <TenantID> を使用してサインインします

アクセストークンを使用して認証を設定する

Azure Playwright ワークスペースからアクセストークンを生成し、セットアップで使用できます。ただし、強化されたセキュリティのため、認証には Microsoft Entra ID を使用することを強くお勧めします。アクセストークンは便利ですが、有効期間が長いパスワードのように機能し、侵害されやすくなります。

アクセストークンベースの認証を使用するには、アクセストークンベースの認証を有効にする
アクセストークンを使用した認証を設定する

サービスへの認証には Microsoft Entra ID を使用することを強くお勧めします。アクセストークンを使用している場合は、アクセストークンの管理方法を参照してください

手記：CI パイプラインで Azure Playwright を使用するには、パイプラインからサービスを使用して認証を構成する必要があります (「さまざまなブラウザーとオペレーティングシステム間で継続的なエンドツーエンドテストを設定する」を参照してください)

テストを実行する

上記で作成した構成を使用して、サービスによって管理されているブラウザーに対して Playwright テストを実行します。

npx playwright test --config=playwright.service.config.ts --workers=20

次のステップ

CI/CD パイプラインでテストを実行します。
作成したワークスペースへのアクセスを管理する方法について説明します。
さまざまな数のワーカーを試して、テストスイートの最適な構成を決定します。

Contributing

このプロジェクトでは、貢献や提案を歓迎します。ほとんどのコントリビューションでは、コントリビューターライセンス契約(CLA)に同意し、コントリビューションを使用する権利を当社に付与する権利があり、実際に付与していることを宣言する必要があります。詳細については、 https://cla.opensource.microsoft.com を参照してください。

プルリクエストを送信すると、CLAボットはCLAを提供する必要があるかどうかを自動的に判断し、PRを適切に装飾します(ステータスチェック、コメントなど)。ボットが提供する指示に従うだけです。 CLAを使用して、すべてのリポジトリでこれを一度だけ行う必要があります。

このプロジェクトでは、 Microsoft オープンソース行動規範が採用されています。詳細については、行動規範に関するFAQ を参照するか、追加の質問やコメントがある場合は opencode@microsoft.com にお問い合わせください。

商標

このプロジェクトには、プロジェクト、製品、またはサービスの商標またはロゴが含まれている場合があります。 Microsoft の商標またはロゴの許可された使用は、 Microsoft の商標およびブランドガイドラインの対象となり、それに従う必要があります。このプロジェクトの修正版で Microsoft の商標またはロゴを使用することは、混乱を引き起こしたり、Microsoft のスポンサーシップを暗示したりしてはなりません。第三者の商標またはロゴの使用には、それらの第三者のポリシーが適用されます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-08-29