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

Audit GitLab using the Valet audit command

In this lab, you will use Valet to audit a GitLab namespace. The audit command will scan the GitLab namespace provided for all projects with pipelines that have run at least once, perform a dry-run on each of those pipelines, and finally perform an aggregation of all of the transformed workflows. This aggregate summary can be used as a planning tool and help understand how complete of a migration is possible with Valet. The goal of this lab is to performed an audit on the demo GitLab instance, and gain a good understanding of the components that make up an audit output.

• Prerequisites
• Perform an audit
• View audit output
• Review the pipelines
• Next Lab

Prerequisites

1. Follow all steps here to set up your environment.
2. Follow all steps here to configure Valet.

Perform an audit

Before running the command we need to collect some information:

1. What namespace or group do we want to audit? valet
2. Where do we want to store the result? tmp/audit

Steps

1. Navigate to the codespace terminal.
2. Run the following Valet audit command:

gh valet audit gitlab --output-dir tmp/audit --namespace valet

3. Valet will print the locations of the audit results in the terminal when complete ADD_SCREENSHOT_HERE

View audit output

Review the pipelines

Next Lab