Upbound Docs - Repository Management

Repository Management

This page describes how to view and manage Upbound repositories.

Viewing repositories

To view a list of repositories:

Run the following command to list repositories:

up repository list

Open the Repositories page in the Upbound Console. This page is available at console.upbound.io/<org-name>/repositories.

Update repository settings

Repositories have either public or private visibility:

public visibility means that any published versions of your package have a public listing page in the Marketplace and authorized credentials aren’t required to pull.
private visibility means that any published versions of your package have a listing page that only you and other collaborators in your organization can see. Packages require authorized credentials to pulled.

Once created, you can’t change these repository settings.

To delete a repository, do the following:

Run the following command to list repositories:

up repository list

Run the following command to delete the repository:

UPBOUND_REPO_NAME=
up repo delete ${UPBOUND_REPO_NAME} --force

Open the Repositories page in the Upbound Console.
Select the repository from the list.
Select Settings.
Select Delete Repository
Confirm deletion by again selecting Delete Repository.

Update repository permissions

To update the permissions for who can access and perform actions on a repository, do the following:

Run the following command to list teams:

up team list

Run the following command to grant a permission:

UPBOUND_TEAM_NAME=
UPBOUND_REPO_NAME=
UPBOUND_REPO_PERMISSION=
up repository permission grant ${UPBOUND_TEAM_NAME} ${UPBOUND_REPO_NAME} ${UPBOUND_REPO_PERMISSION}

Run the following command to revoke a permission:

UPBOUND_TEAM_NAME=
UPBOUND_REPO_NAME=
up repository permission revoke ${UPBOUND_TEAM_NAME} ${UPBOUND_REPO_NAME}

To grant a permission to one or more teams, do the following:

Open the Repositories page in the Upbound Console.
Select the repository from the list.
Select Permissions.
Select Create Permission
Select the role you want to grant.
Select all teams you wish to grant the role to.
Select Create Permissions.

To revoke a permission from a team, do the following:

Open the Repositories page in the Upbound Console.
Select the repository from the list.
Select the “more actions” ellipsis button next to the team you wish to revoke.
Select Remove.