All Products
Search
Document Center

:ECS image association

Last Updated:Oct 20, 2025

If a service provider wants to create a private service that can be deployed in multiple regions by using a custom image or an Alibaba Cloud Marketplace image, the service provider must configure image-region mappings in the service deployment template. If the service uses a custom image, the service provider must first replicate and distribute the image to the supported regions and authorize customers to use the image to create service instances. Compute Nest provides the image association feature to simplify the preceding operations. This topic describes how to use the image association feature.

Background information

A service provider specifies an image ID for an Elastic Compute Service (ECS) instance, an ECS instance group, a scaling group, or an Elastic High Performance Computing (E-HPC) cluster in a deployment template based on the image plan. Compute Nest parses the image ID in the template. The service provider needs to only associate the source image with an artifact. When a customer creates a service instance in a region, the image that has been distributed to the region is used instead of the source image.

Prerequisites

Before using the image distribution feature, you need to create an ECS image deployment first.

Procedure

  1. On the page for creating a custom private service, select ROS or Terraform as Deployment Method.

    • If you select ROS, you must specify the ImageId parameter in the template.

      1. You can specify an image ID of the following cloud resources:

      2. Specify an image ID by using the ImageId parameter.

      3. The value of the ImageId parameter must be a string. You cannot set the parameter to an input parameter or a built-in function in the template.

    • If you select Terraform, you must specify the image_id parameter in the template.

      1. You can specify an image ID of the following cloud resources:

      2. Specify an image ID by using the image_id parameter.

      3. The value of the image_id parameter must be a string. You cannot set the parameter to an input parameter or a built-in function in the template.

  2. Select one or more regions in which service instances can be created.

  3. In the Deployment Package Association section, find Associate Image and click Select Deployment Package. In the dialog box that appears, select the artifact that you want to use to replace the source image specified in the template.

    Important

    After you select an artifact, you must also select an artifact version.

    • An artifact of the draft version has not been distributed and the relevant ECS image can be used only in the region in which the image is created.

    • An artifact of a formal version has been distributed and the relevant ECS image can be used in the region in which the image is created and the regions to which the image is distributed.

  4. Save and test the service. After the service passes the test, check whether the service meets the review criteria of Compute Nest and submit the service for review. For more information, see Review criteria.

  5. After the service is approved, publish the service. For more information, see Publish a service.

What to do next

After the service is published, the associated image that has been distributed to a region is used when a customer creates a service instance in the region.