tencent cloud


Intra-Instance Multi-Region Image Replication

Last updated: 2021-12-21 16:42:56


    Tencent Container Registry (TCR) allows users to create replicas of a premium instance in multiple regions with the same access domain name and credential as the original premium instance. It realizes the single-region upload, multi-region high-speed real-time synchronization, and image pulling from the nearest region over the private network. Compared with the cross-instance synchronization, this feature can unify the publish configuration of multi-regional clusters, improve the cross-region synchronization speed of cloud native artifacts, and help users realize the global synchronization update of service applications.

    The instance replication feature allows users to create replicas of a premium instance in multiple regions. The replica instances will synchronize data with the primary instance in real time. Users can use the domain name and access credentials of the primary instance to access the replica instances through the private network. By using the instance replication feature, users can uniformly manage the application images of the multi-regional services, and do not need to purchase multiple Enterprise Edition instances, which can reduce the usage cost, increase the speed of container image distribution, and simplify the deployment and configuration.


    Before creating and managing the replica instance of a TCR Enterprise Edition instance, complete the following preparations:


    Creating and managing a replica instance

    1. Log in to the TCR console and select Synchronization and Replication > Instance Replication on the left sidebar.
    2. On the Instance Replication page, select a region and an instance, and click Create.
    3. In the Create Replica Instance window, complete the following configurations:
      • Primary Instance Name: the name of the currently selected premium instance.
      • Default Region: the region where the currently selected premium instance is located.
      • Replicate to: the region where the replica instance is located, which cannot be the same as the region of the current primary instance.
    4. Click OK.

    You can delete the replication instances that are no longer needed in the specified region. If a premium instance has configured the replica instances, you need to delete all the replica instances first to delete the premium instance.

    Viewing image replication logs

    After configuring a replica instance, if you push an image to the primary instance, the image data will be automatically replicated to the replica instance.

    Accessing the replica instance via the private network

    1. To ensure that the container clusters or CVMs in the replication region can access the instance through the private network, you need to connect the VPCs in the replication region to the instance. Please refer to Private Network Access Control, and choose the VPC in the replication region.
    2. After the above configuration is completed, the container clusters or CVMs in the replication region can access the instance through the private network. The image access address and access credentials are the same as those of the premium instance in the original region.


    You can also use the CreateReplicationInstance API to create a replica instance. For more information, see CreateReplicationInstance.

    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