Tenant resources

In TRAC PROFESSIONAL this page allows Admins to manage Repository, Storage locations and Runtime environment resources. In TRAC COMMUNITY, Repository. is the only configurable resource type.

You automatically have access to TRAC’s ‘examples’ repo, which should look like.

select file

You don’t need to do anything to access the models in this repository.

GitHub authentication

TRAC uses service accounts to access repositories and for private repositories, the service account needs to be authenticated using a token.

To add a private repo, first authenticate yourself using one of the methods at the top of the page.

select file

It should now show you as ‘logged in’.

Note

If you haven’t already authorised GitHub O-Auth application you will be prompted to do so.

Note

If you have to request access for an organisation, you can add the repository but won’t be able to import a model until the request is approved.

Adding a repository

Click ‘Add repository’ and a new blank object will appear.

First, give it a Key, then populate the Properties.

select file

The first 8 properties allow TRAC to identify the repository.

User authentication method defines how users browsing the repository to select models for import are authenticated. The two options are via the OAUTH application (github-auth) or using PAT tokens (Manual).

Note

Check which User authentication method is permitted for the organisation. Either method can be blocked by settings in GitHub.

For private repo’s click ‘Add token’. If you see an error message, authenticate yourself and retry.

select file

Once complete, click Save and confirm. You should see a confirmation message and the new resource listed.

select file

Note

Basic format validations on the repository properties are completed here but the repo connection is not tested. Some errors and access issues may not be identified until trying to import a model.

Editing a repository

You can edit a repo’s Properties and update the Token but cannot edit the Key.

Click ‘Edit’ at the bottom of a repository object to unlock it, then edit and re-save.

select file

Deleting a repository

If a repository is deleted, TRAC can no longer use it to import models or run jobs. Models already imported from will still appear in the platform but will no longer executable.