Help Center/ ServiceStage/ User Guide/ Component Management/ Upgrading a Single Component/ Upgrading a Component Using a Component Template
Updated on 2025-08-12 GMT+08:00

Upgrading a Component Using a Component Template

Upgrade the version configurations of the component created by Creating a Component Using a Component Template.

Prerequisites

  • You have compressed the prepared component template files into a ZIP package and uploaded the package to the repository. For details, see Component Template Description.
    • Upload the template package to the SWR repository. For details, see Uploading a Software Package.

      If PKIToken is disabled, the SWR repository is not supported.

    • Select the corresponding template package from OBS. Upload the template package to the OBS bucket in advance. For details, see Streaming Upload (PUT).
    • If you need to use JFrog (example) as the repository for storing the component template package, you can use an HTTP/HTTPS custom file download address as the component template package download address. Upload the component template package to the custom file address in advance.

Upgrading a Component Created Using a Component Template

  1. Log in to ServiceStage.
  2. Use either of the following methods to go to the component Overview page:

    • On the Application Management page, click the application to which the target component belongs, and click the component in Component List.
    • On the Component Management page, click the target component.

  3. Choose Upgrade > Use Template in the upper right corner of the page.
  4. In the Set Template Package area, select the uploaded component template package based on the template package storage mode.

    • CodeArts release repository
      • If CodeArts release repository is not the component template repository, click Select Software Package, select the uploaded template package from the CodeArts release repository, and click OK.
      • Otherwise, click , select the uploaded template package from the CodeArts release repository, and click OK. Alternatively, click > Select Software Package, select the uploaded template package from the CodeArts release repository, and click OK.
    • OBS
      • If OBS is not the component template repository, click Select Software Package, select the uploaded template package from the OBS bucket, and click OK.
      • Otherwise, click , select the uploaded template package from the OBS bucket, and click OK. Alternatively, click > Select Software Package, select the uploaded template package from the OBS bucket, and click OK.
    • SWR repository
      • If SWR repository is not the component template repository, click Select Software Package, select the uploaded template package from the SWR repository, and click OK.
      • Otherwise, click , select the uploaded template package from the SWR repository, and click OK. Alternatively, click > Select Software Package, select the uploaded template package from the SWR repository, and click OK.
    • Custom file address: If you need to use JFrog (example) as the repository for storing the template package, perform the following operations to obtain the template package that has been uploaded to the custom file address:
      1. Enter the HTTP/HTTPS custom file download address where the software package is located. The custom file address must be the complete path of the component template package file, for example, https://172.16.0.1:8082/artifactory/template-component.zip.
      2. Determine whether to enable authentication.

        If authentication is disabled, any user can download the software package in the custom file address by default.

        Click to enable authentication. Only authenticated users can download the software package in the custom file address. Authentication mode can be User name and password authentication or User-defined Header Authentication. The authentication mode and the corresponding authentication parameters are determined by the authentication mode supported by the server where the custom file directory is located.

  5. Click Next.

    • In the Preview Template Package area, you can view the details of the component template file.
    • In the Set Parameters area, you can view and modify the component parameters.

  6. Click Upgrade.

    • During component deployment, if the component configuration is incorrect, you can click Suspend to stop the deployment. Then, click Upgrade and upgrade the component.
    • Wait until the component status changes from Upgrading/Rolling back the component to Running, indicating that the component has been upgraded.
    • On the Deployment Records page, view the deployment logs.

      If "Querying the Status of a Workload Instance" is displayed, click View Event to view details.