Freigeben über


Migrieren Ihrer klassischen Pipeline zu YAML

Azure DevOps Services

Azure Pipelines bietet eine schnelle, einfache und sichere Möglichkeit, das Erstellen und Bereitstellen Ihres Projekts in verschiedenen Umgebungen zu automatisieren. Dieser Artikel führt Sie durch die Konvertierung Ihrer klassischen Pipelines in YAML.

Von Bedeutung

Nur klassische Pipelines, die mit dem klassischen Build-Designer erstellt wurden, können ein YAML exportiert werden. Wenn keine Option zum Exportieren in YAML oder JSON angezeigt wird, unterstützt Ihre Pipeline den Export wahrscheinlich nicht. Klassische Release-Pipelines unterstützen den YAML-Export nicht, Sie müssen jede Aufgabe einzeln exportieren.

Voraussetzungen

Produkt Anforderungen
Azure DevOps - Eine Azure DevOps Organisation.
- Ein Azure DevOps Projekt.
- Eine funktionierende klassische Pipeline.

Erstellen einer YAML-Beispielpipeline

Führen Sie die folgenden Schritte aus, um eine Start-YAML-Pipeline zu erstellen, die Sie später mit dem YAML-Codeausschnitt aktualisieren, der aus dem klassischen Pipeline-Editor exportiert wurde:

  1. Melden Sie sich bei Ihrer Organisation an, und navigieren Sie zu Ihrem Projekt.

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

  3. Wählen Sie Ihren Quellcodespeicherort entweder GitHub oder Azure Repos Git aus, und wählen Sie dann Ihr Repository aus.

  4. Wählen Sie auf der Seite " Pipeline konfigurieren" die Startpipeline aus, um mit einer minimalen Pipeline zu beginnen, die Sie nach Bedarf anpassen können.

  5. Wählen Sie "Speichern und ausführen" aus, geben Sie eine Commitnachricht ein, und wählen Sie dann erneut "Speichern und ausführen" aus, um eine neue Ausführung zu starten und die YAML-Pipeline in Ihr Repository zu übernehmen.

Exportieren einer klassischen Pipeline nach YAML

Führen Sie die folgenden Schritte aus, um Ihre klassische Pipeline nach YAML zu exportieren:

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie zu Ihrem Projekt.

  2. Wählen Sie Pipelines aus, suchen Sie die klassische Pipeline-Definition, und wählen Sie sie aus.

  3. Wählen Sie oben rechts das Symbol für vertikale Punkte und dann "In YAML exportieren" aus. Eine YAML-Datei wird auf Ihren Computer heruntergeladen.

    Screenshot, der zeigt, wie eine klassische Pipeline nach YAML exportiert wird.

Von Bedeutung

Sie müssen sich in der Pipelinedefinitionsansicht (keine bestimmte Ausführung) befinden, um die Option " In YAML exportieren " anzuzeigen.

Aktualisieren Ihrer YAML-Pipeline

Nachdem Sie Die klassische Pipeline exportiert und die .yml Datei auf Ihren Computer heruntergeladen haben, können Sie die zuvor erstellte Start-YAML-Pipeline aktualisieren. Führen Sie die folgenden Schritte aus, um Ihre YaML-Startpipeline zu aktualisieren:

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie zu Ihrem Projekt.

  2. Suchen Sie die zuvor erstellte Start-YAML-Pipeline, und wählen Sie sie aus. Löschen Sie den Inhalt der Startpipeline.

  3. Öffnen Sie die YAML-Datei, die Sie zuvor in Ihrem Code-Editor heruntergeladen haben.

  4. Kopieren Sie den Inhalt der exportierten YAML-Datei, und fügen Sie sie in die jetzt leere Startpipeline ein.

  5. Sie können den Aufgaben-Assistenten (den Bereich auf der rechten Seite des Editors) verwenden, um Aufgaben in Ihrer YAML-Datei hinzuzufügen oder zu ändern.

Ein Screenshot, der zeigt, wie der Aufgaben-Assistent in YAML-Pipelines verwendet wird.

  1. Wählen Sie Speichern und ausführen, sobald Sie fertig sind, um Ihre neue YAML-Pipeline auszuführen.

Wenn Ihre klassische Pipeline Variablen verwendet hat, die im Klassischen Benutzeroberflächen-Editor definiert sind, müssen Sie sie entweder in der YAML-Datei oder in den Pipelineeinstellungen neu definieren. Weitere Details finden Sie unter Definieren von Variablen .

Sie sollten auch alle cron-Zeitpläne in Ihrer YAML-Datei überprüfen. YAML-Zeitpläne verwenden standardmäßig UTC, während klassische Pipelines die lokale Zeitzone Ihrer Organisation verwenden. Weitere Details finden Sie unter "Konfigurieren von Zeitplänen für Pipelines ".