Erstellen Ihrer ersten Pipeline

Dies ist eine schrittweise Anleitung zur Verwendung von Azure Pipelines zum Erstellen einer Beispielanwendung aus einem Git-Repository. In dieser Anleitung werden YAML-Pipelines verwendet, die mit dem YAML-Pipeline-Editor konfiguriert sind.

Weitere Informationen zu den verschiedenen Abschnitten in einer YAML-Pipeline finden Sie in der Pipeline im Azure Pipelines YAML-Schema und Anpassen Ihrer YAML-Pipeline.

Wenn Sie stattdessen klassische Pipelines verwenden möchten, lesen Sie Definieren Ihrer klassischen Pipeline. Anleitungen zur Verwendung von TFVC finden Sie unter Erstellen von TFVC-Repositorys.

Voraussetzungen: Azure DevOps

Stellen Sie sicher, dass Sie über Folgendes verfügen:

• Ein GitHub-Konto, in dem Sie ein Repository erstellen können. Erstellen Sie ein kostenloses Konto.

• Eine Azure DevOps-Organisation. Erstellen Sie ein kostenloses Konto. Wenn Ihr Team bereits über eine solche Organisation verfügt, stellen Sie sicher, dass Sie Administrator des Azure DevOps-Projekts sind, das Sie verwenden möchten.

• Möglichkeit zum Ausführen von Pipelines auf von Microsoft gehosteten Agents. Um von Microsoft gehostete Agents zu verwenden, muss Ihre Azure DevOps-Organisation über Zugriff auf von Microsoft gehostete Parallelaufträge verfügen. Sie können entweder einen Parallelauftrag erwerben oder eine kostenlose Bewilligung anfordern.

Erstellen Ihrer ersten Pipeline

https://github.com/MicrosoftDocs/pipelines-java

https://github.com/MicrosoftDocs/pipelines-dotnet-core

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

https://github.com/Azure-Samples/js-e2e-express-server

Anzeigen und Verwalten Ihrer Pipelines

Sie können Ihre Pipelines anzeigen und verwalten, indem Sie im Menü auf der linken Seite Pipelines auswählen, um zur Zielseite für Pipelines zu wechseln.

Auf der Zielseite für Pipelines können Sie Pipelines und Pipelineausführungen anzeigen, Pipelines erstellen und importieren, die Sicherheit verwalten und einen Drilldown zu Pipeline- und Ausführungsdetails ausführen.

Wählen Sie Zuletzt verwendet aus, um zuletzt ausgeführte Pipelines anzuzeigen (die Standardansicht), oder wählen Sie Alle aus, um alle Pipelines anzuzeigen.

Wählen Sie eine Pipeline aus, um diese Pipeline zu verwalten, und zeigen Sie die Ausführungen an. Wählen Sie die Buildnummer für die letzte Ausführung aus, um die Ergebnisse dieses Builds anzuzeigen, wählen Sie den Branchnamen aus, um den Branch für diese Ausführung anzuzeigen, oder wählen Sie das Kontextmenü aus, um die Pipeline auszuführen und andere Verwaltungsaktionen auszuführen.

Wählen Sie Ausführungen aus, um alle Pipelineausführungen anzuzeigen. Optional können Sie die angezeigten Ausführungen filtern.

Wählen Sie eine Pipelineausführung aus, um Informationen zu dieser Ausführung anzuzeigen.

Sie können im Kontextmenü wählen, ob Sie eine Ausführung beibehalten oder löschen möchten. Weitere Informationen zur Aufbewahrung der Ausführungen finden Sie unter Aufbewahrungsrichtlinien für Builds und Releases.

Anzeigen von Pipelinedetails

Auf der Detailseite für eine Pipeline können Sie diese Pipeline anzeigen und verwalten.

Wählen Sie Bearbeiten aus, um Ihre Pipeline zu bearbeiten. Weitere Informationen finden Sie unter YAML-Pipeline-Editor. Sie können Ihre Pipeline auch bearbeiten, indem Sie die Datei azure-pipelines.yml direkt im Repository ändern, in dem die Pipeline gehostet wird.

Anzeigen von Details zur Pipelineausführung

In der Zusammenfassung der Pipelineausführung können Sie den Status Ihrer Ausführung sowohl während der Ausführung als auch nach Abschluss anzeigen.

Im Zusammenfassungsbereich können Sie Details zu Aufträgen und Stages anzeigen, Artefakte herunterladen und zu verknüpften Commits, Testergebnissen und Arbeitselementen navigieren.

Aufträge und Phasen

