tencent cloud

Service Registry and Governance

Upgrading the Gateway Edition

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-05-07 17:26:54

Overview

If the current gateway version has entered the decommissioning phase, to ensure the stable operation of the gateway instance, it is recommended that you upgrade your gateway to a stable version via the console.
Note:
To ensure a successful upgrade, please do not perform any modification operations on the gateway instance before or during the upgrade process. During the upgrade, write access to the Gateway Console will be disabled. Please plan your upgrade schedule accordingly.

Version upgrade

1. Log in to the Microservices Platform Console, click Cloud Native Intelligent Gateway > Instance List in the left sidebar.
2. If the gateway version column shows Upgrade Available, under Actions > More, click Upgrade Gateway Version. On the Instance Information > Basic Information card, find the product version and click Upgrade.
3. Click OK to enter the version upgrade process.
4. An upgrade environment check will be performed before the upgrade. You must ensure that all check items pass before proceeding with the upgrade. If any check fails, you can fix the issue and then click Recheck to re-run the environment check. The check items are as follows:
Check Item
Pass Condition
Remediation Action
Instance State
The status is Running.
Wait for the instance modification to complete, and then perform a recheck after its status becomes Running.
Backend Service State
No service has a backend pointing to the gateway admin address.
Delete the service or modify the service address, and then perform a recheck.
AS State
All AS rules are disabled.
Disable the enabled AS rules, and then perform a recheck.
Number of Subnet IP Addresses
Sufficient subnet IP addresses
Go to the VPC, release the subnet IP addresses, and then perform a recheck.
Node Weight
Consistent node weights
Go to Instance Details > Basic Information > Deployment Architecture, manually adjust the node weights, and then perform a recheck after the node weights are made consistent.
5. Confirm the instance ID and instance name, select the target version for upgrade, read and select the gateway upgrade instructions, click Confirm to start the upgrade. The entire upgrade process takes time depending on the current number of nodes in the instance. It may take longer if there are many nodes. You can check the task status in the status bar in the gateway list.

View Upgrade Task Progress

1. Click Cloud Native Intelligent Gateway > Instance List, find the target gateway, click Status, click View Task Status.
2. The upgrade adopts a canary policy, divided into two phases, Version Upgrade and Resource Reclamation. Version Upgrade is primarily used to configure component resources for the upgrade, during which nodes may be added. After the version upgrade is completed, resource reclamation is required to destroy excess nodes generated during the upgrade process. Therefore, you need to manually confirm and agree to perform resource reclamation, after which the gateway will automatically trigger the old resource reclamation process.

Cancel Upgrade

If business abnormalities are detected during the upgrade process, the upgrade can be revoked.
1. Click Cloud Native Intelligent Gateway > Instance List, find the target gateway, click Status, click View Task Status.
2. Click Cancel Upgrade. The gateway will initiate the upgrade cancellation task to roll back traffic and ensure production stability.

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백