In Tencent Container Registry (TCR) Enterprise Edition, 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 image repository based on the following information. See the figure below.
- 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" and "Platform" are supported.
- Brief Description: brief description of the image repository. It is a string of up to 100 characters. You can re-edit the description after the image repository is created.
- Detailed 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.
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 confirm the deletion before deleting 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 Copy 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 of 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 confirm the deletion before deleting to prevent important data from 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, private Gitlab, Gitee code cloud, TGit 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 of the image repository, as shown in the figure below.
- Editing the brief description
Select next to "Brief Description" to enter the editing status. After editing the description, click Save to save the modification.
- Editing the detailed description
Select next to "Detailed Description" to enter the editing status. After editing the description, click Save to save the modification. "Detailed Description" supports the Markdown syntax. You can view the rendered text after the modification is saved.