co-authored-by: Begona Guereca <begonaguereca@github.com>
GitLab to Actions migrations powered by Valet
The instructions below will guide you through configuring a GitHub Codespace environment that will be used in subsequent labs that demonstrate how to use Valet to migrate GitLab pipelines to GitHub Actions.
These steps must be completed prior to starting other labs.
Create your own repository for these labs
- Ensure that you have created a repository using the valet-customers/labs as a template.
Configure your Codespace
- Start the codespace
- Click the
Codebutton on your repository's landing page. - Click the
Codespacestab. - Click
Create codespaces on mainto create the codespace. - After the Codespace has initialized there will be a terminal present.
- Verify the Valet CLI is installed and working. More information on the Valet extension for the official GitHub CLI can be found here.
-
Run the following command in the codespace's terminal:
gh valet version -
Verify the output is similar to below.
gh version 2.14.3 (2022-07-26) gh valet github/gh-valet v0.1.12 valet-cli unknown- If
gh valet versiondid not produce similar output then please follow the troubleshooting guide.
- If
Bootstrap a GitLab server
- Execute the GitLab setup script that will start a container with GitLab running inside of it. The script should be executed when starting a new Codespace or restarting an existing one.
-
Run the following command from the codespace's terminal:
./gitlab/bootstrap/setup.sh -
After some time, a pop-up box should appear with a link to the URL for your GitLab server.
- You can also access the URL by going to the
Portstab in your terminal. Right click on the URL listed under theLocal Addressand click theOpen in Browsertab.
- You can also access the URL by going to the
- Open the GitLab server in your browser and use the following credentials to authenticate:
-
Username:
root -
Password:
valet-labs! -
Once authenticated, you should see a GitLab server with a few predefined pipelines in the
valetgroup.
Labs for GitLab
Perform the following labs to learn more about Actions migrations with Valet:
- Configure credentials for Valet
- Perform an audit on GitLab pipelines
- Perform a dry-run of a GitLab pipeline
- Use custom transformers to customize Valet's behavior
- Perform a production migration of a GitLab pipeline
- Forecast potential build runner usage
Troubleshoot the Valet CLI
The CLI extension for Valet can be manually installed by following these steps:
-
Verify you are in the codespace terminal
-
Run this command from within the codespace's terminal:
gh extension install github/gh-valet -
Verify the result of the install contains:
✓ Installed extension github/gh-valet -
If you get an error similar to the image below, then click the link in the terminal output to authorize the token.
-
Verify Valet CLI extension is installed and working by running the following command from the codespace's terminal:
gh valet version
