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.

Add a new repository to AtScale

To add a new Git repository to AtScale:

1. In Design Center, open the Workspace panel.

2. Click the three dot icon at the top of the panel and click Add Repo.

   

   The Add Repo panel opens.

3. In the Add 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 Add Repo.

Obtain the URL for your repository

To add 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 add 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 add 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 add to AtScale.
2. Click Code and copy the URL for Clone with HTTPS.

Edit a repository

You can edit the names and URLs for your repositories from the Workspace panel.

To edit an existing Git repository:

1. In Design Center, open the Workspace panel.
2. In the Repo field, switch to the repository you want to edit.
3. Click the three dot icon next to the Repo field and select Edit. The Edit Repo panel appears.
4. Edit the Repo Name, URL, and Visible Branches Pattern as needed, then click Save.

Remove a repository

To remove a repository from AtScale:

1. In Design Center, open the Workspace panel.
2. In the Repo field, switch to the repository you want to remove.
3. Click the three dot icon next to the Repo field and select Remove.
4. In the dialog that appears, click Remove.