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

# Ruta del archivo: .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      # 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

# Ruta del archivo: .github/workflows/playwright.yml
# 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

# Ruta del archivo: .gitlab-ci.yml
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

# Ruta del archivo: Dockerfile
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ácticaDescripción
Usar--with-depsnpx playwright install --with-depspara instalar automáticamente las dependencias del sistema Linux
Fijar la versión de PlaywrightEnpackage.jsonbloquear@playwright/testla versión, para evitar actualizaciones inesperadas en CI
Cachear los navegadoresCachearms-playwrightel directorio, para evitar descargar los navegadores cada vez
Controlar el número de workersUsarworkers: process.env.CI ? 1 : undefinedpara controlar el uso de recursos en CI
Establecer timeoutEl entorno de CI es más lento que el local; aumenta adecuadamentetimeoutyretries
Conservar los artefactos de pruebaSubir Trace, capturas de pantalla, videos e informes como CI Artifacts
Otras extensiones