GitLab

To get the project access token, navigate to your GitLab project settings and create a new token.

TIPProject access tokens are preferred over personal tokens for security.

When configuring your token, select the api and write_repository scopes and the Maintainer role. Datafold uses the token to read your codebase for migration projects, and to push migrated code and open merge requests. Maintainer lets Datafold install the webhook for you. With the Developer role the integration still saves, and Datafold shows manual webhook instructions: add the shown webhook URL and secret under Settings → Webhooks in your GitLab project and tick Push events and Merge request events.

Project is your GitLab project URL after gitlab.com/. For example, if your GitLab project URL is https://gitlab.com/datafold/analytics/, your Project is datafold/analytics (no trailing slash). Finally, navigate back to Datafold and enter the Personal/Project Access Token and the name of your Project before hitting Save. If you want to change the GitLab URL, you can do so after setting up the integration. To do so, navigate to Settings, then Org Settings:

⌘I

INTRODUCTION

DATA PLATFORM MIGRATIONS

DATA DIFFS

DATA MONITORS

INTEGRATIONS

DEPLOYMENT

SECURITY

SUPPORT