Updated on 2024-12-17 GMT+08:00

Creating a Batch Upgrade Release Task

Create a batch upgrade release task to upgrade the version configurations of multiple components at the same time.

Prerequisites

You have created and deployed the components to be added to the batch upgrade release task. For details, see Creating and Deploying a Component.

Creating a Batch Upgrade Release Task

  1. Log in to ServiceStage.
  2. Choose Release Management > Create Release Task.
  3. Configure the release task by referring to the following table. Parameters marked with an asterisk (*) are mandatory.

    Parameter

    Description

    *Release Task

    Name of a release task.

    Enter 2 to 64 characters. Start with a letter and end with a letter or digit. Only use letters, digits, underscores (_), and hyphens (-).

    Description

    Description of a release task. Enter up to 128 characters.

  4. Select Bulk Upgrade for Operation Type.
  5. Set Best Effort Policy.

    Enable it to continue releasing other components when a component fails to be released.

  6. Click Add Component.
  7. Select the components to be added to the release task and click OK.

    • A maximum of 64 components can be added to a batch upgrade release task.
    • Only container-deployed components whose status is Running, Not ready, Stopped, Unknown, or Abnormal can be selected.

  8. Reset the version configurations of each component by referring to the following table.

    Parameter

    Description

    Component Version

    Version number of a component.

    • By default, the version number is the time when you finish 7. The format is yyyy.mmdd.hhmms, where s is the ones place of the second in the timestamp. For example, if the timestamp is 2022.0803.104321, the version number is 2022.0803.10431.
    • You can also customize the version number in the format of A.B.C, or A.B.C.D. A. B, C, and D are natural numbers, for example, 1.0.0 or 1.0.0.0.
      NOTICE:

      The customized version number must be unique and cannot be the same as any historical version number of the component. Otherwise, the current deployment record will overwrite the historical deployment record of the same version.

    Image Package

    Click , and select the component source again. For details, see Component Source.

    • If you select an image package for a container-deployed component:
      • You can customize the container name. The name contains 1 to 63 characters, including lowercase letters, digits, and hyphens (-), and must start with a lowercase letter and end with a lowercase letter or digit.
      • Click in the upper right corner of the selected image package to change the image package source.
    • If you select a software package for a container-deployed component, you can customize the container name. The name contains 1 to 63 characters, including lowercase letters, digits, and hyphens (-), and must start with a lowercase letter and end with a lowercase letter or digit.
    • If the component source is software package and Custom file address is selected, perform the following operations:
      1. Enter the custom HTTP/HTTPS file download address of the software package.
      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.

    • Set Image Access Credential. You can select up to 16 image access credentials. Click Create Secret to create an image access credential. Secret Type must be kubernetes.io/dockerconfigjson. For details, see Creating a Secret.

    Deployment Batch

    Number of batches in which component instances are upgraded. The value range is [1, Total number of instances]. Total number of instances refers to the number of running instances of the component.

    For example, if there are 4 component instances and Deployment Batch is set to 2, these component instances are upgraded in two batches, and each batch involves two component instances.

    For container-deployed components, you can reset this parameter when Configuring a Component Upgrade Policy in 9.

    Deployment Sequence

    Set the deployment sequence of all components to be added to the release task.

    • If the selected components depend on each other, for example, the startup of a component depends on other components, set Deployment Sequence so that the depended components are deployed first.

      For example, for components A, B, and C to be added to the release task, the startup of component A depends on components B and C. Therefore, set Deployment Sequence of components B and C to 1, and set Deployment Sequence of component A to 2.

    • If the components do not depend on each other, retain the default value of Deployment Sequence. All components will be deployed in the same batch.

  9. Click Advanced Settings in the Operation column of the target component, set advanced settings, and click OK.

  10. Perform subsequent operations based on whether to release the release task by referring to the following table.

    Release or Not

    Operation

    Yes

    1. Click Complete and Execute. The system automatically checks whether the advanced settings of each component are correct.
    2. If an error is reported, perform the following operations and then continue:
      1. In the displayed dialog box, confirm the information and click OK.
      2. Click Advanced Settings in the Operation column of the abnormal component and set the parameter by referring to 9.
    3. If the advanced settings pass the pre-check, the components in the release task will be deployed in batches as configured.

      You can view the release records and release task information, and Rolling Back a Released Batch Upgrade Release Task, Cloning a Batch Upgrade Release Task, and Deleting a Release Task.

    No

    1. Click Finish. The system automatically checks whether the advanced settings of each component are correct.
    2. If an error is reported, perform the following operations and then continue:
      1. In the displayed dialog box, confirm the information and click OK.
      2. Click Advanced Settings in the Operation column of the abnormal component and set the parameter by referring to 9.
    3. If the advanced settings pass the pre-check, a release task in the To release state will be generated.

      On the Release Management page, you can view release task information, and Releasing a Release Task, Cloning a Batch Upgrade Release Task, Editing a Batch Upgrade Release Task, and Deleting a Release Task.