Connect GitLab

This guide covers connecting a GitLab instance to Oore CI for repository access and webhook-triggered builds.

What you need

• Role: owner or admin
• A running Oore CI instance in ready state
• A GitLab account (self-hosted or gitlab.com)
• Permission to create OAuth applications in your GitLab instance

Steps

1. Create a GitLab OAuth application

1. In GitLab, go to Admin Area > Applications (for instance-wide) or User Settings > Applications (for personal)
2. Create a new application:
   • Name: Oore CI
   • Redirect URI: http://127.0.0.1:8787/v1/integrations/gitlab/callback
   • Scopes: api, read_repository
   • Confidential: Yes
3. Save and copy the Application ID and Secret

For GitLab OAuth documentation, see GitLab OAuth 2.0 provider.

2. Start the integration in Oore CI

1. In the web UI, go to Settings > Integrations
2. Click Connect GitLab
3. Enter your GitLab host URL (e.g., https://gitlab.com or your self-hosted URL)
4. Enter the Application ID and Secret from step 1

3. Authorize

Oore CI redirects you to GitLab to authorize the OAuth application. After authorization, GitLab redirects back and Oore CI stores the credentials.

4. Verify

Go to Projects > New Project and confirm your GitLab repositories appear in the source selection dropdown.

Webhook configuration

When you create a project from a GitLab repository, Oore CI needs webhooks for automatic build triggers. Configure the webhook in your GitLab project:

1. In GitLab, go to Project Settings > Webhooks
2. Add a webhook:
   • URL: http://<your-oore-instance>:8787/v1/webhooks/gitlab
   • Trigger: Push events, Merge request events
   • Secret token: (use the token from your Oore CI integration settings)
3. Click Add webhook

Removing the integration

1. Go to Settings > Integrations in Oore CI
2. Click the GitLab integration
3. Click Delete

Also revoke the OAuth application in GitLab if no longer needed.

API endpoints

Method	Path	Description
POST	/v1/integrations/gitlab/start	Begin GitLab OAuth flow
POST	/v1/integrations/gitlab/authorize	Complete authorization
GET	/v1/integrations/{id}/repositories	List accessible repositories
DELETE	/v1/integrations/{id}	Remove integration

Reference

• GitLab OAuth 2.0 provider
• GitLab webhooks