持续集成
简介
Playwright 测试可以在 CI 环境中执行。我们为常见的 CI 提供商创建了示例配置。
在 CI 上运行测试的 3 个步骤
-
确保 CI 代理可以运行浏览器:在 Linux 代理中使用我们的 Docker 镜像,或使用 CLI 安装依赖项。
-
安装 Playwright:
mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install --with-deps"
-
运行测试:
mvn test
CI 配置
命令行工具可用于在 CI 中安装所有操作系统依赖项。
GitHub Actions
在 push/pull_request 时
测试将在 main/master 分支上的 push 或 pull request 时运行。工作流将安装所有依赖项,安装 Playwright,然后运行测试。
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
- uses: actions/setup-java@v3
with:
distribution: 'temurin'
java-version: '17'
- name: Build & Install
run: mvn -B install -D skipTests --no-transfer-progress
- name: Ensure browsers are installed
run: mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install --with-deps"
- name: Run tests
run: mvn test
通过容器
GitHub Actions 支持使用 在容器中运行作业,通过使用 jobs.<job_id>.container
选项。这对于不使用依赖项污染主机环境以及在不同操作系统上进行截图/视觉回归测试时拥有一致的环境非常有用。
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/java:v1.51.0-noble
options: --user 1001
steps:
- uses: actions/checkout@v4
- uses: actions/setup-java@v3
with:
distribution: 'temurin'
java-version: '17'
- name: Build & Install
run: mvn -B install -D skipTests --no-transfer-progress
- name: Run tests
run: mvn test
在部署时
这将在 GitHub 部署进入 success
状态后开始测试。像 Vercel 这样的服务使用这种模式,因此您可以在其部署环境中运行端到端测试。
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
- uses: actions/setup-java@v3
with:
distribution: 'temurin'
java-version: '17'
- name: Build & Install
run: mvn -B install -D skipTests --no-transfer-progress
- name: Install Playwright
run: mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install --with-deps"
- name: Run tests
run: mvn 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 测试请使用此 pipeline 任务
trigger:
- main
pool:
vmImage: ubuntu-latest
steps:
- task: JavaToolInstaller@0
inputs:
versionSpec: '17'
jdkArchitectureOption: 'x64'
jdkSourceOption: AzureStorage
- script: mvn -B install -D skipTests --no-transfer-progress
displayName: 'Build and install'
- script: mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install --with-deps"
displayName: 'Install Playwright browsers'
- script: mvn test
displayName: 'Run tests'
Azure Pipelines (容器化)
trigger:
- main
pool:
vmImage: ubuntu-latest
container: mcr.microsoft.com/playwright/java:v1.51.0-noble
steps:
- task: JavaToolInstaller@0
inputs:
versionSpec: '17'
jdkArchitectureOption: 'x64'
jdkSourceOption: AzureStorage
- script: mvn -B install -D skipTests --no-transfer-progress
displayName: 'Build and install'
- script: mvn test
displayName: 'Run tests'
CircleCI
在 CircleCI 上运行 Playwright 与在 GitHub Actions 上运行非常相似。要指定预构建的 Playwright Docker 镜像,只需按如下方式修改配置文件中的 agent 定义,添加 docker:
executors:
pw-noble-development:
docker:
- image: mcr.microsoft.com/playwright/java:v1.51.0-noble
注意:使用 docker agent 定义时,您正在指定 Playwright 运行所在的资源类为“medium”层,详见此处。Playwright 的默认行为是将 worker 数量设置为检测到的核心数量(对于 medium 层,为 2)。将 worker 数量覆盖为大于此数字将导致不必要的超时和失败。
Jenkins
Jenkins 支持 pipelines 的 Docker agent。使用 Playwright Docker 镜像在 Jenkins 上运行测试。
pipeline {
agent { docker { image 'mcr.microsoft.com/playwright/java:v1.51.0-noble' } }
stages {
stage('e2e-tests') {
steps {
sh 'mvn -B install -D skipTests --no-transfer-progress'
sh 'mvn test'
}
}
}
}
Bitbucket Pipelines
Bitbucket Pipelines 可以使用公共 Docker 镜像作为构建环境。要在 Bitbucket 上运行 Playwright 测试,请使用我们的公共 Docker 镜像(参见 Dockerfile)。
image: mcr.microsoft.com/playwright/java:v1.51.0-noble
GitLab CI
要在 GitLab 上运行 Playwright 测试,请使用我们的公共 Docker 镜像(参见 Dockerfile)。
stages:
- test
tests:
stage: test
image: mcr.microsoft.com/playwright/java:v1.51.0-noble
script:
...
缓存浏览器
不建议缓存浏览器二进制文件,因为恢复缓存所需的时间与下载二进制文件所需的时间相当。尤其是在 Linux 下,需要安装操作系统依赖项,这些依赖项不可缓存。
如果您仍然想在 CI 运行之间缓存浏览器二进制文件,请在您的 CI 配置中缓存 这些目录,并根据 Playwright 版本的哈希值进行缓存。
调试浏览器启动
Playwright 支持 DEBUG
环境变量,用于在执行期间输出调试日志。将其设置为 pw:browser
在调试 Error: Failed to launch browser
错误时很有帮助。
DEBUG=pw:browser mvn test
以 headed 模式运行
默认情况下,Playwright 以 headless 模式启动浏览器。请参阅我们的运行测试指南,了解如何在 headed 模式下运行测试。
在 Linux 代理上,headed 模式执行需要安装 Xvfb。我们的 Docker 镜像和 GitHub Action 已预安装 Xvfb。要在带有 Xvfb 的 headed 模式下运行浏览器,请在实际命令前添加 xvfb-run
。
xvfb-run mvn test