Integración de Playwright CI/CD
Este capítulo explica cómo integrar las pruebas de Playwright en un pipeline de CI/CD, incluyendo GitHub Actions y otras plataformas de CI comunes.
Integración con GitHub Actions
Cuando estés ennpm init playwright@latestselecciona agregar GitHub Actions, Playwright generará automáticamente la configuración del flujo de trabajo.
Flujo de trabajo generado automáticamente
Ejemplo
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 # 1. Checkout del código
- uses: actions/setup-node@v4 # 2. Instalar Node.js
with:
node-version: 20
- name: Install dependencies
run: npm ci # 3. Instalar dependencias
- name: Install Playwright Browsers
run: npx playwright install --with-deps # 4. Instalar navegadores y dependencias del sistema
- name: Run Playwright tests
run: npx playwright test # 5. Ejecutar las pruebas
- uses: actions/upload-artifact@v4
if: always() # 6. Subir el informe de pruebas (subirlo incluso si las pruebas fallan)
with:
name: playwright-report
path: playwright-report/
retention-days: 30
Ver resultados de pruebas de CI
Ver registros de pruebas
En la página de Actions del repositorio de GitHub, haz clic en cada ejecución para ver los registros detallados de las pruebas.
La salida de cada Worker se muestra de forma independiente, lo que facilita localizar las pruebas específicas que fallan.
Ver el informe HTML
Si has configuradoreporter: 'html', puedes descargar desde Artifactsplaywright-report/para ver el informe HTML completo localmente.
Publicar el informe en la web
Ejemplo
# Desplegar el informe HTML en GitHub Pages (ejemplo simplificado)
- name: Upload report
uses: actions/upload-artifact@v4
if: always()
with:
name: playwright-report
path: playwright-report/
retention-days: 30
Otras plataformas de CI
Jenkins
pipeline {
agent any
stages {
stage('Install') {
steps {
sh 'npm ci'
sh 'npx playwright install --with-deps'
}
}
stage('Test') {
steps {
sh 'npx playwright test'
}
}
}
post {
always {
archiveArtifacts artifacts: 'playwright-report/**'
junit 'test-results/junit.xml'
}
}
}
GitLab CI
Ejemplo
playwright-tests:
image: mcr.microsoft.com/playwright:v1.52.0-jammy
script:
- npm ci
- npx playwright test
artifacts:
when: always
paths:
- playwright-report/
expire_in: 30 days
Ejecutar Playwright con Docker
Microsoft proporciona imágenes oficiales de Docker con todas las dependencias del sistema preinstaladas, listas para usar.
Usar la imagen oficial
# 拉取镜像 docker pull mcr.microsoft.com/playwright:v1.52.0-jammy # 在容器中运行测试 docker run --rm -v $(pwd):/work -w /work \ mcr.microsoft.com/playwright:v1.52.0-jammy \ npx playwright test
Ejemplo de Dockerfile
Ejemplo
FROM mcr.microsoft.com/playwright:v1.52.0-jammy
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
CMD ["npx", "playwright", "test"]
Mejores prácticas para entornos de CI
| Práctica | Descripción |
|---|---|
Usar--with-deps | npx playwright install --with-depspara instalar automáticamente las dependencias del sistema Linux |
| Fijar la versión de Playwright | Enpackage.jsonbloquear@playwright/testla versión, para evitar actualizaciones inesperadas en CI |
| Cachear los navegadores | Cachearms-playwrightel directorio, para evitar descargar los navegadores cada vez |
| Controlar el número de workers | Usarworkers: process.env.CI ? 1 : undefinedpara controlar el uso de recursos en CI |
| Establecer timeout | El entorno de CI es más lento que el local; aumenta adecuadamentetimeoutyretries |
| Conservar los artefactos de prueba | Subir Trace, capturas de pantalla, videos e informes como CI Artifacts |