Version Upgrade Installation¶
1 Upgrade Installation¶
1.1 Launcher Service Upgrade¶
When upgrading Guance, the first step is to upgrade the Launcher service. Obtain the Launcher service image of the target version. For the latest Launcher image address, refer to the document Deployment Image. On the maintenance operation machine, execute the following command to upgrade Launcher:
$ kubectl patch deployment launcher -p '{"spec": {"template": {"spec": {"containers": [{"image": "{{ Launcher 镜像地址 }}", "name": "launcher"}]}}}}' -n launcher
Execute the following command to set the launcher replica count to 1:
Or
1.2 Upgrade Application¶
On the browser of the installation operation machine, access launcher.dataflux.cn and follow the installation wizard steps to complete the Guance upgrade.
1.2.1 Add Application Configuration¶
launcher automatically detects the current Guance version and lists the newly added application configurations between the current version and the target upgrade version. Modify the values according to the configuration template, then click "Checked, Generate Configuration".
1.2.2 Upgrade Application Configuration¶
- launcher automatically detects the current DataFlux version and lists the updated application configurations between the current version and the target upgrade version. Modify the values according to the listed update content.
- Expand the configuration items marked as Configuration Updated. The left side lists the historical versions that need to be upgraded, and the right side shows the current application configuration. Modify the configuration content on the right side according to the upgrade description on the left side.
- You can also modify application configurations that are not marked as Configuration Updated. After checking the Upgrade Configuration option, you can modify the configuration.
- After confirming all configuration changes are complete, click the Confirm Upgrade Configuration button to upgrade the configuration.
1.2.3 Upgrade Database¶
launcher automatically detects the current DataFlux version and lists the applications that require database upgrades between the current version and the target upgrade version, along with the database upgrade content for each version. Click Confirm Upgrade:
1.2.4 Upgrade Application¶
launcher automatically detects the current Guance version and lists the applications that need to be upgraded or newly added between the current version and the target upgrade version. It also displays the image version comparison between the current version and the target upgrade version. Click Confirm Upgrade Application:
1.2.5 Application Startup Status¶
Displays the startup status of all updated or newly added applications. When all applications have started, the upgrade installation of this Guance version is complete.
Note: During the service restart, you must stay on this page and do not close it. Only when you see the message "Version information written successfully" and no error pop-up appears, the upgrade is successful!
1.3 Very Important Step!!!¶
After the upgrade is complete, perform post-upgrade verification. Once verified, a very important step is to take the launcher service offline to prevent accidental access and damage to the application configuration. On the maintenance operation machine, execute the following command to set the pod replica count of the launcher service to 0:
Or