Azure Dramaturge

Azure Playwright est un service Azure entièrement managé qui utilise le cloud pour vous permettre d’exécuter des tests Playwright avec une parallélisation beaucoup plus élevée sur différentes combinaisons système d’exploitation-navigateur simultanément. Cela signifie des tests plus rapides avec une couverture de scénario plus large, ce qui permet d’accélérer la livraison des fonctionnalités sans sacrifier la qualité. Avec les espaces de travail Playwright, vous pouvez publier des fonctionnalités plus rapidement et en toute confiance.

Prêt à commencer ? Plongez dans notre guide de démarrage rapide !

Liens utiles

• Démarrage rapide : Exécuter des tests de bout en bout à grande échelle
• Démarrage rapide : Configurez des tests continus de bout en bout sur différents navigateurs et systèmes d’exploitation
• Explorer les fonctionnalités et les avantages
• Documentation
• Tarification
• Partager des commentaires

Get Started

Suivez ces étapes pour exécuter votre suite de tests Playwright existante avec le service.

Prerequisites

• 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 doit se voir attribuer le rôle Propriétaire, Contributeur ou l’un des rôles d’administrateur classique.
• Azure CLI doit être installé sur l’ordinateur à partir duquel vous exécutez les tests Playwright.

Créer un espace de travail

1. Connectez-vous au portail Azure avec votre compte Azure.

2. Créez l’espace de travail.

   • Sélectionnez le bouton de menu dans le coin supérieur gauche du portail, puis sélectionnez Créer une ressource.

     

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

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

     

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

     Terrain	Descriptif
     Subscription	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 être composé que de caractères alphanumériques et avoir une longueur comprise entre 3 et 64 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.

     Note

     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.

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

   • 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.

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

     

Installer le package Azure Playwright

1. Exécutez cette commande pour installer le package de service

   npm init @azure/playwright
   

L’installation du package de service créera un fichier de configuration de service nommé playwright.service.config.ts

La configuration du service sert à :

• Dirigez et authentifiez Playwright dans les espaces de travail Playwright.
• Remplacez les délais d’expiration pour les opérations de service, si nécessaire.

Assurez-vous que votre projet utilise @playwright/test la version 1.47 ou ultérieure.

Obtenir le point de terminaison de la région

1. Dans le portail Azure, copiez la commande sous Ajouter un point de terminaison de région dans votre configuration.

   

   L’URL du point de terminaison correspond à la région de l’espace de travail. Il se peut que l’URL d’un point de terminaison différente s’affiche dans le portail Azure, en fonction de la région que vous avez sélectionnée lors de la création de l’espace de travail.

Configurer l’environnement

Assurez-vous que le fichier obtenu à l’étape PLAYWRIGHT_SERVICE_URL précédente est disponible dans votre environnement.

Nous vous recommandons d’utiliser dotenv le module pour gérer votre environnement. Avec dotenv vous allez utiliser le .env fichier pour définir vos variables d’environnement.

N’oubliez pas d’ajouter .env un fichier à votre .gitignore fichier afin de ne pas divulguer vos secrets.

npm i --save-dev dotenv

Fichier .env

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/playwrightworkspaces/workspace-id/browsers

Configurer l’authentification

Pour exécuter vos tests Playwright dans votre espace de travail Azure Playwright, vous devez authentifier le client Playwright sur lequel 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

REMARQUE : Si vous faites partie de plusieurs locataires Microsoft Entra, assurez-vous de vous connecter au locataire auquel appartient votre espace de travail. Vous pouvez obtenir l’ID de locataire à partir du portail Azure, consultez Rechercher votre locataire Microsoft Entra. Une fois l’ID obtenu, connectez-vous à l’aide de la commande az login --tenant <TenantID>

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 Azure 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. Pour utiliser l’authentification basée sur les jetons d’accès, activez l’authentification basée sur les jetons d’accès

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

Nous vous recommandons vivement d’utiliser Microsoft Entra ID pour l’authentification au service. Si vous utilisez des jetons d’accès, consultez Comment gérer les jetons d’accès

NOTE: Pour utiliser Azure Playwright dans les pipelines CI, vous devez configurer l’authentification avec le service à partir du pipeline, consultez Configurer des tests continus de bout en bout sur différents navigateurs et systèmes d’exploitation

Exécutez les tests

Exécutez des tests Playwright sur les navigateurs gérés par le service en utilisant la configuration créée ci-dessus.

npx playwright test --config=playwright.service.config.ts --workers=20

Étapes suivantes

• Exécutez des tests dans un pipeline CI/CD.

• Découvrez comment gérer l’accès à l’espace de travail créé.

• Testez avec différents nombres de workers pour déterminer la configuration optimale de votre suite de tests.

Contribution

Ce projet accueille les contributions et les suggestions. La plupart des contributions exigent que vous acceptiez un contrat de licence de contributeur (CLA) déclarant que vous avez le droit de nous accorder les droits d’utilisation de votre contribution, et que vous le faites effectivement. Pour plus d’informations, visitez https://cla.opensource.microsoft.com.

Lorsque vous soumettez une demande de tirage, un bot CLA détermine automatiquement si vous devez fournir un CLA et décorer le PR de manière appropriée (par exemple, vérification de statut, commentaire). Il suffit de suivre les instructions fournies par le bot. Vous n’aurez besoin de le faire qu’une seule fois pour tous les dépôts utilisant notre CLA.

Ce projet a adopté le Code de conduite open source de Microsoft. Pour plus d’informations, consultez la FAQ sur le Code de conduite ou contactez-nous opencode@microsoft.com pour toute question ou commentaire supplémentaire.

Marques

Ce projet peut contenir des marques commerciales ou des logos pour des projets, des produits ou des services. L’utilisation autorisée des marques commerciales ou des logos Microsoft est soumise aux directives de Microsoft en matière de marques commerciales et de marques et doit les respecter. L’utilisation des marques commerciales ou des logos Microsoft dans les versions modifiées de ce projet ne doit pas prêter à confusion ou impliquer le parrainage de Microsoft. Toute utilisation de marques ou de logos de tiers est soumise aux politiques de ces tiers.