importer-labs/azure_devops/valet-migrate-lab.md

Migrate an Azure DevOps pipeline to GitHub Actions

In this lab, you will use the Valet migrate command to migrate an Azure DevOps pipeline to GitHub Actions. The migrate subcommand can be used to convert a pipeline to its GitHub Actions equivalent and then create a pull request with the contents.

• Prerequisites
• Identify the Azure DevOps pipeline ID to use
• Perform a migration
• View the pull request
• Next Lab

Prerequisites

1. Follow all steps here to set up your environment
2. Create or start a codespace in this repository (if not started)
3. Completed the Valet audit lab.

Identify the Azure DevOps pipeline ID to use

You will need a pipeline ID to perform the migration

1. Go to the valet/ValetBootstrap/pipelines folder
2. Open the valet/ValetBootstrap/pipelines/valet-pipeline1.config.json file
3. Look for the web - href link
4. At the end of the link is the pipeline ID. Copy or note the ID.

Example

Perform a migration

You will use the codespace preconfigured in this repository to perform the migration.

1. Navigate to the codespace Visual Studio Code terminal
2. Verify you are in the valet directory
3. Copy the following command and replace:
   • GITHUB-ORG with the name of your organization.
   • GITHUB-REPO with the name of your repository.
   • PIPELINE-ID with your pipeline ID.
4. Now, from the ./valet folder in your repository, run valet migrate to migrate the pipeline to GitHub Actions.

cd valet
gh valet migrate azure-devops pipeline --target-url https://github.com/GITHUB-ORG/GITHUB-REPO --pipeline-id PIPELINE-ID --output-dir migrate

Example

5. Valet will create a pull request directly to your GitHub repository.
6. Click the green pull request link in the output of the migrate command. See below.

Example

View the pull request

The migrate output will show you the pull request on GitHub.

Example

Next Lab

Migrate an Azure DevOps pipeline to GitHub Actions with a custom transformer