Skip to main content

Source Code Integration

Components in your system design can be connected to code repositories, allowing you to build software executables and even build containers. To do this, Tangram Pro™ can connect to both GitLab and GitHub accounts in order to retrieve source code at build time. You can also authorize your Tangram Pro™ account to access private container registries, either for using a common base container image or to integrate containers which have already been built.

tip

For more information about how to build a container in Tangram Pro™, see Containerize.

Source Code

You can manage multiple Source Code integrations in your Account or within your Teams (for shared access), and connect them to components in your projects.

Source Code

Add a Source Code Hosting Service

  1. Go to Account, or select one of your Teams and go to Source Code
  2. Click Add Hosting Service
  3. Select a Hosting Service. If an Enterprise option is selected, you can enter a custom URL like https://gitlab.myorg.tech
  4. Register an OAuth App in your hosting service (see instructions below)
  5. Enter the Client ID and Secret, and click Submit
  6. Click Link Account to complete setup. This will redirect you to GitLab or GitHub to authorize access. Click Authorize

Register an App in GitLab

  1. Log in to your GitLab account
  2. Click on your profile in the top right corner and select Preferences
  3. Select Applications on the left
  4. Add new application
  5. Enter a name
  6. Copy the Callback URL from Project Settings and paste it in the Redirect URI field in GitLab
  7. Select the api scope
  8. Click Save application
  9. Copy the Application ID from GitLab and paste it in the Client ID field in Project Settings
  10. Copy the Secret from GitLab and paste it in the Client Secret field in Project Settings

Register an App in GitHub

  1. Log in to your GitHub account
  2. Click on your profile in the top right corner and select Settings
  3. Select Developer setting on the left (towards the bottom of the list)
  4. Select OAuth Apps on the left
  5. Click New OAuth App
  6. Enter a name
  7. Copy the Homepage URL from Project Settings and paste it in the Homepage URL field in GitHub
  8. Copy the Callback URL from Project Settings and paste it in the Authorization callback URL field in GitHub
  9. Click Register application
  10. Copy the Client ID from GitHub and paste it in the Client ID field in Project Settings
  11. Copy the Client Secret from GitHub and paste it in the Client Secret field in Project Settings

You can unlink your GitLab/GitHub account by clicking the Unlink button. This will remove authorization, but save the configuration.

Remove Source Code Host

You can remove your GitLab/GitHub account by clicking the Remove button. This will remove the configuration.

Using Source Code

Within projects, you can connect components with your GitLab and GitHub accounts and access their repositories. For more information see Design: Link Source Code Repository.