Im Aufgabenbereich wird eine Übersicht über den Status Ihrer Stages und Aufträge angezeigt. Dieser Bereich kann mehrere Registerkarten aufweisen, je nachdem, ob Ihre Pipeline über Stages und Aufträge oder nur über Aufträge verfügt. In diesem Beispiel verfügt die Pipeline über zwei Stages mit dem Namen Build und Deploy. Sie können einen Drilldown zu den Pipelineschritten durchführen, indem Sie den Auftrag entweder im Bereich Stages oder im Bereich Aufträge auswählen.

Wählen Sie einen Auftrag aus, um die Schritte für diesen Auftrag anzuzeigen.

In der Schrittansicht können Sie den Status und Details der einzelnen Schritte überprüfen. Sie können in Weitere Aktionen zwischen Zeitstempeln wechseln oder ein unformatiertes Protokoll aller Schritte in der Pipeline anzeigen.

Abbrechen und erneutes Ausführen einer Pipeline

Wenn die Pipeline ausgeführt wird, können Sie sie abbrechen, indem Sie Abbrechen auswählen. Wenn die Ausführung abgeschlossen ist, können Sie die Pipeline erneut ausführen, indem Sie Neu ausführen auswählen.

Menü mit weiteren Aktionen für die Pipelineausführung

Sie können über das Menü Weitere Aktionen Protokolle herunterladen, Tags hinzufügen, die Pipeline bearbeiten, die Ausführung löschen und die Aufbewahrung für die Ausführung konfigurieren.

Hinzufügen eines Statusbadge zu Ihrem Repository

Viele Entwickler möchten gerne demonstrieren, dass sie eine durchgängig hohe Codequalität bieten, indem sie in Ihrem Repository einen Statusbadge anzeigen.

So kopieren Sie das Statusbadge in Ihre Zwischenablage:

1. Wechseln Sie in Azure Pipelines zur Seite Pipelines , um die Liste der Pipelines anzuzeigen. Wählen Sie die Pipeline aus, den Sie im vorherigen Abschnitt erstellt haben.

2. Wählen Sie aus, und klicken Sie dann auf Statusbadge.

3. Wählen Sie Statusbadge aus.

4. Kopieren Sie das Beispielmarkdown aus dem Abschnitt „Beispielmarkdown“.

Führen Sie nun mit dem Badgemarkdown in Ihrer Zwischenablage die folgenden Schritte in GitHub aus:

1. Wechseln Sie zur Liste der Dateien, und wählen Sie Readme.md aus. Klicken Sie auf das Bleistiftsymbol, um diese zu bearbeiten.

2. Fügen Sie das statusmäßige Badgemarkdown am Anfang der Datei ein.

3. Führen Sie einen Commit für die Änderungen im main-Branch aus.

4. Beachten Sie, dass das Statusbadge in der Beschreibung Ihres Repositorys angezeigt wird.

So konfigurieren Sie den anonymen Zugriff auf Badges für private Projekte:

1. Navigieren Sie in der unteren linken Ecke der Seite zu Projekteinstellungen.

2. Öffnen Sie die Registerkarte Einstellungen unter Pipelines

3. Schalten Sie den Schieberegler Anonymen Zugriff auf Badges deaktivieren unter Allgemein um

Da Sie die Readme.md-Datei in diesem Repository gerade geändert haben, erstellt Azure Pipelines automatisch Ihren Code gemäß der Konfiguration in der azure-pipelines.yml-Datei im Stammverzeichnis Ihres Repositorys. Beachten Sie zurück in Azure Pipelines, dass eine neue Ausführung angezeigt wird. Jedes Mal, wenn Sie eine Bearbeitung vornehmen, startet Azure Pipelines eine neue Ausführung.

Wir zeigen Ihnen, wie Sie den klassischen Editor in Azure DevOps Server 2019 verwenden, um einen Build und ein Release zu erstellen, mit dem „Hello world“ ausgegeben wird.

1. Wechseln Sie zu Azure Repos. (Der Codehub in der vorherigen Navigation)

   

2. Wenn Ihr Projekt leer ist, werden Sie mit einem Bildschirm begrüßt, der Sie beim Hinzufügen von Code zu Ihrem Repository unterstützt. Wählen Sie die untere Auswahl aus, um Ihr Repository mit einer -Datei zu readme:

   

1. Wechseln Sie zu Azure Repos.

2. Fügen Sie eine Datei hinzu.

   

3. Benennen Sie im Dialogfeld die neue Datei, und erstellen Sie sie.

   HelloWorld.ps1
   

4. Kopieren Sie dieses Skript, und fügen Sie es ein.

   Write-Host "Hello world"
   

5. Committen (speichern) Sie die Datei.

1. Wählen Sie Azure Pipelines aus. Dadurch sollten Sie automatisch zur Seite Builds gelangen.

   

