Git Integration - Overview
  • 31 Jul 2023
  • PDF

Git Integration - Overview

  • PDF

Article Summary

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.

Note

The Git Integration feature is a paid option.
Please get in touch with your sales or customer success agent to enable this feature.

Hosting services supported by this function

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

image.png

About the User integration type

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

image.png

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/RoleAdministratorEditorOperatorViewerNo 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.
    image 13.png
Resource groups not displayed on the Git integration page

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

  1. On the Git Integration page, click Create New.

  2. Enter the repository URL of the Git server and click Integrate.
    image.png

IP address permission request

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.

  1. Specify a branch name, register the Deploy Key with the Git server, and click Test Connection & Save.
    image.png

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.
    image.png

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.
image.png


Was this article helpful?