importer-labs/gitlab/valet-dry-run-lab.md

Dry run the migration of an GitLab pipeline to GitHub Actions

In this lab, you will use the Valet dry-run command to convert a GitLab pipeline to it's equivalent GitHub Actions workflow. The end result of this command will be the actions workflow writen to your local filesystem.

• Prerequisites
• Perform a dry run
• View dry-run output
• Next Lab

Prerequisites

1. Followed steps to set up your codespace environment.
2. Completed the configure lab

Perform a dry run

We will be performing a dry-run against a preconfigured project in the GitLab instance. Before running the command we need to collect some information:

1. What is the project we want to convert? basic-pipeline-example
2. What is the namespace for that project? Valet. In this case the namespace is the same as the group the project is in
3. Where do we want to store the result? ./tmp/dry-run-lab. This can be any valid path on the system. In the case of codespaces it is generally best to use ./tmp/SOME_DIRECTORY_HERE so the files show in explorer

Steps

1. Navigate to the codespace terminal
2. Run the dry-run command using the values determined above

   gh valet dry-run gitlab --output-dir ./tmp/dry-run-lab --namespace valet --project basic-pipeline-example
   

3. When the command finishes the output files should be printed to the terminal.
4. Open generated actions workflow
   • Find ./tmp/dry-run-lab/valet in the file explorer pane in codespaces.
   • Click basic-pipeline-example.yml to opendr

View dry-run output

The dry-run output will show you the GitHub Actions yaml that will be migrated to GitHub.

Example

ADD_IMAGE

Next Lab

TBD