Help Center> CloudArtifact> User Guide> Self-Hosted Repo> Managing Self-Hosted Repos
Updated on 2022-09-29 GMT+08:00

Managing Self-Hosted Repos

You can edit or delete self-hosted repos and manage user permissions for them.

Editing a Repository

You can modify basic information about a self-hosted repo such as the repository name and description but cannot change the repository format.

  1. Access the self-hosted repo homepage. In the left pane, click the name of the repository to be edited.

  2. Click Set Repository on the right of the page. The basic information about the repository is displayed.

  3. Edit repository information as required, and click OK.

Deleting a Repository

You can delete a self-hosted repo. Deleted repositories are moved to the recycle bin.

  1. Access the self-hosted repo homepage. In the left pane, click the name of the repository to be deleted.
  2. Click Set Repository on the right of the page. The basic information about the repository is displayed.

  3. Click Delete Repository on the right of the page. The deleted repository is not displayed in the list on the left of the page.

Managing User Permissions

To add members to or delete members from a self-hosted repo, perform the following steps:

  1. Access the Set User Permissions page.

    Access the self-hosted repo homepage. Click above the repository list on the left and choose Set User Permissions.

  2. Add members.

    Click Add Member in the upper right, select members, and click OK.

  3. Assign roles to the members.

    1. In the Operation column of the target member, click .
    2. Click the Available tab.
    3. Select a repository as required.
    4. Select a role and click OK.

A tenant administrator can add members to or delete members from a self-hosted repo and manage the roles of members in the repository.

The following table lists the operation permissions of each repository role.

Operation/Role

Tenant Administrator

Non-Tenant Administrator

Repository Administrator

Developer

Viewer

Repository Administrator

Developer

Viewer

Create a self-hosted repo

×

×

×

Edit a self-hosted repo

×

×

×

×

×

Manage the association between repositories and projects

×

×

×

Upload a self-hosted component

×

×

Download a component

Delete a component

×

×

Restore a component

×

×

Permanently delete a component

×

×

Delete a repository

×

×

×

×

×

Restore a repository

×

×

×

×

×

Permanently delete a repository

×

×

×

×

×

Clear the recycle bin

×

×

×

Restore all

×

×

×

Manage user permissions

×

×

Reset the password of a public account

×

×

×

You can also perform the following operations on the Set User Permissions page.

Operation

Description

Delete members

To delete a member, click in the corresponding row. To delete multiple members, select them and click Batch Delete.

Modify member permissions

Click . In the displayed dialog box, select the repository name, and click OK.

View members

Select the repository type and name in the upper left corner of the page. The member list of the repository is displayed.

Click Reset in the upper part of the page to view the list of all members.

Remove a member

Select a repository and click in the member list to remove the member from the repository.

NOTE:

Removing a member from a repository does not affect the role and permissions of the member in other repositories.

Deleting a member is to remove it from all the related repositories. The corresponding permissions of the member for those repositories are also deleted.

Search for a member

Enter a member name or keyword in the search box in the upper part of the page and click to search for a repository member.

Reset the password of a public account (This function is available only to tenant administrators.)

The password of a public account is used by the CloudBuild service to upload and download components to the self-hosted repo and is invisible on the page. Click Reset Public Password in the upper right corner of the page to reset the password.

Set-Up

You can connect the self-hosted repo to a local development environment so that self-hosted components in the self-hosted repo can be used during local development.

  1. Access the self-hosted repo homepage. In the left pane, click the name of the repository to be connected to the local development environment.
  2. Click Operation Guide.

  3. In the displayed dialog box, click Download Configuration File to download the configuration file to your local directory.

  4. Copy the downloaded file to the corresponding directory based on the instructions in the Information dialog box.

Resetting a Password

You can reset the password in the self-hosted repo configuration file. After the password is reset, download the configuration file again to replace the original file.

  1. Access the self-hosted repo homepage. Click above the repository list on the left and choose Reset Password.

  2. In the displayed dialog box, click Yes. Check that a message is displayed indicating the password has been reset.

Obtaining the Self-Hosted Repo Address

The address of the self-hosted repo will be used when you connect the repository to the local development environment. You can perform the following operations to obtain the address:

  1. Access the self-hosted repo homepage. In the left pane, click the repository name.
  2. On the page, the URL of the self-hosted repo is displayed. You can click to obtain the URL.

Managing the Association Between Repositories and Projects

When uploading a Maven component to the self-hosted repo through a build task, specify the repository path in the Build with Maven step.
  • Do not configure POM: The dependency package is not released to the self-hosted repo.
  • Configure all POMs: If you run the mvn deploy command, the dependency package is released to the specified release repository and snapshot repository.

After the Maven repository is associated with a project, you can select the repository in the build step of the build task in the project.

  1. Access the self-hosted repo homepage. In the left pane, click the name of a Maven repository.
  2. Click Set Repository on the right of the page.
  3. In the Operation column of the target project, click .
  4. In the displayed dialog box, click the repository name, and click OK.

    After an "Operation successful" message is displayed, the value of Associated Repositories for the project will be updated according to the number of selected repositories.