Skip to content

Installing the Matillion Data Productivity Cloud app in GitHub

When creating a new project in the Data Productivity Cloud, the Select project configuration page asks you to choose either Matillion managed or Advanced settings. Choosing Advanced settings enables you to connect your own GitHub repository to your Data Productivity Cloud project. Once you connect your GitHub repository to the Data Productivity Cloud, your data pipelines built using Designer can be committed and pushed to your GitHub repository.

Read Prerequisites for connecting a GitHub repository to the Data Productivity Cloud before installing the app.

Warning

Matillion strongly recommends that you use the new repository that you created and intend to connect to the Data Productivity Cloud solely for the purpose of developing your Designer pipelines.

Note

It may be advisable to use your repository's README file to describe the purpose of the repository and the pipelines developed therein.

How to install the app

  1. Log in to GitHub.
  2. Navigate to the Data Productivity Cloud listing.
  3. Make sure you are about to install to your company's GitHub organization and not your personal account, and then click Install.
  4. Select All repositories or Only select repositories.
    • If you select All repositories, you can choose any current or new repos in your GitHub organization when you create a new project in the Data Productivity Cloud.
    • If you select Only select repositories, choose the repository that you created for the sole purpose of developing your Designer pipelines.

Note

We recommend that you choose Only select repositories to allow access only to repositories that you intend to use with the Data Productivity Cloud. If you select this option and then create new repositories in GitHub, you'll need to grant access to these new repositories if you want to connect them to the Data Productivity Cloud. To do this, visit https://github.com/organizations/<your-org-name>/settings/installations (replacing "your-org-name" with your organization name) and click Configure. From this page, you can view the list of repositories that the Matillion GitHub app has access to. If no repositories are selected, create a repository in that organization first, and then create a project in the Data Productivity Cloud.

Once the Matillion Data Productivity Cloud app is installed in your GitHub organization, you can create your project in Designer and connect your project to your GitHub repository.

One-time installation

You only need to install the Matillion Data Productivity Cloud app in your GitHub organization once. After this, whenever you create a new project in the Data Productivity Cloud, you can connect to any repositories that you grant the Data Productivity Cloud access to.

If you wish to revoke or change Designer's access to your repositories, go to https://github.com/organizations/<your-org-name>/settings/installations (change <your-org-name to the organization in your GitHub URL) and click Configure.