Operation Guide
1. Creation and Deletion
1.1 Create Container Registry
On the Container Registry product UHub page, click on Create Container Registry, enter the name of the Container Registry and remarks, and create a container Registry. If the current project already has a container Registry, please select New Container Registry from the dropdown list under Container Registry Name.
The name of the container Registry must be globally unique (which means it cannot overlap with other users, project container Registry names) and each project supports up to 8 image repositories.
1.2 Delete Container Registry
Click on the Delete Container Registry button on the top right corner of the container Registry console page to delete the container Registry. Only empty image repositories can be deleted. If there are still images in the container Registry, 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 container Registry 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 container Registry is private by default and can only be accessed by the master account and sub-accounts with relevant permissions to the project that the container Registry is in. If you want other users on the platform to pull your image, you can set your Shared Container Registry 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 Container Registry, pushing is only disabled, and public network pull is still allowed.
2.1 Individual password usage
-
The individual password is bound to the login username, after setting, the container Registry login username is still the email registered on the UCloud Global platform, the password is the set individual password.
-
Modifying the individual password applies to all image repositories, and it supports login in both UCloud Global intranet and internet.
-
The individual password is linked to the login username, not the container Registry.
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 container Registry}/{image}:tag
Step2: Push the image to the repository:
docker push uhub.ucloud-global.com/{created container Registry}/{image}:tag
3.2 Pull Images
docker pull uhub.ucloud-global.com/{created container Registry}/{image}:tag
4. Usage Restrictions
-
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.
-
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.
-
The speed limit for pulling images from the public network is 1MB/s per layer.
-
Currently, it does not support the region for pulling images from the intranet: Fujian.