GitLab

​

Overview

​

Prerequisites

• Administrative access to your GitLab group or instance
• Permission to create access tokens

​

Setup Instructions

​

Step 1: Navigate to Integration Settings

1. Log into your TierZero dashboard
2. Go to Settings → Integrations
3. Click Connect next to GitLab

​

Step 2: Create an Access Token

1. In GitLab, go to your group’s Settings → Access Tokens (or use a personal access token)
2. Create a new token with the following scopes:
   • read_api: Read access to the API
   • read_repository: Read access to repository files
3. Set an expiration date and click Create
4. Copy the generated token

​

Step 3: Enter Credentials

1. Paste the access token into TierZero
2. Enter your GitLab instance URL (for self-hosted instances)
3. Click Connect

​

What TierZero Accesses

• Repository contents: Code files, branches, and directory structure
• Commit history: Recent commits, diffs, and authors
• Merge requests: Open MRs, discussions, and CI results
• Pipelines: CI/CD pipeline runs, jobs, and logs
• Deployments: Deployment history and environments

​

Security

• TierZero uses scoped access tokens
• Read-only access to repositories and API
• Tokens are encrypted at rest
• Revoke access by deleting the token in GitLab

​

Troubleshooting

​

Repository Not Visible

• Verify the access token has the read_api and read_repository scopes
• For group tokens, check that the repository belongs to the token’s group
• For self-hosted instances, ensure the GitLab URL is correct