Delen via

Uw klassieke pijplijn migreren naar YAML

  • Artikel

Azure DevOps Services

Ga aan de slag met Azure Pipelines door uw bestaande klassieke pijplijn te converteren om YAML te gebruiken. Met een YAML-gebaseerde pijplijn kun je je CI/CD-strategie als code implementeren en de geschiedenis bekijken, versies vergelijken, verantwoordelijkheid toewijzen, annotaties maken, enzovoort.

Wanneer u uw klassieke pijplijn converteert, is het eindproduct 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 beschikbaar binnen de klassieke pijplijn.

Notitie

U kunt alleen een YAML-bestand exporteren vanuit een bestaande klassieke pijplijn die is gemaakt met de klassieke buildontwerper. Als u de optie voor exporteren naar JSON of YAML niet ziet, biedt uw pijplijn geen ondersteuning voor exporteren. Klassieke release-pijplijnen hebben niet de optie exporteren naar YAML. U kunt een klassieke release-pijplijn exporteren door elke afzonderlijke taak te exporteren.

Vereisten

Zorg ervoor dat u de volgende items hebt 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 klassieke gebruikersinterface (UI) editor.
  • 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 gaat bijwerken 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 Starter-pijplijn op de pagina Uw pijplijn configureren.

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

  6. Selecteer Opslaan en uitvoeren.

    Controleer de pagina waar u Opslaan en uitvoeren selecteert.

  7. Voer uw doorvoerbericht in, selecteer Doorvoeren rechtstreeks naar de hoofdbranch en kies Opslaan en opnieuw uitvoeren . Er wordt een nieuwe run gestart en deze wordt gecommitteerd naar de repository. Wacht totdat de uitvoering is voltooid.

    Voer een commitbericht in om door te voeren naar de hoofdbranch en selecteer vervolgens de knop Opslaan en uitvoeren.

Uw klassieke pijplijn exporteren

  1. Meld u aan bij uw Azure DevOps-organisatie en ga vervolgens naar uw project.

  2. Selecteer Pipelines>Pipelines.

  3. Selecteer de definitie van de klassieke pijplijn, selecteer het ellipsicoon, en selecteer vervolgens Exporteren naar YAML. Zorg ervoor dat u de weergave van de pijplijndefinitie bekijkt, en niet in een specifieke uitvoering bevindt, om de optie Exporteren naar YAML te zien.

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

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

  5. 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.

  6. Bekijk alle cron planningen in uw YAML-bestand. Standaard zijn schema's in YAML cron in UTC. In klassieke pijplijnen bevinden ze zich in de tijdzone van de organisatie. Zie Planningen configureren voor pijplijnen voor meer informatie.

  7. 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.

  8. Sla uw pijplijn op en voer deze uit .

Resources opschonen

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

  1. Klik op de beletseltekens (...) en selecteer Verwijderen.

  2. Voer de naam van uw pijplijn in om deze permanent 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 om een werkitem aan te maken bij een fout, zoals klassieke build-pijplijnen. U hebt een aantal opties voor het zelf maken van deze functionaliteit.

  • U kunt een script of PowerShell-taak gebruiken en de REST API aanroepen.
  • U kunt Azure CLI gebruiken om az boards work-item create aan te roepen in uw pijplijn. Zie een voorbeeld van het gebruik van de CLI om een bug te creëren bij een fout.

Volgende stappen

Meer informatie over de functieverschillen tussen YAML en klassieke pijplijnen.

Azure Pipelines gebruiken