HAP Microservices Upgrade
1. Pulling Images
Before initiating the upgrade, ensure that all microservice nodes have successfully imported the images corresponding to their architecture (for offline environments, please refer to Offline Package Download first).
If there is no real-time progress output during the image pulling process, please wait for the task to complete patiently.
- x86_64 (AMD)
- ARM64
crictl pull registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap:7.2.3
crictl pull registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap:7.2.3
2. Upgrading Microservices Version
-
Resource Requirements: Rolling Upgrade requires approximately 40% free memory on each node server. If resources are insufficient, choose the Non-Rolling Upgrade option.
-
Additional Operation Check: Before upgrading, please carefully review the Version Release History page. If there are versions with the label “Includes Additional Operations” between the current version and the target version, ensure that corresponding guidelines are followed to complete the necessary tasks.
-
License Validity Check: Verify that your license key remains valid for the "upgrade service" period. If the release date of the target major version exceeds the license expiry date, forcing an upgrade will trigger system restrictions and cause the license to automatically downgrade to the free version. It is recommended to confirm the alignment between the version release date and licensing period prior to upgrading.
- Rolling Upgrade (Recommended)
- Non-Rolling Upgrade
Go to the configuration file directory on the control node (default directory: /data/mingdao/script/kubernetes) and execute the following upgrade command:
- x86_64 (AMD)
- ARM64
bash update.sh update hap 7.2.3
bash update.sh update hap-arm64 7.2.3
- Estimated Duration: Restart is expected to complete within 3-5 minutes.
- Status Verification: Run
kubectl get pod, and confirm all Pod statuses have returned to2/2.
If server resources are constrained, stop services before performing the upgrade. Execute the following in the configuration file directory on the control node:
1. Stop Microservices
bash stop.sh
2. After confirming that Pods have been destroyed, execute the upgrade script
- x86_64 (AMD)
- ARM64
bash update.sh update hap 7.2.3
bash update.sh update hap-arm64 7.2.3
- Status Verification: After startup is completed, execute
kubectl get podto check if Pod statuses are2/2.