importer-labs/gitlab/valet-configure-lab.md

Configure Valet To Work With GitLab Using The configure Command

In this lab, you will use Valet's configure command to set up the required secrets to communicate with the GitLab and GitHub instances. The configure command can be used for all of the supported providers, but in this lab we will be focusing on GitLab.

• Prerequisites
• Configuring Valet
• Test Valet
• Next Lab

Prerequisites

1. Followed steps to set up your codespace environment.

Configuring Valet

1. Run the setup script in the codespace terminal source ./gitlab/bootstrap/setup.sh and record the username and password for the next step.
2. Login to the GitLab instance to generate a personal access token:
   1. Click the PORTS tab in the codespace terminal window.
   2. In the PORTS tab find the row for port 80.
   3. Hover over the address under the Local Address column, and click the globe to open in browser
   4. Login to the GitLab server and following instructions to generate a token that has read_api scope.
   5. Record token for use in later steps.
3. Create a GitHub personal access token.
   • Navigate to your GitHub Settings - click your profile photo and then click Settings.
   • Go to Developer Settings
   • Go to Personal Access Tokens -> Legacy tokens (if present)
   • Click Generate new token -> Legacy tokens (if present). If required, provide your password.
   • Select at least these scopes: read packages and workflow. Optionally, provide a text in the Note field and change the expiration.
   • Click Generate token
   • Copy the token somewhere safe and temporary.
4. In the codespace terminal run gh valet configure.
5. Using the down arrow key to highlight GitLab CI, press the spacebar to select, then hit enter to accept.
6. Enter the previously generated GitHub access token from step 3.
7. Enter the GitHub instance url or hit enter to accept the default, if you are using github.com
8. Enter the GitLab access token from step 2 and press enter.
9. Enter http://localhost for the GitLab instance url
10. If all went well you should see a similar output in your terminal ADD_IMAGE_HERE

Verify Valet Works

To verify Valet works we are going to run a dry-run command. We will go further into details about the dry-run command in a later lab, but for now we just want to confirm that Valet runs with no errors.

Next Lab

Dry run the migration of an GitLab pipeline to GitHub Actions ADD_LINK_HERE