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 attribute and security scan triggering mode from its namespace.
An image repository is the minimum unit for permission management in TCR. The instance admin can grant image repository 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 about other permission management and authorization methods, see Example of Authorization Solution of the Enterprise Edition. 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, complete the following tasks:
Creating an image repository
- Log in to the TCR console and select 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, select the desired instance name from the "Instance Name" drop-down list at the top of the page.
- Click Create. In the "Create an Image Repository" window, configure the following shown in the figure below for the image repository.
- Associated Instance: currently selected instance, to which the created image repository belongs.
- Namespace: namespace to which the image repository belongs. If the list is empty, you must create a namespace in the instance.
- Name*: name of the image repository. The value must be 2 to 200 characters in length and can only contain lowercase letters, numbers, and separators (including periods (.), underscores (_), hyphens (-), and slashes (/). It cannot start or end with a separator or contain several consecutive separators. The name can be a multi-level path, such as
team-01/front/nginx. You can set the name flexibly based on your business requirements.
- Image Source: "Local Push" and "Auto Build" are supported.
- Summary: brief description of the image repository. It is a string of up to 100 characters. You can re-edit the summary after the image repository is created.
- Description: detailed description of the image repository. This parameter supports the Markdown syntax. It is a string of up to 1000 characters. You can modify the description after the image repository is created.
- Click OK to create the image repository.
Basic 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 operations shown in the figure below to manage the image repository.
- Filtering namespaces
Select from the "Image Repository" list for filtering. Then, you can select a namespace to view from the drop-down list.
- Viewing details of a repository
Click the name of a specified image repository. The repository details page is displayed, where you can manage the image tag and edit the basic information of the image repository.
- Deleting an image repository
You can click Delete next to an image repository to delete it. Carefully review the deletion operation before confirming it to prevent important data from being deleted by mistake.
After the image repository is deleted, all container images in the image repository are deleted.
Click the name of a specified image repository. The repository details page is displayed, and the Tag Management tab is selected by default. On this page, you can manage all the image tags in the repository, perform security scans, and view the layer information, as shown in the figure below.
- Filtering image tags
In the search box in the upper-right part of the tag list, you can enter an image tag to search for this image tag. Fuzzy search is supported.
- Obtaining the pulling command
You can click Pull Command next to the target image tag to copy the pulling command of the image tag.
- Performing a security scan
You can click Scan next to the target image tag to actively trigger a security scan. When the result is available for the corresponding "Security Level" attribute, click to view the detailed result.
- Viewing the image layer information
You can click Layer Information next to a target image repository to view the layer information for this image in the pop-up window.
- Deleting an image tag
You can click Delete next to the target image tag to delete this image tag. Carefully review the deletion operation before confirming it to prevent important data being deleted by mistake.
When a specified image tag is deleted, other image tags that have the same image ID as the deleted image tag may also be deleted. Consequently, these image tags will become unavailable.
You can use the source code hosted on GitHub, GitLab.com, Gitee code cloud, or CODING to compile and build an image.
Editing the repository information
On the details page of the image repository, you can select the Repository Information tab to view and edit basic information about the image repository, as shown in the figure below.
- Editing the summary
Select next to "Summary" to enter the editing state. After editing the summary, click Save to save the modification.
- Editing the description
Select next to "Description" to enter the editing state. After editing the description, click "Save" to save the modification. "Description" supports the Markdown syntax. You can view the rendered text effect after the modification is saved.