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
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
# 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
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
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
| Pratique | Description |
|---|---|
Utiliser--with-deps | npx playwright install --with-depsInstaller automatiquement les dépendances système Linux |
| Verrouillez la version de Playwright | Danspackage.jsonVerrouillez la version dans@playwright/testversion pour éviter les mises à niveau accidentelles en CI |
| Mettez en cache les navigateurs | Cachems-playwrightrépertoire pour éviter de télécharger les navigateurs à chaque fois |
| Contrôlez le nombre de workers | Utiliserworkers: process.env.CI ? 1 : undefinedpour contrôler l'utilisation des ressources en CI |
| Définissez le timeout | Les environnements CI sont plus lents qu'en local, augmentez en conséquencetimeoutetretries |
| Préservez les artefacts de test | Téléversez Trace, les captures d'écran, les vidéos et les rapports en tant qu'artefacts CI |