Connecting your GitLab account to dbt Cloud unlocks exciting and compelling functionality in dbt Cloud. Once your GitLab account is connected, you can:
- Trigger CI builds when Merge Requests are opened in GitLab
- Import new repos with one click
- Carry GitLab permissions through to dbt Cloud IDE's git actions
For Developer and Team tiers
If your account is not connected, click the button
Link your GitLab account to continue the setup process.
You should be redirected to GitLab and prompted to sign into your account. GitLab will then ask for your explicit authorization:
Once you've accepted, you should be redirected back to dbt Cloud, and you'll see that your account has been linked.
For Enterprise tier
Before developers can personally authenticate in GitLab, account admins need to set up a GitLab application.
Account admins should navigate to
Account Settings and click on the
Admins can create a Group Owned Application in GitLab - GitLab has a guide for that here.
In GitLab, when creating your Group Owned Application, input the following:
Name- We recommend
Redirect URI- You should copy-paste this from your Account Integrations page in dbt Cloud, but it is likely
- Check the
- Check the
The application form in GitLab should look like this:
Save application in GitLab, and GitLab will then generate an Application ID and Secret. You can copy-paste those values back into the form on your dbt Cloud's Integrations page.
Note that if you're using the regular consumer version of GitLab, you'll want to use the standard
https://gitlab.com for your GitLab instance - if your organization is using a hosted version of GitLab, you'll want to use the hostname provided by your organization:
Once the form is complete in dbt Cloud, click the button
Connect to GitLab.
GitLab will then ask for your explicit authorization:
And you're all set!
Non-admins on Enterprise accounts can authenticate by going to
Profile and then
Integrations and clicking the
Link your GitLab account button.
Errors importing a repository
If you do not see your repository listed, double-check that:
- Your repository is in a Gitlab group you have access to. dbt Cloud will not read repos associated with a user.
If you do see your repository listed but are unable to import the repository successfully, double-check that:
- You are a maintainer on that repository (only users with maintainer permissions can set up repository connections)