importer-labs/gitlab/1-configure.md

Configure credentials for GitHub Actions Importer

In this lab, you will use the configure CLI command to set the required credentials and information for GitHub Actions Importer to use when working with GitLab and GitHub.

You will need to complete all of the setup instructions here prior to performing this lab.

Configuring credentials

1. Run the setup script in the codespace terminal to ensure the GitLab server is ready:

   ./gitlab/bootstrap/setup.sh
   

2. Open the GitLab server in a new browser tab: - Click the PORTS tab in the codespace terminal window. - In the PORTS tab find the row for port 80. - Hover over the address under the Local Address column and click the globe to "open in browser".

3. Create a GitLab personal access token (PAT): - Authenticate with the GitLab server using the following credentials: - Username: root - Password: actions-importer-labs! - Follow the GitLab instructions to generate a PAT. - Ensure the token has the read_api scope. - Copy the generated token and save it in a safe location.

4. Create a GitHub personal access token (PAT): - Open github.com in a new browser tab. - In the top right corner of the UI, click your profile photo and click Settings. - In the left panel, click Developer Settings. - Click Personal access tokens and then Legacy tokens (if present). - Click Generate new token and then Generate new legacy token. You may be required to authenticate with GitHub during this step. - Name your token in the Note field. - Select the following scopes: workflow and read:packages. - Click Generate token. - Copy the generated PAT and save it in a safe location.

5. Run the configure CLI command: - Select the TERMINAL tab from within the codespace terminal window. - Run the following command: gh actions-importer configure. - Use the down arrow key to highlight GitLab, press the spacebar to select, and then press enter to continue. - At the GitHub handle prompt, enter the GitHub handle used to generate the GitHub PAT in step 2 and press enter. - At the GitHub Container Registry prompt, enter the GitHub PAT generated in step 4 and press enter. - At the GitHub PAT prompt, enter the GitHub PAT generated in step 4 and press enter. - At the GitHub URL prompt, enter the GitHub instance URL or press enter to accept the default value (https://github.com). - At the GitLab token prompt, enter the GitLab access token from step 3 and press enter. - At the GitLab URL prompt, enter http://localhost and press enter.

        ```console
        $ gh actions-importer configure
        ✔ Which CI providers are you configuring?: GitLab
        Enter the following values (leave empty to omit):
        ✔ GitHub handle used to authenticate with the GitHub Container Registry: mona
        ✔ Personal access token to authenticate with the GitHub Container Registry: ***************
        ✔ Personal access token for GitHub: ***************
        ✔ Base url of the GitHub instance: https://github.com
        ✔ Private token for GitLab: ***************
        ✔ Base url of the GitLab instance: http://localhost
        Environment variables successfully updated.
        ```
   

Verify your environment

To verify your environment is configured correctly, run the update CLI command. The update CLI command will download the latest version of GitHub Actions Importer to your codespace.

1. In the codespace terminal run the following command:

   gh actions-importer update
   

2. You should see a confirmation that you were logged into the GitHub Container Registry and the image was updated to the latest version.

   $ gh actions-importer update
   Login Succeeded
   latest: Pulling from actions-importer/cli
   Digest: sha256:a7d00dee8a37e25da59daeed44b1543f476b00fa2c41c47f48deeaf34a215bbb
   Status: Image is up to date for ghcr.io/actions-importer/cli:latest
   ghcr.io/actions-importer/cli:latest
   

Next lab

Perform an audit of a GitLab server