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 the repository_project_manage role assigned in the Identity Broker.

Link a new repository in AtScale

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. For instructions on obtaining the correct URL for your Git provider, see Obtain the URL for your repository below.

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

Obtain the URL for your repository

To link a repository to AtScale, you need its URL. How you obtain this depends on your Git provider.

GitHub

1. Log in to GitHub and navigate to the repository you want to link to AtScale.
2. Click Code.
3. On the Local > HTTPS tab, copy the URL.

Microsoft Azure DevOps

1. In your browser, open the default branch of the repository you want to link to AtScale.
2. Copy the URL of the page.

Note

Do not use the Clone button, as this generates a personalized URL.

Atlassian Bitbucket

1. Open the repository in Bitbucket and click Clone > HTTPS. This gives you a command similar to the following:

   git clone https://<username>@bitbucket.org/<workspace>/<repo>.git

2. Copy the command, then remove git clone from the beginning and <username>@ from the URL. The new URL should have the following format:

   https://bitbucket.org/<workspace>/<repo>.git

GitLab

1. Log in to GitLab and navigate to the repository you want to link to AtScale.
2. Click Code and copy the URL for Clone with HTTPS.

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.