2. Erstellen einer neuen Pipeline

   

   Für neue Azure DevOps-Benutzer gelangen Sie dadurch automatisch zur YAML-Umgebung für die Pipelineerstellung. Um zum klassischen Editor zu gelangen und dieses Handbuch abzuschließen, müssen Sie die Previewfunktion für die neue YAML-Umgebung für die Pipelineerstellung deaktivieren:

   

   

3. Stellen Sie sicher, dass Quelle, Projekt, Repository und Standardbranch mit dem Speicherort übereinstimmen, an dem Sie das Skript erstellt haben.

4. Starten Sie mit einem leeren Auftrag.

5. Wählen Sie auf der linken Seite Pipeline aus, und geben Sie den gewünschten Namen an. Wählen Sie für den Agentpool die Option Gehosteter VS2017 aus.

6. Wählen Sie auf der linken Seite das Pluszeichen ( + ) aus, um Auftrag 1 eine Aufgabe hinzuzufügen. Wählen Sie auf der rechten Seite die Kategorie Hilfsprogramm aus, wählen Sie die PowerShell-Aufgabe aus der Liste aus, und wählen Sie dann Hinzufügen aus.

   

7. Wählen Sie auf der linken Seite Ihre neue PowerShell-Skripttask aus.

8. Wählen Sie für das Argument Skriptpfad die Schaltfläche aus, um Ihr Repository zu durchsuchen, und wählen Sie das Skript aus, das Sie erstellt haben.

   

9. Wählen Sie Speichern und in Warteschlange einreihen und dann Speichern aus.

1. Wählen Sie auf der Registerkarte Aufgaben das Pluszeichen ( + ) aus, um Auftrag 1 eine Aufgabe hinzuzufügen.

2. Wählen Sie die Kategorie Hilfsprogramm aus, wählen Sie die Aufgabe Buildartefakte veröffentlichen und dann Hinzufügen aus.

   

   Zu veröffentlichender Pfad: Wählen Sie die Schaltfläche aus, um das von Ihnen erstellte Skript zu durchsuchen und auszuwählen.

   Artefaktname: Geben Sie drop ein.

   Veröffentlichungsort für Artefakte: Wählen Sie Azure Artifacts/TFS aus.

1. Wählen Sie Speichern und in Warteschlange einreihen und dann Speichern und in Warteschlange einreihen aus.

2. Wählen Sie im Dialogfeld erneut Speichern und in Warteschlange einreihen aus.

   Dadurch wird ein neuer Build auf dem von Microsoft gehosteten Agent in die Warteschlange eingereiht.

3. Oben auf der Seite wird ein Link zum neuen Build angezeigt.

   

   Klicken Sie auf den Link, um den neuen Build anzuzeigen. Sobald der Agent zugeordnet ist, werden die Liveprotokolle des Builds angezeigt. Beachten Sie, dass das PowerShell-Skript als Teil des Builds ausgeführt wird und dass „Hello world“ in der Konsole ausgegeben wird.

   

4. Wechseln Sie zur Buildzusammenfassung. Auf der Registerkarte Artefakte des Builds sehen Sie, dass das Skript als Artefakt veröffentlicht wird.

   

Jetzt können Sie die Ergebnisse Ihrer Änderungen sehen. Wechseln Sie zu Azure Pipelines, und wählen Sie In der Warteschlange aus. Beachten Sie im Abschnitt In der Warteschlange oder aktuell ausgeführt , dass ein Build automatisch durch die von Ihnen committete Änderung ausgelöst wird.

1. Wechseln Sie zur Registerkarte Pipelines , und wählen Sie dann Releasesaus.

2. Wählen Sie die Aktion aus, um eine Neue Pipeline zu erstellen. Wenn bereits eine Releasepipeline erstellt wurde, wählen Sie das Pluszeichen ( + ) und dann Releasepipeline erstellen aus.

3. Wählen Sie die Aktion aus, um mit einem leeren Auftrag zu beginnen.

4. Nennen Sie die Stage QA.

5. Wählen Sie im Bereich „Artefakte“ die Option + Hinzufügen aus, und geben Sie eine Quelle (Buildpipeline) an. Wählen Sie Hinzufügen.

6. Wählen Sie den Blitz aus, um Continuous Deployment auszulösen, und aktivieren Sie dann den Trigger „Continuous Deployment“ auf der rechten Seite.

   

7. Wählen Sie die Registerkarte Aufgaben und dann Ihre QA-Stage aus.

8. Wählen Sie das Pluszeichen ( + ) für den Auftrag aus, um dem Auftrag eine Aufgabe hinzuzufügen.

