Automatisieren Sie Tests mit Azure Pipelines mit YAML

Artikel
04/25/2023

In diesem Artikel erfahren Sie, wie Sie Ihre in Test Studio erstellten Canvas App-Tests mit Hilfe einer YAML-Pipeline in Azure DevOps Services einrichten und ausführen können.

Sie können ein öffentliches Projekt auf GitHub—Microsoft/PowerAppsTestAutomation—verwenden, um:

Automatisieren Sie den Vorgang der Anmeldung bei Ihrer Bewerbung.
Öffnen Sie einen Browser auf dem Build-Agent und führen Sie eine Reihe von Testfällen und Suites aus.
Zeigen Sie den Status der Testausführung in der Azure DevOps-Pipeline an.

Anforderungen

Bevor Sie beginnen, müssen Sie die folgenden Schritte ausführen:

Fork das Microsoft/PowerAppsTestAutomation Projekt auf GitHub.

Hinweis

Öffentliche Forks können nicht als privat deklariert werden. Wenn Sie ein privates Repo erstellen möchten, müssen Sie das Repository duplizieren.
Erstellen Sie eine neue Test-URLs .json-Datei, die die App-Test-URLs enthält, die Sie von der Pipeline aus ausführen möchten.
Erstellen Sie eine neue Azure Pipelines YAML-Datei.
Erstellen Sie eine GitHub Service-Verbindung zu Ihrem Repo.

Schritt 1 - Fork das Projekt PowerAppsTestAutomation

Eine Fork ist eine Kopie eines Repositorys. Durch Forken eines Repositorys können Sie Änderungen vornehmen, ohne das ursprüngliche Projekt zu beeinträchtigen.

Bei GitHub anmelden.
Gehen Sie zum microsoft/PowerAppsTestAutomation Repository. Sie können stattdessen auch nach microsoft/PowerAppsTestAutomation suchen und dann das Repository auswählen.
Wählen Sie Fork.
Wählen Sie aus, wo Sie die Verzweigung positionieren möchten.

Ihr Fork-Repository wird nun verfügbar sein.

Schritt 2 - Erstellen Sie eine Test-URL .json-Datei

Die .json-Datei mit der Test-URL enthält die URLs der Testsuite und der Testfälle zur Validierung Ihrer Apps. Die URLs der App-Test-Suite und der Testfälle können durch Auswahl des Links Copy play link in Test Studio abgerufen werden.

Sie finden eine Beispieldatei, Samples/TestAutomationURLs.json, in dem Repo, das Sie zuvor erstellt haben.

Erstellen Sie eine neue Datei mit dem Namen TestURLs.json in Ihrem Repo oder verwenden Sie einen beliebigen anderen Dateinamen. Der Dateiname und der Speicherort werden später im Dokument in den Pipeline-Variablen zugeordnet.
Kopieren Sie das Format aus der Datei Samples/TestAutomationURLs.json.
Aktualisieren Sie den Abschnitt Test-URLs mit den Tests, die Sie in Ihrer Apps validieren möchten.
Übernehmen Sie die Änderungen an Ihrem Repo.

Schritt 3 - Erstellen einer Azure Pipelines YAML-Datei

Eine Beispieldatei, Samples/azure-pipelines.yml, finden Sie in dem Repo, das Sie zuvor erstellt haben.

Erstellen Sie eine neue Datei namens azure-pipelines.yml in Ihrem Repo.
Kopieren Sie den Inhalt aus der Datei Samples/azure-pipelines.yml.
Übernehmen Sie die Änderungen an Ihrem Repo. Sie referenzieren und aktualisieren die Datei azure-pipelines.yml, wenn Sie Ihre Pipeline in Schritt 4 konfigurieren.

Schritt 4 - Erstellen Sie eine GitHub-Serviceverbindung

Melden Sie sich bei Ihrer Azure DevOps-Instanz an.
Wählen Sie ein vorhandenes Projekt oder erstellen Sie ein neues Projekt.
Wählen Sie Projekteinstellungen unten im linken Navigationsfenster.
Wählen Sie unter Pipelines Service-Verbindungen.
Wählen Sie Dienstleistungsverbindung erstellen.
Wählen Sie den Dienst GitHub.
Klicken Sie auf Weiter.
Unter OAuth Konfiguration, wählen Sie AzurePipelines.
Wählen Sie Autorisieren aus.
Optional können Sie den Dienstverbindungsname aktualisieren.
Wählen Sie Speichern aus.

