Operation Guide

1. Creation and Deletion

1.1 Create Image Repository

On the Image Repository product UHub page, click on Create Image Repository, enter the name of the image repository and remarks, and create an image repository. If the current project already has an image repository, please select New Image Repository from the dropdown list under Image Repository Name.

The name of the image repository must be globally unique (which means it cannot overlap with other users, project image repository names) and each project supports up to 8 image repositories.

1.2 Delete Image Repository

Click on the Delete Image Repository button on the top right corner of the image repository console page to delete the image repository. Only empty image repositories can be deleted. If there are still images in the image repository, please delete them first.

2. Accounts and Permissions

Login on a machine with docker installed (version 1.10 or later) via docker login.

Login into the image repository and access the service via domain name:

docker login uhub.ucloud-global.com -u {user@email}

The login username is the email registered on the UCloud Global platform, and the password is your console login password.

The image repository is private by default and can only be accessed by the master account and sub-accounts with relevant permissions to the project that the image repository is in. If you want other users on the platform to pull your image, you can set your Shared Image Repository to public.

You can also disable repository image push and pull over the internet via the Internet Access switch. But if your repository permissions are set to Shared Image Repository, pushing is only disabled, and public network pull is still allowed.

2.1 Individual password usage

1. The individual password is bound to the login username, after setting, the image repository login username is still the email registered on the UCloud Global platform, the password is the set individual password.

2. Modifying the individual password applies to all image repositories, and it supports login in both UCloud Global intranet and internet.

3. The individual password is linked to the login username, not the image repository.

3. Push and Pull Images

3.1 Push Images

Step 1: Give a tag to a local image:

docker tag {local image name} uhub.ucloud-global.com/{created image repository}/{image}:tag

Step2: Push the image to the repository:

docker push uhub.ucloud-global.com/{created image repository}/{image}:tag

3.2 Pull Images

docker pull uhub.ucloud-global.com/{created image repository}/{image}:tag

4. Usage Restrictions

1. Each image can retain a maximum of 800 tags. Once this limit is exceeded, tags and associated images that have not been pulled within the past month will be subject to deletion, with priority given to the oldest uploaded images.

2. There is no limit on the size of the image, but there may be a possibility of push failure if a single layer of the image exceeds 5G.

3. The speed limit for pulling images from the public network is 1MB/s per layer.

4. Currently, it does not support the region for pulling images from the intranet: Fujian.