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

継続的インテグレーション

はじめに​

Playwright のテストは CI 環境で実行できます。一般的な CI プロバイダー向けのサンプル設定を作成しました。

CI でテストを実行するための 3 ステップ

  1. CIエージェントがブラウザを実行できることを確認する: Linuxエージェントで弊社のDockerイメージを使用するか、CLIを使用して依存関係をインストールしてください。

  2. Playwright のインストール:

    dotnet build
    pwsh bin/Debug/netX/playwright.ps1 install --with-deps

  3. テストの実行:

    dotnet test

CI 設定​

コマンドラインツールを使用すると、CIで必要なすべてのオペレーティングシステムの依存関係をインストールできます。

GitHub Actions​

プッシュ/プルリクエスト時​

テストは、main/master ブランチへのプッシュまたはプルリクエスト時に実行されます。ワークフローは、すべての依存関係をインストールし、Playwright をインストールしてからテストを実行します。

.github/workflows/playwright.yml
name: Playwright Tests
on:
  push:
    branches: [ main, master ]
  pull_request:
    branches: [ main, master ]
jobs:
  test:
    timeout-minutes: 60
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - name: Setup dotnet
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: 8.0.x
    - name: Build & Install
      run: dotnet build
    - name: Ensure browsers are installed
      run: pwsh bin/Debug/net8.0/playwright.ps1 install --with-deps
    - name: Run your tests
      run: dotnet test

コンテナ経由​

GitHub Actions は、jobs.<job_id>.container オプションを使用してコンテナ内でジョブを実行することをサポートしています。これは、ホスト環境を依存関係で汚染しないようにし、例えば異なるオペレーティングシステム間でスクリーンショット/視覚回帰テストを行うための安定した環境を持つ場合に便利です。

.github/workflows/playwright.yml
name: Playwright Tests
on:
  push:
    branches: [ main, master ]
  pull_request:
    branches: [ main, master ]
jobs:
  playwright:
    name: 'Playwright Tests'
    runs-on: ubuntu-latest
    container:
      image: mcr.microsoft.com/playwright/dotnet:v1.54.0-noble
      options: --user 1001
    steps:
      - uses: actions/checkout@v4
      - name: Setup dotnet
        uses: actions/setup-dotnet@v4
        with:
          dotnet-version: 8.0.x
      - run: dotnet build
      - name: Run your tests
        run: dotnet test

デプロイ時​

GitHub Deploymentがsuccess状態になった後、テストが開始されます。Vercelのようなサービスはこのパターンを使用するため、デプロイされた環境でエンドツーエンドテストを実行できます。

.github/workflows/playwright.yml
name: Playwright Tests
on:
  deployment_status:
jobs:
  test:
    timeout-minutes: 60
    runs-on: ubuntu-latest
    if: github.event.deployment_status.state == 'success'
    steps:
    - uses: actions/checkout@v4
    - name: Setup dotnet
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: 8.0.x
    - run: dotnet build
    - name: Ensure browsers are installed
      run: pwsh bin/Debug/net8.0/playwright.ps1 install --with-deps
    - name: Run tests
      run: dotnet test
      env:
        # This might depend on your test-runner
        PLAYWRIGHT_TEST_BASE_URL: ${{ github.event.deployment_status.target_url }}

Docker​

直接使用できる、または既存のDocker定義を更新するための参照として使用できる構築済みDockerイメージを用意しています。推奨Docker構成に従って、最高のパフォーマンスを確保してください。

Azure Pipelines​

Windows または macOS エージェントの場合、追加の設定は必要ありません。Playwright をインストールしてテストを実行するだけです。

Linuxエージェントでは、Azure Pipelinesがコンテナ化されたジョブを実行することをサポートしているため、弊社のDockerコンテナを使用できます。あるいは、コマンドラインツールを使用して必要なすべての依存関係をインストールすることもできます。

Playwright テストを実行するには、このパイプラインタスクを使用します

