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

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 example dbt 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 a master 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 provides

​
Setup 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
  1. On the top bar, select Menu > Projects and find your project.
  2. On the left sidebar, select Settings > Repository.
  3. Expand Deploy keys.
  4. Complete the fields.
  5. Optional. To grant read-write permission, select the Grant write permissions to this key checkbox.

A project deploy key is enabled when it is created. You can modify only a project deploy key’s name and permissions.