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

Docker

はじめに​

Dockerfile.noble は、Docker 環境で Playwright スクリプトを実行するために使用できます。このイメージには、Playwright ブラウザとブラウザのシステム依存関係が含まれています。Playwright パッケージ/依存関係はイメージに含まれていないため、別途インストールする必要があります。

使用方法​

この Docker イメージは、Microsoft Artifact Registry に公開されています。

情報

この Docker イメージは、テストおよび開発目的でのみ使用することを意図しています。信頼できないウェブサイトへのアクセスにこの Docker イメージを使用することはお勧めしません。

イメージをプルする​

docker pull mcr.microsoft.com/playwright/java:v1.50.0-noble

イメージを実行する​

デフォルトでは、Docker イメージはブラウザを実行するために root ユーザーを使用します。これにより、root では利用できない Chromium サンドボックスが無効になります。信頼できるコード (例: エンドツーエンドテスト) を実行し、別のユーザーを管理する手間を避けたい場合は、root ユーザーでも問題ありません。ウェブスクレイピングまたはクローリングの場合、Docker コンテナ内に別のユーザーを作成し、seccomp プロファイルを使用することをお勧めします。

エンドツーエンドテスト​

信頼できるウェブサイトでは、ブラウザで実行されるコードを信頼できるため、別のユーザーを作成せずに root を使用できます。

docker run -it --rm --ipc=host mcr.microsoft.com/playwright/java:v1.50.0-noble /bin/bash

クローリングとスクレイピング​

信頼できないウェブサイトでは、サンドボックス付きのブラウザを起動するために、別のユーザーを seccomp プロファイルと組み合わせて使用することをお勧めします。コンテナ内、または Docker イメージをベースイメージとして使用している場合は、adduser を使用する必要があります。

docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright/java:v1.50.0-noble /bin/bash

seccomp_profile.json は、サンドボックス付きで Chromium を実行するために必要です。これは、デフォルトの Docker seccomp プロファイルに、追加のユーザー名前空間クローニング権限を加えたものです。

{
  "comment": "Allow create user namespaces",
  "names": [
    "clone",
    "setns",
    "unshare"
  ],
  "action": "SCMP_ACT_ALLOW",
  "args": [],
  "includes": {},
  "excludes": {}
}
注意

--ipc=host を使用することは、Chrome (Docker ドキュメント) を使用する場合に推奨されます。このフラグがないと、Chrome がメモリ不足になる可能性があります。

CI での使用​

サンプル設定については、継続的インテグレーションガイドをご覧ください。

リモート接続​

ホストシステムまたは別のマシンでテストを実行しながら、Docker で Playwright Server を実行できます。これは、サポートされていない Linux ディストリビューションやリモート実行シナリオでテストを実行する場合に役立ちます。

Playwright Server の実行​

Docker で Playwright Server を起動する

docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.50.0-noble /bin/sh -c "npx -y playwright@1.50.0 run-server --port 3000 --host 0.0.0.0"

サーバーへの接続​

package org.example;

import com.microsoft.playwright.*;
import java.nio.file.Paths;

public class App {
  public static void main(String[] args) {
    try (Playwright playwright = Playwright.create()) {
      Browser browser = playwright.chromium().connect("ws://127.0.0.1:3000/");
    }
  }
}

ネットワーク設定​

Docker コンテナ内からローカルサーバーにアクセスする必要がある場合

docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.50.0-noble /bin/sh -c "npx -y playwright@1.50.0 run-server --port 3000 --host 0.0.0.0"

これにより、hostmachine がホストの localhost を指すようになります。テストでローカルサーバーにアクセスする場合は、localhost の代わりに hostmachine を使用する必要があります。

注意

テストをリモートで実行する場合は、テスト内の Playwright バージョンが Docker コンテナで実行されているバージョンと一致していることを確認してください。

イメージタグ​

利用可能なすべてのイメージタグをご覧ください。

現在、次のタグ付きのイメージを公開しています

  • :v1.50.0 - Playwright v1.50.0 リリース Docker イメージ (Ubuntu 24.04 LTS (Noble Numbat) ベース)
  • :v1.50.0-noble - Playwright v1.50.0 リリース Docker イメージ (Ubuntu 24.04 LTS (Noble Numbat) ベース)
  • :v1.50.0-jammy - Playwright v1.50.0 リリース Docker イメージ (Ubuntu 22.04 LTS (Jammy Jellyfish) ベース)
注意

可能な場合は、常に Docker イメージを特定のバージョンに固定することをお勧めします。Docker イメージ内の Playwright バージョンがプロジェクト/テスト内のバージョンと一致しない場合、Playwright はブラウザ実行可能ファイルを見つけることができません。

ベースイメージ​

現在、次の Ubuntu バージョンをベースにしたイメージを公開しています

  • Ubuntu 24.04 LTS (Noble Numbat)、イメージタグには noble が含まれます
  • Ubuntu 22.04 LTS (Jammy Jellyfish)、イメージタグには jammy が含まれます

Alpine​

Firefox および WebKit 用のブラウザビルドは、glibc ライブラリ用にビルドされています。Alpine Linux および musl 標準ライブラリに基づいた他のディストリビューションはサポートされていません。