All Products
Search

This Product

    Compute Nest:Upgrade service instances

    Document Center

    Compute Nest:Upgrade service instances

    Last Updated:Jun 06, 2025

    After a service provider publishes a new version of a service, the service provider and customers can upgrade the service instances of the service to the new version based on business requirements. If you are a customer, you can upgrade a single service instance. If you are a service provider, you can upgrade multiple service instances at a time. This topic describes how to upgrade service instances.

    Prerequisites

    • The service that you want to manage has at least two versions, and the later version of the service supports service instance upgrades. For more information about how to create a version of a service, see Update a service. For more information about the upgrade settings of service instances, see Configure service upgrades.

    • Service instances of an earlier version are deployed. For more information about how to deploy a service instance, see Deploy service instances.

    Upgrade a single service instance

    After a new version of a service is created, you can trigger the upgrade of a service instance as a customer. This section describes how to upgrade a service instance.

    1. Log on to the Compute Nest console.

    2. In the left-side navigation pane, click Service Instance.

    3. On the Service Instance page, find the service instance that you want to upgrade and click the ID of the service instance to go to the Service Instance Details page.

    4. In the upper-right corner of the Service Instance Details page, click Upgrade Service Instance.

    5. In the Upgrade Service Instance dialog box, select the version to which you want to upgrade the service instance and click Start Upgrade.

    6. After the upgrade starts, the service instance is in the Upgrading state. After the upgrade is complete, the state of the service instance changes to Deployed and the service version becomes the version selected in Step 5. In this case, the service instance is upgraded.

    Upgrade multiple service instances at a time

    After you publish a new version of a service as a service provider, you can upgrade multiple private service instances and single-tenant fully managed service instances at a time if you are granted the upgrade permissions on these service instances.

    How it works

    Multiple service instances can be upgraded by using CloudOps Orchestration Service (OOS). To upgrade multiple service instances at a time, you can use the BulkyUpgradeServiceInstance template.

    1. Configure the parameters in the Batch Upgrade dialog box to call the ListServiceInstances operation of Compute Nest to query a list of service instances.

    2. Traverse the queried service instances and call the UpdateServiceInstanceSpec operation of Compute Nest to upgrade service instances. You can specify the number of service instances to be upgraded each time.

    3. If a service instance fails to be upgraded during the upgrade process, the upgrade task is stopped. Service instances that have not been upgraded are not upgraded in this task.

    Procedure

    1. Log on to the Compute Nest console.

    2. In the left-side navigation pane, click Service Instance. On the Service Instance page, click the My Service Instance tab.

    3. On the My Service Instance tab, find one of the service instances that you want to upgrade at a time and click the service ID to go to the Service Details page.

    4. On the Service Details page, click the O&M Management tab.

    5. In the upper-right corner of the O&M Management tab, click Batch Upgrade.

    1. In the Batch Upgrade dialog box, configure the parameters that are described in the following table.

    Section

    Description

    Configure Parameters

    In the Configure Parameters section, configure the Instance and Upgrade Service Version parameters.

    • Select the version to which you want to upgrade the service instances at a time for the Upgrade Service Version parameter. After this parameter is configured, the service instances that can be upgraded to the selected service version are displayed.

    • In the Instance section, select the service instances that you want to upgrade at a time by using one of the following methods:

      • Manually select service instances: Select service instances by service instance status and service version from the service instance list.

      • Specify service instance tags: Specify one or more tags in the same region to select service instances.

      • Specify a resource group: Specify a resource group in a region to select service instances.

      • Select all service instances: Select all service instances that match the specified service instance status and service version.

    Control Options

    In the Control Options section, configure the RateControl and OOSAssumeRole parameters.

    Note

    The parameters in the Control Options section are optional. If you do not configure these parameters, Compute Nest uses the default settings of the parameters.

    • In the RateControl section, select a rate control type and configure the corresponding parameters. For more information, see the Control the loop execution rate section of the "Loop" topic.

      • If you select Concurrency-based Control, you must configure parameters such as Concurrency and Error Threshold.

      • If you select Batch-based Control, you must configure parameters such as Batch Array, Concurrency-based Control, and Error Threshold.

    • In the OOSAssumeRole section, select a Resource Access Management (RAM) role.

    Task Settings

    In the Task Description field, enter a brief description for the task.

    1. Click Next.

    In the OK step, view the basic information and resource preview of the settings for upgrading the service instances.

    1. Click Create. After the task is created, you can view the execution status of the task on the O&M Management tab.

    1. On the O&M Management tab, find the task and click Details in the Actions column to view the status of the task.