tencent cloud

Feedback

Basic Image Repository Operations

Last updated: 2024-07-01 18:08:02

    Overview

    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 permissions to a sub-account. 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 TCR Enterprise Authorization Management. This document describes how to create and manage an image repository in a TCR Enterprise Edition instance.

    Prerequisites

    Make sure that the following conditions are met before creating and managing an image repository in a TCR Enterprise Edition instance:
    If you are using a sub-account, the sub-account must have obtained operation permissions on the corresponding instance. For more information, see TCR Enterprise Authorization Management.

    Directions

    Creating an image repository

    1. 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, select the required instance name from the Instance Name drop-down list at the top of the page.
    2. Click Create. In the Create repository pop-up window, configure the image repository, as shown in the figure below:
    
    
    
    Associated Instance: Currently selected instance, to which the image repository belongs.
    Namespace: Namespace to which the image repository belongs. If the list is empty, 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: Source of the image. You can select Local or Platform.
    Brief Description: Brief description of the image repository. It is a string that can be up to 100 characters in length. You can 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 that can be up to 1000 characters in length. You can edit the description after the image repository is created.
    3. Click OK.

    Performing basic operations on the created image repository

    You can view the created image repository on the Image Repository page and perform the following basic operations on the image repository:
    
    
    
    Filtering namespaces On the Image Repository page, you can click
    
    and select the target namespace from the drop-down list.
    Viewing image repository details Click the name of the image repository. The details page is displayed, where you can manage image tags and edit the basic information of the image repository.
    Deleting the image repository You can click Delete next to the image repository to delete it. Carefully confirm the deletion before deleting to prevent important data from being deleted by mistake.
    Note:
    After the image repository is deleted, all container images in the image repository are deleted.

    Managing image tags

    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 tab, 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 a target image tag to copy the pulling command of the image tag.
    Performing a security scan You can click Scan for a target image tag to perform a security scan. After the scan result of the security level property appears, click
    
    to view the details.
    Viewing the image layer information You can click Layer Information next to a target image repository to view the image layer information in the pop-up window.
    Deleting an image tag You can click Delete next to a target image tag to delete this image tag. Carefully confirm the deletion before deleting to prevent important data from being deleted by mistake.
    Note:
    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.

    Building images

    You can compile the source code managed on GitHub, GitLab.com, private Gitlab, Gitee, TGit, or CODING to build images.

    Editing the repository information

    On the details page of an image repository, select the Repository Information tab. On this tab, you can view and edit the basic information of the image repository, as shown in the figure below:
    
    Editing the brief description Click
    
    next to Brief Description, edit the brief description, and then click Save.
    Editing the detailed description Click
    
    next to Detailed Description, edit the detailed description, and then click Save. The Markdown syntax is supported for the detailed description. After you save the description, you can view the effect of text rendering.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support