Ethan Dennis
56 lines
2.5 KiB
Markdown
56 lines
2.5 KiB
Markdown
# Perform a production migration of a GitLab pipeline
|
|
|
|
In this lab, you will use the `migrate` command to convert a GitLab 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 Codespace environment and start a GitLab server.
|
|
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
|
|
|
|
We need to answer the following questions before running a `migrate` command:
|
|
|
|
1. What is the project we want to migrate?
|
|
- __rails-example__
|
|
2. What is the namespace for that project?
|
|
- __Valet__
|
|
3. Where do we want to store the logs?
|
|
- __./tmp/migrate__
|
|
4. What is the URL for the GitHub repository to add the workflow to?
|
|
- __this repository__. The URL should 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 gitlab --target-url https://github.com/:owner/:repo --output-dir ./tmp/migrate --namespace valet --project rails-example
|
|
```
|
|
|
|
2. The command will write the URL to the pull request that was created when the command succeeds.
|
|
|
|
|
|
|
|
3. Open the generated pull request in a new browser tab.
|
|
|
|
### Inspect the pull request
|
|
|
|
The first thing we should notice about the PR is that there is a list of manual steps for us to complete.
|
|
|
|
Next, let's review the workflow we are adding by clicking on `Files changed` tab. This is where you would double check everything looks good. If it didn't you could push commits with the required changes, prior to merging.
|
|
|
|
Next, you can inspect the "Files changed" in this PR and see the converted workflow that is being added. Any additional changes or code reviews that were needed should be done in this PR.
|
|
|
|
Finally, you can merge the PR once your review has completed. We 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 a GitLab pipeline to Actions!
|
|
|
|
### Next Lab
|
|
|
|
[Forecast potential build runner usage](6-forecast.md)
|