Erstellen einer Pipeline

Wählen Sie Pipelines im linken Navigationsbereich.
Wählen Sie Pipeline erstellen.
Wählen Sie GitHub YAML.
Suchen Sie nach Ihrem Repo oder wählen Sie ihn aus.
Wählen Sie Existierende Azure Pipelines YAML-Datei.
Setzen Sie den Pfad zu der zuvor erstellten Azure YAML-Pipeline-Datei.
Wählen Sie Fortsetzen aus:

Die Datei azure-pipelines.yml wird angezeigt.
Aktualisieren Sie Repositoriename auf den Namen Ihres Repos.
Aktualisieren Sie Endpunkt auf den Namen der GitHub-Serviceverbindung, die Sie zuvor erstellt haben.
Aktualisieren Sie den TestAutomationURLs Dateinamen. Dies ist die Test-URLs .json-Datei Datei, die Sie zuvor erstellt haben.
Aktualisieren Sie den Wert LocalProjectName auf Ihren Repo-Namen, falls Sie ihn geändert haben.
Aktualisieren Sie den Abschnitt TestAutomationURLFilePath mit der Position der Test-URLs .json-Datei in Ihrem Repo.
Wählen Sie Variablen.
Fügen Sie eine Variable mit dem Namen OnlineUsername hinzu und setzen Sie den Wert auf die Microsoft Entra E-Mail-Adresse des Benutzerkontextes, der sich bei der Anwendung anmelden wird. Die Tests werden im Kontext dieses Benutzerkontos ausgeführt.
Klicken Sie auf OK.
Fügen Sie eine weitere Variable mit dem Namen OnlinePassword hinzu. Setzen Sie den Wert auf das Passwort des zuvor erstellten Microsoft Entra Kontos.
Wählen Sie Halten Sie diesen Wert geheim und Benutzer können diesen Wert beim Ausführen dieser Pipeline überschreiben.
Speichern und Commit die Änderungen an Ihrem Repo.

Tests ausführen und analysieren

Um zu überprüfen, ob Ihre Tests erfolgreich durchgeführt werden, wählen Sie Ausführen. Optional können Sie das Server-Image zur Durchführung Ihrer Tests und auch die Browser-Typen auswählen.

Auftrag ausführen

Wenn der Auftrag läuft, wählen Sie ihn aus, um den detaillierten Status für jede der laufenden Aufgaben zu sehen.

Auftragsdetails

Wenn der Job abgeschlossen ist, können Sie die Job-Zusammenfassung auf hoher Ebene und alle Fehler oder Warnungen anzeigen. Wenn Sie das Register Test wählen, können Sie bestimmte Details zu den ausgeführten Testfällen anzeigen.

Das folgende Beispiel zeigt an, dass mindestens einer unserer Testfälle bei der Ausführung der Tests mit dem Chrome-Browser fehlgeschlagen ist.

Chrome – fehlgeschlagen

Wählen Sie RunTestAutomation, um die Details zu den fehlgeschlagenen Testfällen anzuzeigen.. Auf der Registerkarte Anhänge sehen Sie die Zusammenfassung der Testdurchführung und welche Testfälle in Ihrer Testsuite fehlgeschlagen oder bestanden sind.

Registerkarte Anhänge

Hinweis

Wenn Sie eine Testsuite ausführen, sehen Sie eine Zusammenfassung der bestandenen und fehlgeschlagenen Testfälle. Wenn Sie einen Testfall ausführen, sehen Sie spezifische Details über den Fehler mit allen Rückverfolgungsinformationen, falls verfügbar.

Bekannte Einschränkungen

Die Multi-Faktor-Authentifizierung wird nicht unterstützt.
In der Testzusammenfassung wird ein einziges Testergebnis pro Browser angezeigt. Das Testergebnis wird einen oder mehrere Testfälle oder Testsuitergebnisse enthalten.
Für jeden anderen Authentifizierungsprozess als die Anmeldung bei Microsoft Entra müssen Sie den Anmeldeprozess in der Lösung PowerAppsTestAutomation anpassen.

Siehe auch