Démarrage rapide : exécuter des tests de bout en bout à grande échelle avec des espaces de travail Playwright

Dans ce démarrage rapide, vous apprenez à exécuter vos tests Playwright avec des navigateurs cloud hautement parallèles en utilisant des espaces de travail Playwright. Utilisez l’infrastructure cloud pour valider votre application sur différents navigateurs, appareils et systèmes d’exploitation.

Une fois ce démarrage rapide terminé, vous disposez d’un espace de travail Playwright pour exécuter vos tests Playwright à grande échelle.

Conditions préalables

• Un compte Azure avec un abonnement actif. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
• Votre compte Azure a besoin des rôles Propriétaire, Contributeur ou de l’un des rôles d’administrateur classique.
• Un projet Playwright. Si vous n’avez aucun projet, créez-en un en utilisant la Documentation Bien démarrer avec Playwright ou utilisez notre Exemple de projet d’espaces de travail Playwright.
• Azure CLI. Si vous ne disposez pas d’Azure CLI, consultez Installer Azure CLI.

Créer un espace de travail

Pour commencer à exécuter vos tests Playwright sur les navigateurs cloud, vous devez d’abord créer un espace de travail Playwright.

1. Connectez-vous au portail Azure.

2. Sélectionnez le bouton du menu en haut à gauche du portail, puis une ressource Créer une ressource.

   

3. Entrez Espaces de travail Playwright dans la zone de recherche.

4. Sélectionnez la carte Espaces de travail Playwright, puis Créer.

   

5. Fournissez les informations suivantes pour configurer un nouvel espace de travail Playwright :

   Champ	Descriptif
   Abonnement	Sélectionnez l’abonnement Azure que vous souhaitez utiliser pour cet espace de travail Playwright.
   Groupe de ressources	Sélectionnez un groupe de ressources existant. Cliquez sur Créer nouveau, puis entrez un nom unique pour le nouveau groupe de ressources.
   Nom	Entrez un nom unique pour identifier votre espace de travail. Le nom ne peut contenir que des caractères alphanumériques et des traits d’union et avoir une longueur comprise entre 3 et 24 caractères.
   Lieu	Sélectionnez un emplacement géographique pour héberger votre espace de travail. Cet emplacement détermine également l’emplacement de stockage des résultats de l’exécution des tests.

   Remarque

   Vous pouvez aussi configurer plus de détails sous l’onglet Étiquettes. Les étiquettes sont des paires nom/valeur qui vous permettent de catégoriser les ressources et d’afficher une facturation centralisée en appliquant la même étiquette à plusieurs ressources et groupes de ressources.

6. Lorsque vous avez terminé de configurer la ressource, sélectionnez Vérifier + créer.

7. Passez en revue tous les paramètres de configuration, puis sélectionnez Créer pour démarrer le déploiement de l’espace de travail Playwright.

   Une fois le processus terminé, un message indiquant la réussite du déploiement s’affiche.

8. Pour afficher le nouvel espace de travail, sélectionnez Accéder à la ressource.

   

Installer le package Espaces de travail Playwright

npm init @azure/playwright@latest

dotnet add package Azure.Developer.Playwright.NUnit

Configurer le point de terminaison du navigateur

Dans votre configuration, vous devez fournir le point de terminaison de navigateur spécifique à la région. Le point de terminaison dépend de la région Azure sélectionnée lors de la création de l’espace de travail.

Pour obtenir l’URL du point de terminaison du navigateur, procédez comme suit :

1. Connectez-vous au Portail Azure avec votre compte Azure et accédez à votre espace de travail.

2. Sélectionnez la page Prise en main.

   

3. Dans Ajouter le point de terminaison du navigateur à votre configuration, copiez l’URL du point de terminaison.

   Vérifiez que cette URL est disponible dans la variable d’environnement PLAYWRIGHT_SERVICE_URL.

   

using Azure.Developer.Playwright.NUnit;
using Azure.Identity;

namespace PlaywrightTests; // Remember to change this as per your project namespace

[SetUpFixture]
public class PlaywrightServiceNUnitSetup  : PlaywrightServiceBrowserNUnit
{
    public PlaywrightServiceNUnitSetup() : base(
        credential: new DefaultAzureCredential()
    ) 
    {}
}

Configurer l’authentification

Pour exécuter vos tests Playwright dans votre espace de travail Playwright, vous devez authentifier le client Playwright où vous exécutez les tests avec le service. Il peut s’agir de votre machine de développement local ou de votre machine CI.

Le service offre deux méthodes d’authentification : Microsoft Entra ID et les Jetons d’accès.

Microsoft Entra ID utilise vos informations d’identification Azure, nécessitant une connexion à votre compte Azure pour un accès sécurisé. Vous pouvez également générer un jeton d’accès à partir de votre espace de travail Playwright et l’utiliser dans votre configuration.

Configurer l’authentification à l’aide de Microsoft Entra ID

Microsoft Entra ID est l’authentification par défaut recommandée pour le service. À partir de votre machine de développement locale, vous pouvez utiliser Azure CLI pour vous connecter

az login

Configurer l’authentification à l’aide de jetons d’accès

Vous pouvez générer un jeton d’accès à partir de votre espace de travail Playwright et l’utiliser dans votre configuration. Toutefois, nous recommandons vivement Microsoft Entra ID pour l’authentification en raison de sa sécurité renforcée. Les jetons d’accès, bien que pratiques, fonctionnent comme des mots de passe de longue durée et sont plus susceptibles d’être compromis.

1. L’authentification à l’aide de jetons d’accès est désactivée par défaut. Pour l’utiliser, Activer l’authentification basée sur les jetons d’accès.

2. Configurez l’authentification en utilisant des jetons d’accès.

Exécuter vos tests à grande échelle avec des espaces de travail Playwright

dotnet test -- NUnit.NumberOfTestWorkers=20

Starting test execution, please wait...

A total of 100 test files matched the specified pattern.

Passed!  - Failed:     0, Passed:     100, Skipped:     0, Total:     100, Duration: 59 s - PlaywrightTestsNUnit.dll (net7.0)

Workload updates are available. Run `dotnet workload list` for more information.

Optimiser la configuration des workers parallèles

Une fois que vos tests s’exécutent correctement avec le service, essayez de varier le nombre de workers parallèles afin de déterminer la configuration optimale pour minimiser la durée d’exécution des tests.

Grâce aux espaces de travail Playwright, vous pouvez exécuter avec jusqu’à 50 Workers parallèles. Plusieurs facteurs ont un impact sur la meilleure configuration pour votre projet, notamment le processeur, la mémoire et les ressources réseau de votre ordinateur client, la capacité de gestion de la charge de l’application cible et le type d’actions effectuées dans vos tests.

Découvrez comment déterminer la configuration optimale pour optimiser l’exécution de la suite de tests.

Étape suivante

Vous avez créé un espace de travail Playwright dans le Portail Azure et exécuté vos tests Playwright sur les navigateurs cloud.

Passez au guide de démarrage rapide suivant pour configurer des tests de bout en bout en continu grâce aux tests Playwright dans votre flux de travail CI/CD.