This tool was created when there was no means of exporting a designer/classic build/release definition to YAML. As of November 2020 there is a new Export to YAML feature which allows you to export a Build pipeline to YAML with a single click. This official function covers more edge cases than this CLI for Build pipelines. Where this CLI still has benefits is that it also converts Release definitions to YAML, which the official tool does not. It also allows the conversion of every single Build/Release definition en-masse, so much less clicking! Then you can then cut/copy/paste/manipulate the generated YAML steps as required to fit into a build and/or deployment pipeline unique to your own requirements.
yamlizr is a .NET Global Tool which converts Azure DevOps Classic Designer Build/Release Definitions and any referenced Task Groups en-masse into their YAML Pipeline or GitHub Action equivalent.
The tool itself uses the Azure DevOps .NET Client Libraries to pre-cache relevant data from your Azure DevOps organisation/account. This data includes build/release definitions, task groups, tasks/extensions data and variable groups. This Azure DevOps data is converted into Azure DevOps Pipeline objects (stages/jobs/steps/variables) which are then persisted to YAML using the YamlDotNet library.
This is not a delicate tool to create perfectly constructed YAML pipelines. Instead consider it to be a blunt instrument which will spawn as many YAML files as possible and from this YAML you can pick/choose and copy/paste the relevant stages/jobs/steps/variables into your own preferred YAML CI/CD deployment architecture.
Also... there is an optional switch whereby the tool can pass the Azure DevOps Pipeline objects into the AzurePipelinesToGitHubActionsConverter library (by @samsmithnz) and export your pipelines as GitHub Actions compliant workflows.
Disclaimer: Do not consider any of the YAML generated by this tool to be 'production ready'. Do your own testing/research and post any issues and/or make a PR!
If you find this tool of use then please give it a thumbs-up by giving this repository a :star: ... :wink:
Create a Personal Access Token (PAT) with the following scopes/permissions; | Scope | Permission |
---|---|---|
Build | Read | |
Deployment Groups | Read & Manage | |
Release | Read | |
Task Groups | Read | |
Variable Groups | Read |
dotnet tool update --global yamlizr
To generate YAML files in the c:/temp/myoutputfolder
output folder execute the following command;
yamlizr generate -pat <your PAT here> -org <your AzDO Organisation Uri> -proj <your AzDO project name> -out c:/temp/myoutputfolder
For context-sensitive help execute;
yamlizr --help
Optional arguments;
--filter <some string here>
filter build/release definitions (if you want to use a more granular approach).--phasetype <phase type here>
filter deployment jobs by Deploy Phase Type the default is AgentBasedDeployment
DeployPhaseTypes(tested), other (un-tested) options are RunOnServer
, MachineGroupBasedDeployment
& DeploymentGates
.Optional switches;
--inline
merge the tasks from task groups into the steps of the calling job instead of creating additional template files.--githubactions
generate GitHub Actions workflows via AzurePipelinesToGitHubActionsConverter.Examples;
#generate both Azure Pipelines and GitHub Actions YAML for a Build Definition called 'wibble-CI' and a Release Definition called 'wibble-CD';
yamlizr generate `
-pat <your PAT here> `
-org <your AzDO Organisation Uri> `
-proj <your AzDO project name> `
-out c:/temp/myoutputfolder `
--filter wibble `
--githubactions
#generate both Azure Pipelines and GitHub Actions YAML for *ALL* Build & Release Definitions found within the AzDO Project;
yamlizr generate `
-pat abcdefghij01234567890abcdefghij01234567890abcdefghij `
-org https://dev.azure.com/MyOrg `
-proj MyProject `
-out c:/temp/myoutputfolder `
--githubactions
All YAML files generated are output into sub-folders of a project folder, i.e. using the above example of -o c:/temp/myoutputfolder
the following folders are created;
c:/temp/myoutputfolder/<your AzDO project>/AzureDevOpsBuilds/*.yml
c:/temp/myoutputfolder/<your AzDO project>/AzureDevOpsReleases/*.yml
c:/temp/myoutputfolder/<your AzDO project>/AzureDevOpsTaskGroups/*.yml
c:/temp/myoutputfolder/<your AzDO project>/GitHubBuilds/*.yml
c:/temp/myoutputfolder/<your AzDO project>/GitHubReleases/*.yml
--parallelism
command line option for faster processing is a bit buggy so disabled.Please post any issues or feedback here.