Integration Provider

For integrating git services, navigate to the Integrations section of your truefoundry dashboard, and go to the Git section.

In the git integrations, we currently have three types of integrations:

Github

GitHub is linked by installing the TrueFoundry GitHub app on your repositories. These can then be used with TrueFoundry. We can easily link our Github account in few steps as mentioned below:

Click on the Link Github button present in the top right corner of the Github tab for linking your Github account as shown below:

Now a pop-up window will appear asking where to install Github app as shown below:

Now click on configure where you want to install the app. Then it will ask for permissions from your github account as shown below:

Now, by clicking on install button, the app will get installed on your account. You will now be able to see your account on the dashboard as shown below:

You can also see the connected repositories of your account by clicking on ⚙️ button on the right side of that particular account.

You can also unlink your account by unlink button. It can be seen in the above figure.

Bitbucket

Bitbucket is linked via OAuth. This will allow use of any repository you have access to. We can easily link our Bitbucket account in few steps as mentioned below:

Click on the Link Bitbucket button present in the top right corner of the Bitbucket tab for linking your Bitbucket account as shown below:

Your bitbucket account which is signed in to your system will get linked. You will now be able to see your account on the dashboard as shown below:

You can also see the connected repositories of your account by clicking on ⚙️ button on the right side of that particular account.
Note : In this connected repositories section you will only see the repositories that you have admin access. Only these repositories can be used to make deployment on the platform.

You can also unlink your account by unlink button. It can be seen in the above figure.

Gitlab

To enable Gitlab integration in your app, you need to create a gitlab app using your gitlab account. This gitlab app can then be authenticated to access repositories of users' account.

Follow these steps to create the gitlab app and integrate it with truefoundry:

On the left sidebar, select Applications. Click on the Add new application button right side.

Provide the required details for Add new application.
- Name: This can be anything. Consider something like 's GitLab or 's GitLab or something else descriptive.
- Redirect URI: https://app.example-org.truefoundry.com/api/svc/v1/vcs/gitlab/callback
- Enable the Confidential check box.
- Select the following scopes: read_api, read_user, read_repository, write_repository.

Select Save application.
You should now see an Application ID and Secret.

Set environment variables in servicefoundry server :
GITLAB_APP_ID=${Application ID}
GITLAB_SECRET=${Secret}
GITLAB_SCOPE=read_api read_user read_repository write_repository