This guide will show you how to securely connect SYNQ to your dbt source code by using GitLab’s deploy keys.We need this information so we can extract information about code changes to your dbt models and link these to your data assets to make debugging dbt models easier.To be able to finish this guide, you’ll need the following:
→ Access to GitLab
→ Admin Access to your dbt or Looker repository (only repo admins can add deploy keys).⏱️ Estimated time to finish: 10 minutes.
→ Access to GitLab
→ Admin Access to your dbt or Looker repository (only repo admins can add deploy keys).⏱️ Estimated time to finish: 10 minutes.
Access
We follow the least privilege principle and require read-only access limited to the selected repository that contains your dbt source code.Name your integration
For exampledbt Cloud GitLab
Repository URL
The full URL of the Git repository that contains your dbt or Looker project (we only support SSH URLs).Branches to analyze
SYNQ, by default, analyses amaster
and main
branches. If you prefer for us to process the code from any other branch, provide the name.
Path to analyze
SYNQ, by default, looks for your source code in the root of the repository. If you store your code in a sub-directory, please provide us with a path (e.g.,dbt/
if your dbt project uses dbt/
as a directory). In most cases, it is best to leave to use default to analyze everything in the repository.
Copy the Public key
Click Create to set up the Git integration and copy the Public key that SYNQ providesSetup a deploy key
These steps will take you through how to set up a deploy key with the public SSH key we’ve provided you in GitLab
- On the top bar, select Menu > Projects and find your project.
- On the left sidebar, select Settings > Repository.
- Expand Deploy keys.
- Complete the fields.
- Optional. To grant
read-write
permission, select the Grant write permissions to this key checkbox.