Intégration CI/CD Playwright

Ce chapitre décrit comment intégrer les tests Playwright dans les pipelines CI/CD, y compris GitHub Actions et d'autres plateformes CI courantes.


Intégration GitHub Actions

Lorsque vousnpm init playwright@latestsélectionnez Add GitHub Actions, Playwright génère automatiquement la configuration du workflow.

Flux de travail auto-généré

Exemple

# Chemin du fichier : .github/workflows/playwright.yml
name
: Tests Playwright

sur
:
  push
:
    branches
: [main, master]
  pull_request
:
    branches
: [main, master]

jobs
:
  test
:
    timeout-minutes
: 60
    runs-on
: ubuntu-latest
    steps
:
      - uses
: actions/checkout@v4      # 1. Récupérer le code
      - uses
: actions/setup-node@v4     # 2. Installer Node.js
        with
:
          node-version
: 20
      - name
: Installer les dépendances
        run
: npm ci                     # 3. Installer les dépendances
      - name
: Installer les navigateurs Playwright
        run
: npx playwright install --with-deps  # 4. Installer les navigateurs et les dépendances système
      - name
: Exécuter les tests Playwright
        run
: npx playwright test        # 5. Exécuter les tests
      - uses
: actions/upload-artifact@v4
        if
: always()                    # 6. Téléverser le rapport de test (téléverser même si les tests échouent)
        with
:
          name
: playwright-report
          path
: playwright-report/
          retention-days
: 30

Afficher les résultats des tests CI

Afficher les journaux des tests

Dans la page Actions du dépôt GitHub, cliquez sur chaque exécution pour afficher les journaux détaillés des tests.

La sortie de chaque Worker est affichée indépendamment, ce qui facilite la localisation des tests échoués spécifiques.

Afficher le rapport HTML

Si vous avez configuréreporter: 'html', vous pouvez télécharger depuis Artifactsplaywright-report/pour afficher le rapport HTML complet localement.

Publier le rapport sur le Web

Exemple

# Chemin du fichier : .github/workflows/playwright.yml
# Déployer le rapport HTML sur GitHub Pages (exemple simplifié)
- name
: Téléverser le rapport
  uses
: actions/upload-artifact@v4
  if
: always()
  with
:
    name
: playwright-report
    path
: playwright-report/
    retention-days
: 30

Autres plateformes 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

Exemple

# Chemin du fichier : .gitlab-ci.yml
playwright-tests
:
  image
: mcr.microsoft.com/playwright:v1.52.0-jammy
  script
:
   - npm ci
    - npx playwright test
  artefacts
:
    when
: always
    chemins
:
     - playwright-report/
    expire_in
: 30 days

Exécuter Playwright avec Docker

Microsoft fournit une image Docker officielle avec toutes les dépendances système préinstallées, prête à l'emploi.

Utilisation de l'image officielle

# 拉取镜像
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

Exemple de Dockerfile

Exemple

# Chemin du fichier : 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"]

Bonnes pratiques pour les environnements CI

PratiqueDescription
Utiliser--with-depsnpx playwright install --with-depsInstaller automatiquement les dépendances système Linux
Verrouillez la version de PlaywrightDanspackage.jsonVerrouillez la version dans@playwright/testversion pour éviter les mises à niveau accidentelles en CI
Mettez en cache les navigateursCachems-playwrightrépertoire pour éviter de télécharger les navigateurs à chaque fois
Contrôlez le nombre de workersUtiliserworkers: process.env.CI ? 1 : undefinedpour contrôler l'utilisation des ressources en CI
Définissez le timeoutLes environnements CI sont plus lents qu'en local, augmentez en conséquencetimeoutetretries
Préservez les artefacts de testTéléversez Trace, les captures d'écran, les vidéos et les rapports en tant qu'artefacts CI
Autres extensions