Freigeben über


Migrieren Ihrer klassischen Pipeline zu YAML

Azure DevOps Services

Beginnen Sie die Arbeit mit Azure Pipelines, indem Sie Ihre vorhandene klassische Pipeline zur Verwendung von YAML konvertieren. Mit einer YAML-basierten Pipeline können Sie Ihre CI/CD-Strategie als Code implementieren und den Verlauf anzeigen, Versionen vergleichen, Verantwortung zuweisen, Kommentare einfügen usw.

Wenn Sie die klassische Pipeline konvertieren, erhalten Sie als Endprodukt zwei Pipelines. Diese umfassen eine neue YAML-Pipeline und eine klassische Pipeline, die eingestellt werden kann. Der Ausführungsverlauf Ihrer klassischen Pipeline verbleibt in der klassischen Pipeline.

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Elemente haben, bevor Sie beginnen.

  • Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
  • Eine aktive Azure DevOps-Organisation. Registrieren Sie sich für Azure Pipelines.
  • Eine Arbeitspipeline, die den klassischen Benutzeroberflächen-Editor verwendet
  • Eine YAML-Beispielpipelinedatei in Ihrem Code. Erstellen Sie im folgenden Abschnitt eine YAML-Beispielpipeline.

Erstellen einer YAML-Beispielpipeline

Führen Sie die folgenden Schritte aus, um eine YAML-Beispielpipeline zu erstellen, die Sie später mit Ihrem exportierten Code aus dem klassischen Benutzeroberflächen-Editor aktualisieren.

  1. Melden Sie sich bei Ihrer Organisation (https://dev.azure.com/{yourorganization}) an, und wählen Sie Ihr Projekt aus.

  2. Wählen Sie Pipelines und dann Neue Pipeline aus.

    Zwei Schaltflächen zur Auswahl für die Erstellung einer neuen Pipeline

  3. Wählen Sie als Speicherort für Ihren Quellcode entweder GitHub oder Azure Repos Git aus.

    Liste möglicher Auswahlmöglichkeiten für den Quellcode

  4. Wählen Sie ein Repository aus.

    Die Seite, auf der Sie ein Repository für Ihre Quellcodepipeline auswählen

  5. Wählen Sie auf der Seite Pipeline konfigurieren die Option Starterpipeline aus.

    Liste der Vorlagen zur Konfiguration der neuen Pipeline

  6. Klicken Sie auf Speichern und ausführen.

    Überprüfungsseite, auf der Sie „Speichern und ausführen“ auswählen

  7. Geben Sie Ihre Commitnachricht ein, wählen Sie Direkt in den Mainbranch committen und dann erneut Speichern und ausführen aus. Eine neue Ausführung wird gestartet, und sie wird in das Repository committet. Warten Sie, bis die Ausführung beendet ist.

    Committen Sie die Nachricht an den Mainbranch, und wählen Sie dann „Speichern und ausführen“ aus

Exportieren der klassischen Pipeline

Führen Sie die folgenden Schritte aus, um Ihre klassische Pipeline in eine YAML-Datei zu exportieren, die Sie im Editor verwenden können.

  1. Navigieren Sie zu Pipelines>Pipelines.

  2. Öffnen Sie Ihre klassische Pipeline im klassischen Build-Designer.

  3. Wählen Sie die Auslassungspunkte (...) aus, und wählen Sie dann Nach YAML exportieren aus.

    Screenshot des Kontextmenüs zum Exportieren Ihrer Pipeline nach YAML

  4. Öffnen Sie die heruntergeladene YAML-Datei in Ihrem Code-Editor.

  5. Wenn Ihre YAML-Pipeline Variablen enthält, die in der klassischen Benutzeroberfläche definiert wurden, definieren Sie die Variablen erneut auf der Benutzeroberfläche für die Pipelineeinstellungen oder in Ihrer YAML-Datei. Weitere Informationen finden Sie unter Definieren von Variablen.

  6. Überprüfen Sie alle cron-Zeitpläne in Ihrer YAML-Datei. Standardmäßig sind cron-Zeitpläne in YAML in UTC. In klassischen Pipelines befinden sie sich in der Zeitzone der Organisation. Weitere Informationen finden Sie unter Konfigurieren von Zeitplänen für Pipelines.

  7. Verwenden Sie den Aufgaben-Assistenten, um andere Änderungen an der YAML-Datei vorzunehmen. Der Aufgaben-Assistent ist ein Bereich auf der rechten Seite des Bildschirms, der Ihnen hilft, YAML-Schritte ordnungsgemäß zu erstellen und zu ändern.

    Konfigurieren Ihrer Pipelineaufgabe mit dem Aufgaben-Assistenten

  8. Speichern Sie die Pipeline, und führen Sie sie aus.

Bereinigen von Ressourcen

Wenn Sie diese Beispielpipeline nicht mehr verwenden werden, löschen Sie sie aus Ihrem Projekt. Das Löschen ist dauerhaft und enthält alle Builds und zugehörigen Artefakte.

  1. Wählen Sie die Auslassungspunkte (...) aus, und wählen Sie Löschen aus.

  2. Geben Sie den Namen der Pipeline ein, um sie endgültig zu löschen, und wählen Sie dann Löschen aus.

Häufig gestellte Fragen

Gibt es in YAML-Pipelines eine Aufgabe zum Erstellen von Arbeitselementen, wenn ein Buildfehler auftritt?

Anders als klassische Buildpipelines verfügen YAML-Pipelines nicht über die Einstellung Bei Fehler Arbeitselement erstellen. Sie haben mehrere Möglichkeiten, diese Funktionalität selbst zu erstellen.

Nächste Schritte

Lernen Sie mehr über die Funktionsunterschiede zwischen YAML-Pipelines und klassischen Pipelines.