Uw klassieke pijplijn migreren naar YAML

Azure DevOps Services

Ga aan de slag met Azure Pipelines door uw bestaande klassieke pijplijn te converteren naar YAML. Met een YAML-pijplijn kunt u uw CI/CD-strategie als code implementeren en de geschiedenis ervan bekijken, versies vergelijken, schuld geven, aantekeningen maken, enzovoort.

Wanneer u uw klassieke pijplijn converteert, bestaat het eindproduct uit twee pijplijnen. U hebt één nieuwe YAML-pijplijn en een klassieke pijplijn die buiten gebruik kan worden gesteld. De uitvoeringsgeschiedenis van uw klassieke pijplijn blijft in de klassieke pijplijn staan.

Vereisten

Zorg ervoor dat u over de volgende items beschikt voordat u begint.

  • Een Azure-account met een actief abonnement. Gratis een account maken
  • Een actieve Azure DevOps-organisatie. Meld u aan voor Azure Pipelines.
  • Een werkende pijplijn die gebruikmaakt van de editor van de klassieke gebruikersinterface (UI).
  • Een voorbeeld van een YAML-pijplijnbestand in uw code. Maak een YAML-voorbeeldpijplijn in de volgende sectie.

Een YAML-voorbeeldpijplijn maken

Voer de volgende stappen uit om een YAML-voorbeeldpijplijn te maken, die u later bijwerkt met de geëxporteerde code uit de klassieke UI-editor.

  1. Meld u aan bij uw organisatie (https://dev.azure.com/{yourorganization}) en selecteer uw project.

  2. Selecteer Pijplijnen en vervolgens Nieuwe pijplijn.

    Twee knoppen om te selecteren voor het maken van een nieuwe pijplijn.

  3. Selecteer de locatie voor uw broncode als GitHub of Azure Repos Git.

    Lijst met mogelijke selecties voor uw broncode.

  4. Selecteer een opslagplaats.

    Pagina waar u een opslagplaats voor uw broncodepijplijn selecteert.

  5. Selecteer op de pagina Uw pijplijn configureren de optie Starter-pijplijn.

    Lijst met sjablonen waaruit u kunt kiezen voor het configureren van uw nieuwe pijplijn.

  6. Selecteer Opslaan en uitvoeren.

    Controlepagina waar u Opslaan en uitvoeren selecteert.

  7. Voer uw doorvoerbericht in, selecteer Rechtstreeks doorvoeren naar de hoofdbranch en kies vervolgens opnieuw Opslaan en uitvoeren . Er wordt een nieuwe uitvoering gestart en deze wordt doorgevoerd in de opslagplaats. Wacht tot de run is voltooid.

    Voer het bericht door om door te voeren naar de hoofdbranch en selecteer vervolgens de knop Opslaan en uitvoeren.

Uw klassieke pijplijn exporteren

Voer de volgende stappen uit om uw klassieke pijplijn te exporteren naar een YAML-bestand dat u in de editor kunt gebruiken.

  1. Open de klassieke pijplijn.

  2. Selecteer het beletselteken (...) en selecteer vervolgens Exporteren naar YAML.

    Schermopname van het contextmenu om uw pijplijn te exporteren naar YAML.

  3. Open het gedownloade YAML-bestand in de code-editor.

  4. Als uw YAML-pijplijn variabelen bevat die zijn gedefinieerd in de klassieke gebruikersinterface, definieert u de variabelen opnieuw in de gebruikersinterface van de pijplijninstellingen of in uw YAML-bestand. Zie Variabelen definiëren voor meer informatie.

  5. Bekijk eventuele cron planningen in uw YAML-bestand. Schema's in YAML zijn standaard cron in UTC. In klassieke pijplijnen bevinden ze zich in de tijdzone van de organisatie. Zie Planningen voor pijplijnen configureren voor meer informatie.

  6. Gebruik de Taakassistent om andere wijzigingen aan te brengen in het YAML-bestand. De Taakassistent is een deelvenster aan de rechterkant van het scherm, waarmee u YAML-stappen correct kunt maken en wijzigen.

    Configureer uw pijplijntaak met Taakassistent.

  7. Sla uw pijplijn op en voer deze uit.

Resources opschonen

Als u deze voorbeeldpijplijn niet meer gaat gebruiken, verwijdert u deze uit uw project. Verwijdering is permanent en omvat alle builds en bijbehorende artefacten.

  1. Selecteer het beletselteken (...) en selecteer Verwijderen.

  2. Voer de naam van de pijplijn in om deze definitief te verwijderen en selecteer vervolgens Verwijderen.

Veelgestelde vragen

Is er een taak in YAML-pijplijnen om werkitems te maken wanneer er een buildfout optreedt?

YAML-pijplijnen hebben geen instelling Werkitem maken voor fouten , zoals klassieke build-pijplijnen. U hebt een aantal opties om deze functionaliteit zelf te maken.

Volgende stappen

Meer informatie over de functieverschillen tussen YAML- en klassieke pijplijnen.