Skip to main content

GitLab

CatalogDiscoveryGitOpsScorecards

Summary​

GitLab is a Git-based VCS that has a Cloud and Self-Hosted option. You can use GitLab to drive insights into values such as:

  • Git repository details (commit history, contributors)
  • Scorecard rules

Setup​

In order to connect Cortex to your GitLab instance, you’ll need to add a GitLab Personal Token with the read_api scope under Settings → GitLab.

If using the Scaffolder, you'll need the full api scope.

caution
If you’re using a self-hosted instance of GitLab, you’ll need to verify that your Cortex instance is able to reach the GitLab instance. See our IP Whitelist section for more.

Service Registration​

Service Descriptor​

x-cortex-git:
  gitlab:
    repository: <namespace>/<project>
    basepath: myService # optional
FieldDescriptionRequired
repositorynamespace/repo as defined in GitLabtrue
basepathIf the service is in a monorepo (e.g. in a subdirectory), use this field to define the subdirfalse