This topic describes how to update custom images by using Operation Orchestration Service (OOS). OOS provides public templates to update images automatically. To create an immediate or scheduled O&M task, you only need to select a source image and specify required parameters such as the Cloud Assistant command in a public template. The O&M task is then automatically executed based on the definitions in the template.

Background information

You can use the ACS-ECS-UpdateImage template to sequentially execute the following tasks to update the image to a new custom image:
  1. Check whether the name of the new custom image already exists and make sure that the name complies with the naming conventions.
  2. Create and launch a temporary ECS instance based on parameters such as the instance type, source image ID, and security group ID that you have configured.
  3. Check whether the Cloud Assistant client is installed on the temporary ECS instance. If not, install the Cloud Assistant client.
  4. Run scripts by using Cloud Assistant to update the system environment of the instance.
    Note OOS calls Cloud Assistant API operations to run shell, bat, or PowerShell scripts to update the system environments of ECS instances. For more information, see Overview.
  5. Stop the temporary ECS instance.
  6. Create a custom image from the temporary ECS instance.
  7. Release the temporary ECS instance.


  1. Log on to the ECS console.
  2. In the left-side navigation pane, choose Instances & Images > Images.
  3. In the top navigation bar, select a region.
  4. On the Images page, click the Custom Image tab.
  5. Find the image that you want to update, click the More icon in the Actions column, and then click Update Image.
  6. In the Operation Orchestration Service console, perform the following operations:
    1. Complete the configurations in the General Settings section, including New Image Name, Description, and Permissions.
    2. Optional:Complete the Image Distribution settings. You can set whether to copy or share the image.
    3. Select an image. If you have selected an image in Step 6, the image is automatically selected in this step. Check whether the selected image is the one you want to update.
    4. Configure an intermediate instance. Set VPC, vSwitch, Security Group, and Instance Type to create the intermediate instance.
    5. Optional:Send remote commands. You can select a command type and enter the command content. The command is executed on the intermediate instance.
    6. Optional:Complete the advanced settings. You can configure scaling groups, add tags, or save the current configurations as a template.
  7. Click Execute Now, and confirm the prompt information in the Confirm Balance message.
  8. On the Create or Update Images page, you can view the task status.


If the O&M task is created and is in the Running state, the image is being updated. When Task Status changes to Success, the image is updated. You can click Details in the Actions column corresponding to the execution and view the ID of the new image in the Output Parameters section of the Basic Information tab.
Note To view details of the update process, click Details in the Actions column corresponding to the execution and click the Logs tab.