Erstellen Sie Ihre erste 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 unter pipeline im Azure Pipelines YAML-Schema und Customize your 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 eins 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 Agenten. Um von Microsoft gehostete Agents zu verwenden, muss Ihre Azure DevOps Organisation Zugriff auf von Microsoft gehostete parallele Aufträge haben. Sie können entweder einen Parallelauftrag erwerben oder eine kostenlose Bewilligung anfordern.

Erstellen Sie Ihre erste 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 Startseite für Pipelines können Sie Pipelines und Pipelineausführungen anzeigen, Pipelines erstellen und importieren, die Sicherheit verwalten und Details zu Pipelines und Ausführungen einsehen.

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 sie 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 Läufe aus, um alle Pipeline-Läufe 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 Laufzeitaufbewahrung finden Sie unter Aufbewahrungsrichtlinien für Builds und Releases.

Details der Pipeline anzeigen

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 Phasen anzeigen, Artefakte herunterladen und zu verknüpften Commits, Testergebnissen und Arbeitselementen navigieren.

Aufträge und Phasen

Im Jobs-Bereich erhalten Sie eine Übersicht über den Status Ihrer Stufen und Jobs. Dieser Bereich kann mehrere Registerkarten aufweisen, abhängig davon, ob Ihre Pipeline über Phasen 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 die Pipelineschritte detailliert anzeigen, indem Sie den Job entweder im Bereich Stages oder Jobs auswählen.

Wählen Sie einen Job aus, um die Schritte dieses Jobs 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, die 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 Beispiel-Markdown aus dem Abschnitt „Sample markdown“.

Führen Sie nun mit dem Badge Markdown in der 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 Status-Badge-Markdown am Anfang der Datei ein.

3. Führen Sie einen Commit für die Änderung 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 Datei Readme.md in diesem Repository soeben geändert haben, erstellt Azure Pipelines Ihren Code gemäß der Konfiguration in der Datei azure-pipelines.yml im Stammverzeichnis Ihres Repositorys automatisch. Beachten Sie 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 zu erstellen und freizugeben, der "Hello world" druckt.

1. Wechseln Sie zu Azure Repos. (Der Code-Hub 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 Option aus, um Ihr Repository mit einer Datei zu initialisieren:

   

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, damit Sie automatisch zur Seite Builds gelangen.

   

2. Erstellen einer neuen Pipeline

   

   Bei neuen Azure DevOps Benutzern gelangen Sie automatisch zur YAML-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 zur Warteschlange hinzufügen 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 Build-Artefakte 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.

   Artifact-Veröffentlichungsort: 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 zur Warteschlange hinzufügen aus.

   Dadurch wird ein neuer Build in die Warteschlange des von Microsoft gehosteten Agents eingereiht.

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

   

   Klicken Sie auf den Link, um den neuen Build live anzusehen. 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. Gehen Sie zur Build-Zusammenfassung. 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 Queued 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. Klicken Sie auf Hinzufügen.

6. Wählen Sie den Blitz aus, um die kontinuierliche Bereitstellung auszulösen, und aktivieren Sie dann den Trigger für die kontinuierliche Bereitstellung rechts in der Benutzeroberfläche.

   Blitz auswählen, um Continuous Deployment auszulösen

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 die -Schaltfläche aus, um Ihre Artefakte 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-Phase aus und wählen Sie 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
• Los geht's
• Java
• Node.js
• Python
• Behälter

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 GitHub Repositorys finden Sie unter Build 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.

• Kunden

  • Visual Studio Code für Windows, macOS und Linux
  • Visual Studio mit Git für Windows oder Visual Studio für Mac
  • Finsternis
  • 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
• Auslöser
• Aufbewahrungsdauer
• Geschichte

Wie erstelle ich programmgesteuert eine Buildpipeline?

REST-API-Referenz: Erstellen einer Buildpipeline