9. Wählen Sie im Dialogfeld Aufgaben hinzufügen die Option Hilfsprogramm aus, suchen Sie nach der PowerShell-Aufgabe, und wählen Sie dann die zugehörige Hinzufügen-Schaltfläche aus.

10. Wählen Sie auf der linken Seite Ihre neue PowerShell-Skripttask aus.

11. Wählen Sie für das Argument Skriptpfad das Symbol aus, um Ihr Repository zu durchsuchen, und wählen Sie das Skript aus, das Sie erstellt haben.

12. Fügen Sie diese Argumente hinzu:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    

13. Wählen Sie auf der Registerkarte Pipeline die QA-Stage und dann Klonen aus.

    

14. Benennen Sie die geklonte Stage in Produktion um.

15. Benennen Sie die Releasepipeline in Hello World um.

    

16. Speichern Sie die Releasepipeline.

1. Erstellen Sie ein neues Release.

   

   Wenn Neues Release erstellen angezeigt wird, wählen Sie Erstellen aus.

2. Öffnen Sie das Release, das Sie erstellt haben.

   

3. Zeigen Sie die Protokolle an, um Echtzeitdaten zum Release zu erhalten.

   

Sie haben erfahren, wie Sie Ihre erste Pipeline in Azure erstellen. Erfahren Sie mehr über die Konfiguration von Pipelines in der Sprache Ihrer Wahl:

• .NET Core
• Go
• Java
• Node.js
• Python
• Container

Sie können auch die Pipeline anpassen, die Sie erstellt haben.

Informationen zum Ausführen Ihrer Pipeline in einem Container finden Sie unter Containeraufträge.

Ausführliche Informationen zum Erstellen von GitHub-Repositorys finden Sie unter Erstellen von GitHub-Repositorys.

Informationen zum Veröffentlichen Ihrer Pipelineartefakte finden Sie unter Veröffentlichen von Pipelineartefakten.

Informationen zu weiteren Möglichkeiten in YAML-Pipelines finden Sie in der YAML-Schemareferenz.

Bereinigung

Wenn Sie Testpipelines erstellt haben, können Sie diese einfach löschen, wenn sie nicht mehr benötigt werden.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

az pipelines list --output table

ID    Path    Name           Status    Default Queue
----  ------  -------------  --------  ------------------
6     \       FabrikamFiber  enabled   Hosted Ubuntu 1604

az pipelines delete --id 6

Are you sure you want to delete this pipeline? (y/n): y
Pipeline 6 was deleted successfully.

• Clients

  • Visual Studio Code für Windows, macOS und Linux
  • Visual Studio mit Git für Windows oder Visual Studio für Mac
  • Eclipse
  • Xcode
  • IntelliJ
  • Befehlszeile

• Dienste

  • Azure-Pipelines
  • Git-Dienstanbieter wie Azure Repos Git, GitHub und Bitbucket Cloud
  • Subversion

Wie repliziere ich eine Pipeline?

Wenn Ihre Pipeline ein Muster aufweist, das Sie in anderen Pipelines replizieren möchten, klonen, exportieren oder speichern Sie sie als Vorlage.

Nachdem Sie eine Pipeline geklont haben, können Sie Änderungen vornehmen und sie dann speichern.

Nachdem Sie eine Pipeline exportiert haben, können Sie sie auf der Registerkarte Alle Pipelines importieren.

Nachdem Sie eine Vorlage erstellt haben, können Ihre Teammitglieder sie verwenden, um dem Muster in neuen Pipelines zu folgen.

Wie arbeite ich mit Entwürfen?

Wenn Sie eine Buildpipeline bearbeiten und einige Änderungen testen möchten, die noch nicht für die Produktion bereit sind, können Sie sie als Entwurf speichern.

Was kann ich noch tun, wenn ich einen Build in die Warteschlange stelle?

Sie können Builds automatisch oder manuell in die Warteschlange stellen.

Wenn Sie einen Build manuell in die Warteschlange stellen, können Sie für eine einzelne Ausführung des Builds wie folgt vorgehen:

• Geben Sie den Pool an, in den der Build geleitet wird.

• Fügen Sie einige Variablen hinzu, und ändern Sie sie.

• Fügen Sie Anforderungen hinzu.

• In einem Git-Repository

  • Erstellen Sie einen Branch oder ein Tag.

  • Erstellen Sie einen Commit.

Weitere Informationen zu Pipelineeinstellungen finden Sie unter:

• Quellen werden abgerufen
• Aufgaben
• Variablen
• Trigger
• Vermerkdauer
• History

Wie erstelle ich programmgesteuert eine Buildpipeline?

REST-API-Referenz: Erstellen einer Buildpipeline