In Tencent Container Registry (TCR), an image repository is used to manage container images. A single image repository may contain container images with different tags. An image repository belongs to a namespace and inherits the public or private attributes and security scan triggering mode from its namespace.
The image repository is the minimum unit for permission management in TCR. The instance admin can grant the management or read-only permission to a sub-user. For example, the instance admin can grant the "tom" sub-account only the permission to pull images from the "project-a-frontend" image repository, but disallow the sub-account to push or delete images. For more information on other permission management and authorization methods, see Examples of TCR Enterprise Edition Authorization Schemes. This document describes how to create and manage an image repository in a TCR Enterprise Edition instance.
Before creating and managing an image repository for a TCR Enterprise Edition instance, you must complete the following preparations:
Creating an image repository
- Log in to the TCR console and click Image Repository in the left sidebar.
On the "Image Repository" page, you can view the image repository list of the current instance. To change the instance, at the top of the page, select the desired instance name from the "Instance Name" drop-down list.
- Click Create. In the "Create an Image Repository" window that appears, configure the image repository by referring to the following field description.
- Associated Instance: indicates the currently selected instance, to which the created image repository belongs.
- Namespace: indicates the namespace to which the image repository belongs. If the list is empty, first create a namespace in the instance.
- Name: indicates the name of the image repository. Its value must be 2 to 200 characters in length and can only contain lowercase letters, numbers, and separators including periods (
.), underscores (
_), hyphens (
-), and slashes (
/). This parameter cannot start or end with a separator or contain several consecutive separators. In addition, this name can be a cascaded path, such as
team-01/front/nginx. You can set the name based on your business requirements.
- Image source: supports "Local image push" and "Platform image building".
- Summary: indicates the brief description of the image repository. Its value is a string of up to 100 characters. You can edit the summary again after the image repository is created.
- Description: indicates the detailed description of the image repository. This parameter supports the Markdown syntax. Its value is a string of up to 1,000 characters. You can modify the description after the image repository is created.
- Click OK to create the image repository.
Image repository operations
After the image repository is created, you can view the image repository on the "Image Repository" page. Then, you can perform the following operations to manage the image repository, as shown in the following figure:
- Filtering namespaces
Select from the "Image Repository" list for filtering. Then, you can select a namespace that you want to view from the drop-down list.
- Viewing details of a repository
Click the name of a specified image repository. The repository details page appears, where you can manage the image tag and edit the basic information of the image repository.
- Deleting an image repository
You can click Delete for an image repository to delete it. Exercise caution before confirming the deletion to prevent important data from being deleted by mistake.
After the image repository is deleted, all container images in the image repository are directly deleted.
Click the name of a specified image repository. The repository details page appears, and you are directed to the Tag Management tab page by default. On this page, you can manage all image tags in the repository, perform security scans, and view the layer information, as shown in the following figure:
- Filtering image tags
In the search box in the upper-right corner of the tag list, you can enter an image tag to search for this tag. Fuzzy search is supported.
- Obtaining a pull command
You can click Pull Command for the target image tag to copy the pull command of the image tag.
- Performing a security scan
You can click Scan for the target image tag to proactively trigger a security scan. When the scanning result is output for the corresponding "Security Level", click to view the detailed result.
- Viewing the image layer information
You can click Layer Information for a target image repository to view the layer information for this image in a pop-up window.
- Deleting an image tag
You can click Delete for a target image tag to delete this image tag. Excercise caution before confirming the deletion to prevent important data from being deleted by mistake.
When a specified image tag is deleted, other image tags with the same image ID as the deleted image tag may also be deleted. If this is the case, these image tags will become unavailable.
You can use source code hosted in GitHub, GitLab.com, Gitee.com, and CODING to perform compilation and building.
Editing the repository information
On the details page of the image repository, you can click the Repository Information tab to view and edit the basic information about the image repository, as shown in the following figure:
- Editing the summary
Click for "Summary" to activate editing. After editing the summary, click Save to save the change.
- Editing the description
Click for "Description" to activate editing. After editing the description, click Save to save the change. "Description" supports the Markdown syntax. You can view the rendered text after saving the change.