7f5fd852e3
* Update readme.md * Update valet-migrate-lab.md * Update valet-migrate-custom-lab.md * Update valet-migrate-custom-lab.md * Update azure_devops/valet-migrate-lab.md Co-authored-by: Ethan Dennis <ethanis@github.com> * Update azure_devops/valet-migrate-custom-lab.md Co-authored-by: Ethan Dennis <ethanis@github.com> Co-authored-by: Ethan Dennis <ethanis@github.com>
60 lines
2.6 KiB
Markdown
60 lines
2.6 KiB
Markdown
# 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](#prerequisites)
|
|
- [Identify the Azure DevOps pipeline ID to use](#identify-the-azure-devops-pipeline-id-to-use)
|
|
- [Perform a migration](#perform-a-migration)
|
|
- [View the pull request](#view-the-pull-request)
|
|
- [Next Lab](#next-lab)
|
|
|
|
## Prerequisites
|
|
|
|
1. Follow all steps [here](../azure_devops#readme) to set up your environment
|
|
2. Create or start a codespace in this repository (if not started)
|
|
3. Completed the [Valet audit lab](valet-audit-lab.md).
|
|
|
|
## 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. Run `gh valet migrate` from the `valet` directory to migrate the pipeline to GitHub Actions..
|
|
```
|
|
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](valet-migrate-custom-lab.md)
|