61 lines
3.0 KiB
Markdown
61 lines
3.0 KiB
Markdown
# Perform a production migration of an Azure DevOps pipeline
|
|
|
|
In this lab, you will use the `migrate` command to convert an Azure DevOps pipeline and open a pull request with the equivalent Actions workflow.
|
|
|
|
## Prerequisites
|
|
|
|
1. Followed the steps [here](./readme.md#configure-your-codespace) to set up your GitHub Codespaces environment and bootstrap an Azure DevOps project.
|
|
2. Completed the [configure lab](./1-configure-lab.md#configuring-credentials).
|
|
3. Completed the [dry-run lab](./3-dry-run.md).
|
|
4. Completed the [custom transformers lab](./4-custom-transformers.md).
|
|
|
|
## Performing a migration
|
|
|
|
Answer the following questions before running a `migrate` command:
|
|
|
|
1. What is the id of the pipeline to convert?
|
|
- __:pipeline_id__. This id can be found by:
|
|
- Navigating to the build pipelines in the bootstrapped Azure DevOps project <https://dev.azure.com/:organization/:project/_build>
|
|
- Selecting the pipeline with the name "valet-pipeline2"
|
|
- Inspecting the URL to locate the pipeline id <https://dev.azure.com/:organization/:project/_build?definitionId=:pipeline_id>
|
|
2. Where do you want to store the logs?
|
|
- __./tmp/migrate__
|
|
3. What is the URL for the GitHub repository to add the workflow to?
|
|
- __this repository__. The URL should follow the pattern <https://github.com/:owner/:repo> with `:owner` and `:repo` replaced with your values.
|
|
|
|
### Steps
|
|
|
|
1. Run the following `migrate` command in the codespace terminal:
|
|
|
|
```bash
|
|
gh valet migrate azure-devops pipeline --pipeline-id :pipeline_id --target-url https://github.com/:owner/:repo --output-dir ./tmp/migrate
|
|
```
|
|
|
|
2. The command will write the URL to the pull request that was created when the command succeeds.
|
|
|
|
```bash
|
|
➜ gh valet migrate azure-devops pipeline --pipeline-id 8 --target-url https://github.com/ethanis/labs --output-dir ./tmp/migrate
|
|
[2022-09-07 20:25:08] Logs: 'tmp/dry-run-lab/log/valet-20220907-202508.log'
|
|
[2022-09-07 20:25:13] Pull request: 'https://github.com/ethanis/labs/pull/42'
|
|
```
|
|
|
|
3. Open the generated pull request in a new browser tab.
|
|
|
|
### Inspect the pull request
|
|
|
|
The first thing to notice about the pull request is that there is a list of manual steps to complete:
|
|
|
|
|
|
|
|
Next, you can inspect the `Files changed` in this pull request to see the converted workflow that is being added. Any additional changes or code reviews that were needed should be done in this pull request.
|
|
|
|
Finally, you can merge the pull request once your review has completed. You can then view the workflow running by selecting the `Actions` menu in the top navigation bar in GitHub.
|
|
|
|
|
|
|
|
At this point, the migration has completed and you have successfully migrated an Azure DevOps pipeline to Actions!
|
|
|
|
### Next lab
|
|
|
|
[Forecast potential build runner usage](6-forecast.md)
|