tencent cloud

Service Registry and Governance

zero-downtime decommissioning

PDF
Focus Mode
Font Size
Last updated: 2026-05-07 18:07:07

Feature Overview

During a rolling release or deactivation process, when a service instance of the called service deregisters from the registry, and the calling service updates IPs from the registry, a time gap exists. This may still route requests to deactivated instances, causing service request failures.
Polaris provides a graceful shutdown interface: /offline, port: 28080, integrating with the Kubernetes lifecycle to achieve lossless service deactivation. The overall process is as follows:


Operation Steps

To implement service routing, you need to complete two parts of operations:
On the Tencent Cloud console, enable the graceful shutdown toggle.
Client-side integration with the graceful shutdown plugin. Polaris provides two integration approaches:
SpringCloud Tencent
Java Agent
The following section will detail the usage steps.

Console Operation Steps

2. In the left sidebar, under Service Governance Center, click Service Management, select the target Polaris engine and target service, and go to the Service Details page.
3. Click the Lossless Launch/Shutdown TAB.
4. In the graceful shutdown configuration box, click the Settings button.

5. Enable the configuration switch based on your business requirements.

6. Configure the preStop lifecycle hook in Kubernetes application deployment platforms such as TKE.
preStop configuration check command: curl -X PUT http://localhost:28080/offline && sleep 20

Application Client Operational Steps

Polaris provides two integration approaches:
SpringCloud Tencent
Java Agent
SpringCloud Tencent
Java Agent
1. Services integrate with Polaris service registration and discovery capabilities through Spring Cloud Tencent. For specific steps, see: Registration and Discovery.
2. Add the spring cloud tencent lossless launch/shutdown plugin dependency.
Add dependencies in pom.xml:
<dependencies>
<dependency>
<groupId>com.tencent.cloud</groupId>
<artifactId>spring-cloud-tencent-lossless-plugin</artifactId>
</dependency>
</dependencies>
Services integrate with Polaris through Java Agent. For specific steps, see: Accessing via Java Agent.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback