Share via


Uw klassieke pijplijn migreren naar YAML

Azure DevOps Services

Ga aan de slag met Azure Pipelines door uw bestaande klassieke pijplijn te converteren om YAML te gebruiken. Met een OP YAML gebaseerde pijplijn kunt u uw CI/CD-strategie implementeren als code en de geschiedenis bekijken, versies vergelijken, schuld, aantekeningen 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 aanwezig in de klassieke pijplijn.

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 editor 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 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 uitvoering gestart en deze wordt doorgevoerd in de opslagplaats. Wacht totdat de uitvoering is voltooid.

    Voer een doorvoeringsbericht in 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. Ga naar Pijplijnen>.

  2. Open uw klassieke pijplijn in de klassieke buildontwerper.

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

    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. Planningen in YAML bevinden zich standaard 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 bevat alle builds en bijbehorende artefacten.

  1. Selecteer het beletselteken (...) 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 werkitem maken voor foutinstelling , 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 fout bij fouten te maken.

Volgende stappen

Meer informatie over de functieverschillen tussen YAML en klassieke pijplijnen.