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 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.

Add a Source Code Hosting Service​

You can manage multiple Source Code integrations in your User Settings (for personal use) or within your Teams (for shared access with your team members), and connect them to components in your projects.

  1. Either go to User Settings or Teams:
    • To add an integration for personal projects: open User Settings and go to Source Control
    • To add an integration for team projects: open Teams, select a Team and go to Source Control
  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. Click the Register an OAuth App link
  5. Continue the setup in GitLab or GitHub:

Source Code

Register an App in GitLab​

  1. Log in to your GitLab account
  2. Add a New Application (Click on your profile in the top right corner, and go to Preferences > Applications)
    • Enter a name
    • Copy the Redirect URI from Tangram Pro and paste it in the Redirect URI field in GitLab
    • Select the api scope
  3. Click Save application
  4. Copy the Application ID from GitLab and paste it in the Application ID field in Tangram Pro
  5. Copy the Secret from GitLab and paste it in the Secret field in Tangram Pro
  6. Click Submit

You will be redirected to your GitLab account to authorize access

Register an App in GitHub​

  1. Log in to your GitHub account
  2. Add a New OAuth App (Click on your profile in the top right corner, and go to Settings > Developer settings > OAuth Apps)
    • Enter a name
    • Copy the Homepage URL from Tangram Pro and paste it in the Homepage URL field in GitHub
    • Copy the Callback URL from Tangram Pro and paste it in the Authorization callback URL field in GitHub
  3. Click Register application
  4. Copy the Client ID from GitHub and paste it in the Client ID field in Tangram Pro
  5. Copy the Client Secret from GitHub and paste it in the Client Secret field in Tangram Pro
  6. Click Submit

You will be redirected to your GitHub account to authorize access

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

Remove Source Code Host​

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

Using Source Code in Projects​

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