- 31 Jul 2023
- 2 Minutes to read
- Print
- DarkLight
Git Integration - Overview
- Updated on 31 Jul 2023
- 2 Minutes to read
- Print
- DarkLight
Overview
The Git Integration feature allows you to export the YAML configuration file for your ETL and Data Mart Configurations to a specified Git repository.
This page explains how to set up and use the Git Integration feature.
The Git Integration feature is a paid option.
Please get in touch with your sales or customer success agent to enable this feature.
The Git Integration feature supports GitHub and GitLab as hosting services as Git repositories.
The feature is also available for on-premise environments using GitHub Enterprise, etc.
Synchronized objects
- ETL Configuration settings
- Data Mart Configuration settings
Integration types
There are two types of integration types for the Git Integration feature: Users and Resource Groups.
You can integrate your Git repository to your account, or to each Resource Group.
Integration type: User
This serves as an integration setting for the Users of trocco.
All operations of the Git Integration feature (for ETL and Data Mart Configurations) are available for the following resources:
- Resources created by you
- Resources that do not belong to a resource group
Integration type: Resource Group
Roles & Permissions
The operations allowed depend on the type of role the Resource Group has granted to the team to which it belongs.
See Resource Groups for more information on each of the roles in a Resource Group.
The operations allowed for each role are as follows:
Operation/Role | Administrator | Editor | Operator | Viewer | No Role |
---|---|---|---|---|---|
Creating and editing Git Integration settings | ✓ | ✓ | ✓ | - | - |
Check diff with Git | ✓ | ✓ | ✓ | - | - |
Commit and push to Git | ✓ | ✓ | ✓ | - | - |
View integrated information | ✓ | ✓ | ✓ | ✓ | ✓ |
Below is an example of a user's Git integration screen.
- For the resource group test_1, the user is granted the administrator or editor role.
- For the resource groups test_2 and test_3, the users are assigned the operator and viewer role.
Resource groups that do not have roles assigned to the team to which you belong, and for which you are not the creator, will not appear on the Git integration page.
Remote repository settings
On the Git Integration page, click Create New.
Enter the repository URL of the Git server and click Integrate.
If you are using GitHub Enterprise or other means to deny access to your Git server from external IP addresses, please allow access to the IP address trocco uses for communication.
IP addresses that need to be allowed by security groups, firewalls, etc.
- Specify a branch name, register the Deploy Key with the Git server, and click Test Connection & Save.
Checking the diff
You can check the diff between the local changes and your Git repository as shown below.
- From the Git Integration page, click Check All Differences.
- Click Push to Git on the details page of each ETL and Data Mart Configuration.
Sync with Git repository (git commit & push)
From the Confirm Differences page, click Push to Git.
Enter the Commit Title and Commit Details and click Push to Git Repository.
The changes to your YAML configuration file will be reflected in your Git repository.