Azurblauer Dramatiker

Azure Playwright ist ein vollständig verwalteter Azure-Dienst, der die Cloud verwendet, um Ihnen das gleichzeitige Ausführen von Playwright-Tests mit einer wesentlich höheren Parallelisierung über verschiedene Betriebssystem-Browser-Kombinationen hinweg zu ermöglichen. Dies bedeutet schnellere Testläufe mit einer breiteren Szenarioabdeckung, was dazu beiträgt, die Bereitstellung von Funktionen ohne Qualitätseinbußen zu beschleunigen. Mit Playwright-Arbeitsbereichen können Sie Funktionen schneller und sicherer freigeben.

Sind Sie bereit für die ersten Schritte? Springen Sie in unsere Schnellstartanleitung!

Nützliche Links

• Schnellstart: Ausführen von End-to-End-Tests im großen Stil
• Schnellstart: Einrichten von kontinuierlichen End-to-End-Tests über verschiedene Browser und Betriebssysteme hinweg
• Entdecken Sie Funktionen und Vorteile
• Dokumentation
• Preise
• Feedback teilen

Erste Schritte

Führen Sie die folgenden Schritte aus, um Ihre vorhandene Playwright-Testsuite mit dem Dienst auszuführen.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
• Ihrem Azure-Konto muss die Rolle "Besitzer", "Mitwirkender" oder eine der klassischen Administratorrollen zugewiesen sein.
• Die Azure CLI muss auf dem Computer installiert sein, von dem aus Sie Playwright-Tests ausführen.

Erstellen eines Arbeitsbereichs

1. Melden Sie sich mit Ihrem Azure-Konto beim Azure-Portal an.

2. Erstellen Sie den Arbeitsbereich.

   • Wählen Sie die Menüschaltfläche in der oberen linken Ecke des Portals aus, und wählen Sie dann Ressource erstellen aus.

     

   • Geben Sie Playwright Workspaces in das Suchfeld ein.

   • Wählen Sie die Karte Playwright-Arbeitsbereiche aus, und wählen Sie dann Erstellen aus.

     

   • Geben Sie die folgenden Informationen an, um einen neuen Playwright-Arbeitsbereich zu konfigurieren:

     Feld	Description
     Subscription	Wählen Sie das Azure-Abonnement aus, das Sie für diesen Playwright-Arbeitsbereich verwenden möchten.
     Ressourcengruppe	Wählen Sie eine vorhandene Ressourcengruppe aus. Klicken Sie auf Neu erstellen, und geben Sie einen eindeutigen Namen für die neue Ressourcengruppe ein.
     Name	Geben Sie einen eindeutigen Namen ein, um Ihren Arbeitsbereich zu identifizieren. Der Name darf nur aus alphanumerischen Zeichen bestehen und hat eine Länge zwischen 3 und 64 Zeichen.
     Ort	Wählen Sie einen geografischen Standort zum Hosten Ihres Arbeitsbereichs aus. Dieser Speicherort bestimmt auch, wo die Testausführungsergebnisse gespeichert werden.

     Hinweis

     Optional können Sie weitere Details auf der Registerkarte Tags konfigurieren. Tags sind Namens-Wert-Paare, mit denen Sie Ressourcen kategorisieren und eine konsolidierte Abrechnung anzeigen können, indem Sie dasselbe Tag auf mehrere Ressourcen und Ressourcengruppen anwenden.

   • Nachdem Sie die Ressource konfiguriert haben, wählen Sie Überprüfen und Erstellen aus.

   • Überprüfen Sie alle Konfigurationseinstellungen, und wählen Sie Erstellen aus, um die Bereitstellung des Playwright-Arbeitsbereichs zu starten.

   • Nachdem der Vorgang abgeschlossen wurde, wird eine Erfolgsmeldung zur Bereitstellung angezeigt.

   • Um den neuen Arbeitsbereich anzuzeigen, wählen Sie Zu Ressource wechseln aus.

     

Installieren des Azure Playwright-Pakets

1. Führen Sie diesen Befehl aus, um das Dienstpaket zu installieren

   npm init @azure/playwright
   

Bei der Installation des Dienstpakets wird eine Dienstkonfigurationsdatei mit dem Namen playwright.service.config.ts

Die Service-Konfiguration dient dazu:

• Leiten und authentifizieren Sie Playwright an die Playwright-Arbeitsbereiche.
• Überschreiben Sie bei Bedarf Zeitüberschreitungen für Dienstvorgänge.

Stellen Sie sicher, dass Ihr Projekt Version 1.47 oder höher verwendet @playwright/test .

Abrufen des Regionsendpunkts

1. Kopieren Sie im Azure-Portal den Befehl unter Regionsendpunkt hinzufügen in Ihrer Einrichtung.

   

   Die Endpunkt-URL entspricht der Arbeitsbereichsregion. Möglicherweise wird im Azure-Portal eine andere Endpunkt-URL angezeigt, abhängig von der Region, die Sie beim Erstellen des Arbeitsbereichs ausgewählt haben.

Einrichten der Umgebung

Stellen Sie sicher, dass die im vorherigen Schritt abgerufene Datei PLAYWRIGHT_SERVICE_URL in Ihrer Umgebung verfügbar ist.

Wir empfehlen, das Modul zu verwenden dotenv , um Ihre Umgebung zu verwalten. Mit dotenv verwenden Sie die .env Datei, um Ihre Umgebungsvariablen zu definieren.