trigger:
- main

pool:
  vmImage: ubuntu-latest

steps:
- task: UseDotNet@2
  inputs:
    packageType: sdk
    version: '8.0.x'
  displayName: 'Use .NET SDK'
- script: dotnet build --configuration Release
  displayName: 'Build'
- script: pwsh bin/Release/net8.0/playwright.ps1 install --with-deps
  displayName: 'Install Playwright browsers'
- script: dotnet test --configuration Release
  displayName: 'Run tests'

Azure Pipelines (コンテナ化)​

trigger:
- main

pool:
  vmImage: ubuntu-latest
container: mcr.microsoft.com/playwright/dotnet:v1.54.0-noble

steps:
- task: UseDotNet@2
  inputs:
    packageType: sdk
    version: '8.0.x'
  displayName: 'Use .NET SDK'

- script: dotnet build --configuration Release
  displayName: 'Build'
- script: dotnet test --configuration Release
  displayName: 'Run tests'

CircleCI​

CircleCIでPlaywrightを実行するのは、GitHub Actionsで実行するのと非常によく似ています。事前にビルドされたPlaywrightのDockerイメージを指定するには、config内のdocker:でエージェント定義を次のように変更するだけです。

executors:
  pw-noble-development:
    docker:
      - image: mcr.microsoft.com/playwright/dotnet:v1.54.0-noble

注: Docker エージェント定義を使用する場合、Playwright が実行されるリソースクラスを「medium」層こちらに指定しています。Playwright のデフォルトの動作では、ワーカー数を検出されたコア数（medium 層の場合は 2）に設定します。この数よりもワーカー数を多く設定すると、不必要なタイムアウトと障害が発生します。

Jenkins​

Jenkinsはパイプライン用のDockerエージェントをサポートしています。Playwright Dockerイメージを使用してJenkinsでテストを実行してください。

pipeline {
   agent { docker { image 'mcr.microsoft.com/playwright/dotnet:v1.54.0-noble' } }
   stages {
      stage('e2e-tests') {
         steps {
            sh 'dotnet build'
            sh 'dotnet test'
         }
      }
   }
}

Bitbucket Pipelines​

Bitbucket Pipelinesは、公開されているDockerイメージをビルド環境として使用できます。BitbucketでPlaywrightテストを実行するには、弊社の公開Dockerイメージ（Dockerfileを参照）を使用してください。

image: mcr.microsoft.com/playwright/dotnet:v1.54.0-noble

GitLab CI​

GitLabでPlaywrightテストを実行するには、弊社の公開Dockerイメージ（Dockerfileを参照）を使用してください。

ブラウザのキャッシュ​

ブラウザバイナリのキャッシュは推奨されません。キャッシュを復元にかかる時間とバイナリをダウンロードにかかる時間は同程度だからです。特にLinuxでは、キャッシュできないオペレーティングシステムの依存関係をインストールする必要があります。

それでもCIの実行間でブラウザバイナリをキャッシュしたい場合は、Playwrightのバージョンのハッシュを基準にして、CI構成でこれらのディレクトリをキャッシュしてください。

ブラウザ起動のデバッグ​

Playwright は、実行中にデバッグログを出力するためにDEBUG環境変数をサポートしています。Error: Failed to launch browserエラーをデバッグする際には、これをpw:browserに設定すると役立ちます。

DEBUG=pw:browser dotnet test

ヘッダー付きで実行​

デフォルトでは、Playwrightはブラウザをヘッドレスモードで起動します。ヘッドモードでテストを実行する方法については、テストの実行ガイドを参照してください。

Linuxエージェントでは、ヘッド付き実行にはXvfbがインストールされている必要があります。弊社のDockerイメージとGitHub ActionにはXvfbがプリインストールされています。Xvfbでヘッドモードでブラウザを実行するには、実際のコマンドの前にxvfb-runを追加します。

xvfb-run dotnet test