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.
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
dbt Cloud GitLab
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
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
- 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-writepermission, 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.