playwright-ci について
Playwright CI/CD は、継続的インテグレーションのパイプラインでPlaywrightテストを実行するチーム向けのガイド集です。CIプロバイダーの設定、実行の拡張、コンテナー、レポート、インフラの実践を扱います。
主な機能
- 01CIプロバイダーの設定ガイド
- 02並列実行とシャーディング
- 03Dockerとコンテナーのガイド
- 04レポートと成果物の扱い
- 05カバレッジとグローバル設定のガイド
活用シーン
- 01CIパイプラインでPlaywrightを設定
- 02複数のCIランナーへのテスト分割
- 03失敗時のトレースとレポート収集
- 04ワーカー間での認証状態の再利用
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/playwright-ciを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
ci-github-actions.mdci-gitlab.mdci-other.mddocker-and-containers.mdglobal-setup-teardown.mdparallel-and-sharding.mdprojects-and-dependencies.mdreporting-and-artifacts.mdtest-coverage.md詳細
Playwright CI/CD
すべてのパイプラインで信頼性の高いテストを実行しましょう — 速度、安定性、実用的なレポート作成のための CI 固有のパターンです。
9 件のガイドで、主要な CI プロバイダーすべてを対象に、CI/CD のセットアップ、並列実行、コンテナ化した実行、レポート作成、インフラストラクチャのパターンを解説します。
基本ルール
- CI でのみ
retries: 2を設定する — 不安定なテストはローカルではなく、パイプラインで明らかにします traces: 'on-first-retry'を設定する — すべての実行を遅くすることなく、詳細なデバッグ用成果物を取得します- ランナー間でシャード分割する —
--shard=N/Mでテストを均等に分割します。垂直方向ではなく、水平方向に拡張しましょう - ブラウザのバイナリをキャッシュする — Playwright のバージョンをキーにして
~/.cache/ms-playwrightをキャッシュします - 失敗時に成果物をアップロードする — トレース、スクリーンショット、HTML レポートを CI の成果物として保存します
- 公式 Docker イメージを使用する —
mcr.microsoft.com/playwright:v*には、必要な OS 依存関係がすべて事前にインストールされています - 認証にはグローバルセットアップを使用する —
globalSetupで一度だけログインし、すべてのワーカーでstorageStateを再利用します - まずはすばやく失敗させ、デバッグは後で行う — CI の実行時間を短く保ち、トレースビューアーと HTML レポートを使って調査します
ガイド一覧
CI プロバイダー
| プロバイダー | ガイド |
|---|---|
| GitHub Actions | ci-github-actions.md |
| GitLab CI | ci-gitlab.md |
| CircleCI / Azure DevOps / Jenkins | ci-other.md |
実行とスケーリング
| トピック | ガイド |
|---|---|
| 並列実行とシャード分割 | parallel-and-sharding.md |
| Docker とコンテナ | docker-and-containers.md |
| マルチプロジェクト設定 | projects-and-dependencies.md |
レポートとセットアップ
| トピック | ガイド |
|---|---|
| レポートと成果物 | reporting-and-artifacts.md |
| コードカバレッジ | test-coverage.md |
| グローバルセットアップ／ティアダウン | global-setup-teardown.md |
コメント
Markdown 対応