Skip to main content

GitLab Integration

Overview​

Connect GitLab to enable the Git AI Agent, which correlates code changes with infrastructure incidents during investigations and chat sessions.

What It Enables​

  • View recent commits and merge requests
  • Correlate deployments with incident timelines
  • Identify code or configuration changes that caused issues
  • Browse file contents and blame information

Setup​

1. Create an Access Token​

In GitLab, create a Personal Access Token or Project Access Token:

  1. Go to Settings → Access Tokens
  2. Create a token with the read_api scope
  3. Copy the token

2. Configure in OpsWorker​

  1. In the OpsWorker portal, go to Integrations
  2. Find GitLab and click Connect
  3. Provide:
    • GitLab URL: https://gitlab.com or your self-hosted GitLab URL
    • Access Token: The token created above
  4. Associate the integration with your cluster(s)

Permissions​

ScopePurpose
read_apiRead-only access to repositories, MRs, commits

OpsWorker does not modify your repositories.

Self-Hosted GitLab​

The integration works with self-hosted GitLab instances. Provide your GitLab URL during setup. Ensure the OpsWorker cloud can reach your GitLab instance (or use a private deployment if your GitLab is not internet-accessible).

Next Steps​