diff --git a/gitlab/valet-dry-run-lab.md b/gitlab/valet-dry-run-lab.md index a451323..271de84 100644 --- a/gitlab/valet-dry-run-lab.md +++ b/gitlab/valet-dry-run-lab.md @@ -1,6 +1,6 @@ # 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 the actions workflow writen to your local filesystem. +The end result of this command will be the actions workflow writen to your local filesystem. - [Prerequisites](#prerequisites) - [Perform a dry run](#perform-a-dry-run) @@ -10,25 +10,28 @@ The end result of this command will the actions workflow writen to your local fi ## Prerequisites 1. Followed [steps](../gitlab#readme) to set up your codespace environment. -2. Completed the configure [lab](../gitlab/valet-configure-lab.md) +2. Completed the [configure lab](../gitlab/valet-configure-lab.md) ## 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 they files show in explorer + 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 +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` + gh valet dry-run gitlab --output-dir ./tmp/dry-run-lab --namespace valet --project basic-pipeline-example ``` -3. Valet should have printed the output files in the terminal. -4. Navigate to `./tmp/dry-run-lab` in the Explorer pane in codespaces and open `basic-pipeline-example.yml`. This is the converted GitHub Actions YAML file. -### Example -ADD_IMAGE +3. When the command finishes the output files should be printed to the terminal. + dry-run-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 + dry-run-explorer + ## View dry-run output The dry-run output will show you the GitHub Actions yaml that will be migrated to GitHub.