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.

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 scripts/ValetBootstrap/pipelines folder
2. Open the scripts/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 scripts 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 ./scripts folder in your repository, run valet migrate to migrate the pipeline to GitHub Actions.

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

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