Contents x
    Git Integration - Overview
    • 31 Jul 2023
    • 2 Minutes to read
    • Print
    • Dark
      Light
    Contents

    Git Integration - Overview

    • Updated on 31 Jul 2023
    • 2 Minutes to read
    • Print
    • Dark
      Light
    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?
    What's Next