Vergessen Sie nicht, .env Ihrer .gitignore Datei eine Datei hinzuzufügen, um Ihre Geheimnisse nicht preiszugeben.

npm i --save-dev dotenv

.env-Datei

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

Einrichten der Authentifizierung

Zum Ausführen Ihrer Playwright-Tests in Ihrem Azure Playwright-Arbeitsbereich müssen Sie den Playwright-Client authentifizieren, auf dem Sie die Tests mit dem Dienst ausführen. Dies könnte Ihr lokaler Entwicklungscomputer oder CI-Computer sein.

Der Dienst bietet zwei Authentifizierungsmethoden: Microsoft Entra ID und Zugriffstoken.

Microsoft Entra ID verwendet Ihre Azure-Anmeldeinformationen und erfordert eine Anmeldung bei Ihrem Azure-Konto für den sicheren Zugriff. Alternativ können Sie ein Zugriffstoken in Ihrem Playwright-Arbeitsbereich generieren und es in Ihrem Setup verwenden.

Einrichten der Authentifizierung mit Microsoft Entra ID

Microsoft Entra ID ist die Standardauthentifizierung und empfohlene Authentifizierung für den Dienst. Auf Ihrem lokalen Entwicklungscomputer können Sie die Azure CLI verwenden, um sich anzumelden

az login

HINWEIS: Wenn Sie Teil mehrerer Microsoft Entra Mandanten sind, stellen Sie sicher, dass Sie sich bei dem Mandanten anmelden, zu dem Ihr Arbeitsbereich gehört. Sie können die Mandanten-ID über das Azure-Portal abrufen, siehe Suchen Ihres Microsoft Entra Mandanten. Sobald Sie die ID abgerufen haben, melden Sie sich mithilfe des Befehls az login --tenant <TenantID> an

Einrichten der Authentifizierung mithilfe von Zugriffstoken

Sie können ein Zugriffstoken aus Ihrem Azure Playwright-Arbeitsbereich generieren und in Ihrem Setup verwenden. Aufgrund der erhöhten Sicherheit empfehlen wir jedoch dringend Microsoft Entra ID für die Authentifizierung. Zugriffstoken sind zwar praktisch, funktionieren jedoch wie langlebige Kennwörter und sind anfälliger für Kompromittierungen.

1. Um die Zugriffstoken-basierte Authentifizierung zu verwenden, aktivieren Sie die Zugriffstoken-basierte Authentifizierung.

2. Einrichten der Authentifizierung mithilfe von Zugriffstoken

Es wird dringend empfohlen, Microsoft Entra ID für die Authentifizierung bei dem Dienst zu verwenden. Wenn Sie Zugriffstoken verwenden, finden Sie weitere Informationen unter Verwalten von Zugriffstoken.

ANMERKUNG: Um Azure Playwright in CI-Pipelines zu verwenden, müssen Sie die Authentifizierung mit dem Dienst aus der Pipeline konfigurieren, siehe Einrichten kontinuierlicher End-to-End-Tests über verschiedene Browser und Betriebssysteme hinweg.

Ausführen der Tests

Führen Sie Playwright-Tests mit Browsern aus, die vom Dienst verwaltet werden, indem Sie die oben erstellte Konfiguration verwenden.

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

Nächste Schritte

• Führen Sie Tests in einer CI/CD-Pipeline aus.

• Erfahren Sie, wie Sie den Zugriff auf den erstellten Arbeitsbereich verwalten.

• Experimentieren Sie mit einer unterschiedlichen Anzahl von Workern, um die optimale Konfiguration Ihrer Testsuite zu ermitteln.

Contributing

Dieses Projekt begrüßt Beiträge und Anregungen. Die meisten Beiträge erfordern, dass Sie einem Contributor License Agreement (CLA) zustimmen, in dem Sie erklären, dass Sie das Recht haben, uns die Rechte zur Nutzung Ihres Beitrags zu gewähren, und dies auch tatsächlich tun. Ausführliche Informationen finden Sie unter https://cla.opensource.microsoft.com.

Wenn Sie einen Pull-Request einreichen, bestimmt ein CLA-Bot automatisch, ob Sie einen CLA bereitstellen müssen, und dekoriert die PR entsprechend (z. B. Statusprüfung, Kommentar). Folgen Sie einfach den Anweisungen des Bots. Sie müssen dies nur einmal für alle Repos mit unserem CLA tun.

Dieses Projekt hat den Microsoft Open Source Code of Conduct übernommen. Weitere Informationen finden Sie in den FAQ zum Verhaltenskodex oder bei weiteren Fragen oder Kommentaren wenden Sie sich an uns opencode@microsoft.com .

Handelsmarken

Dieses Projekt kann Marken oder Logos für Projekte, Produkte oder Dienstleistungen enthalten. Die autorisierte Verwendung von Microsoft-Marken oder -Logos unterliegt den Marken- und Markenrichtlinien von Microsoft und muss diesen befolgen. Die Verwendung von Microsoft-Marken oder -Logos in modifizierten Versionen dieses Projekts darf keine Verwirrung stiften oder ein Sponsoring durch Microsoft implizieren. Jegliche Verwendung von Marken oder Logos Dritter unterliegt den Richtlinien dieser Drittanbieter.