Git Integration: Frequently Asked Questions

Git Integration: Frequently Asked Questions


This article is a compiled list of frequently asked and salient questions about Matillion's Git integration feature, which lets Matillion ETL users track a project's changes, both small and large, with speed and efficiency via Git version control.

Important Information and Links

This article is part of a series of technical documentation covering the Git integration feature within Matillion ETL. Additional documentation includes:

Frequently Asked Questions

Q: Can I connect Matillion to an existing Git repository that contains non-Matillion items?

A: No, we do not advise this. Matillion ETL should have sole use of this particular Git repository.

Q: Can I use Matillion's built-in versioning system in combination with Git?

A: Matillion's built-in version system will continue to operate as normal once you have converted your Matillion ETL project into a Git project. Users have the ability to switch version between Git commits. Rather than running two version control strategies in parallel, we recommend that you use Matillion versions as independent "working areas" to isolate your developers, or to separate one feature development effort from another, and so on.

Q: Can I use the Git command line tools?

A: Matillion uses a library to communicate with Git directly, so the command line tools are not supplied by default when SSHing into the Matillion instance. While the command line tools can be installed, Matillion does not recommend manually using Git tools to amend your repository from outside Matillion.

Q: Do you recommend using Git for my Matillion version control?

A: Git is a complex tool, enabling users to devise intricate development workflows. Unless your company mandates Git usage, or unless you are familiar with Git working patterns, you might find that Matillion ETL's built-in versioning, or other methods for migrating jobs between Matillion ETL projects, better suit your work requirements.

Q: How does authentication work between my local repository and my remote repository?

A: Authentication type depends on your chosen security protocol. For HTTPS, users will need to provide their remote repository account's username and password. Users must then additionally select the encryption type.

Alternatively, if users authenticate with the SSH security protocol, users must provide a valid private key and passphrase. We recommend users read this GitHub article on choosing which remote URL to use.

Q: Can I use multi-factor authentication (MFA) with Git integration in Matillion ETL?

A: Matillion does not support multi-factor authentication for its Git integration feature at this time.

Q: How do I push a single branch?

A: When performing a push action, Matillion will push all branches by default. Currently, users do not have the option to change this setting.

Contacting Support

If you have a question this page has not yet answered, please Contact Support.