Managing Git Repositories in AtScale

AtScale admins can manage the Git repositories connected to your AtScale instance from the Workspace panel.

note

To perform these workflows, you must have either the admin or application_admin role assigned in the Identity Broker.

Link a new repository

To link a new Git repository to AtScale:

1. In Design Center, open the Workspace panel.

2. Click the context menu at the top of the panel and select Link.

   

   The Link Repo panel appears.

3. In the Link Repo panel, complete the following fields:

   • Repo Name: Enter a name for the repository to use within AtScale.

   • URL: Enter the URL for the repository.

     note

     For Azure DevOps, obtain the URL by opening the default branch of the repository in your browser and copying the URL of the page. Do not use the Clone button, as this generates a personalized URL.

   • Visible Branches Pattern: Optional. Determines which branches in the repository are visible to Design Center users.

     Enter a regular expression to filter the branches. You can include multiple patterns separated by commas. For example, ^release/.*, ^(main|develop)$.

     Branches that match the pattern will be visible. If no branches match, only the default branch will be visible.

     note

     The default branch is always visible and cannot be hidden.

4. Click Link Repo.

Edit a repository

You can edit the name and URL for your repositories from the Workspace panel.

To edit an existing Git repository:

1. In Design Center, open the Workspace panel.
2. Click the context menu at the top of the panel and select Edit. The Edit Repo panel appears.
3. Edit the Repo Name, URL, and Visible Branches Pattern as needed, then click Save.

Unlink a repository

To unlink a repository from AtScale:

1. In Design Center, open the Workspace panel.
2. Click the context menu at the top of the panel and select Unlink.
3. In the dialog that appears, click Unlink.