当前位置：首页 > article >正文

通过Nacos API实现微服务不间断部署

article 2025/3/12 20:24:07

在以 Nacos 作为服务注册与服务发现的微服务部署架构里，出于高可用性考量，每个微服务通常会部署至少两个实例。然而，在线上服务部署过程中，当停止其中一个实例时，因 Gateway 更新存在延迟，在新服务启动阶段，仍会有请求被错误分配至该已停止实例，进而致使前端调用服务出现不可用状况。本文旨在从Nacos工作机制出发，详细阐述一种借助 Nacos API 达成前端无感知的微服务部署方法，为解决该问题提供有效思路与方案。

一. Nacos 服务注册与发现的工作机制

1. 服务注册流程

（1）服务实例启动

当一个服务实例启动时，它会读取配置文件中关于 Nacos 服务注册中心的地址信息。

（2）发送注册请求

服务实例使用 Nacos 客户端 SDK 向 Nacos 服务端发送注册请求，请求中包含服务实例的相关信息。例如，在 Spring Cloud 应用中，Spring Cloud Alibaba Nacos Discovery 会自动完成这一过程。

（3）Nacos 服务端处理

Nacos 服务端接收到注册请求后，会将服务实例信息存储在内存中的服务注册表中，并持久化到磁盘，以防止数据丢失。同时，Nacos 会为该服务实例分配一个唯一的实例 ID。

（4）心跳机制

服务实例注册成功后，会定期向 Nacos 服务端发送心跳包，以表明自己处于健康状态。Nacos 服务端会根据心跳信息判断服务实例的健康状态，如果在一定时间内没有收到某个服务实例的心跳包，会将其标记为不健康。

2.服务注销流程

（1）主动注销

服务实例关闭：当服务实例需要正常关闭时，会调用 Nacos 客户端 SDK 的注销方法，向 Nacos 服务端发送注销请求。
从Nacos管理后台下线微服务。
通过Nacos API下线微服务。

（2）被动注销

心跳超时：如果 Nacos 服务端在一定时间内（由配置的心跳超时时间决定）没有收到某个服务实例的心跳包，会将该服务实例标记为不健康。
实例移除：经过一段时间（由配置的实例过期时间决定）后，Nacos 服务端会将标记为不健康的服务实例从服务注册表中移除。

（3）Nacos 服务端处理

Nacos 服务端接收到注销请求后，会从服务注册表中移除该服务实例的信息，并更新相关的服务元数据。

（4）通知订阅的客户端更新服务列表

3.部署思路

基于以上Nacos注销流程，我们可以在不停止微服务的情况下，先通过Nacos API使得某个微服务实例下线，在Nacos通知客户端（网关服务）更新服务列表后，再部署该实例。

二. 服务下线脚本

通过调用Nacos API nacos/v2/ns/instance，设置参数enabled=false，使服务在nacos中下线。

如果使用dubbo进行服务间通讯，则同时要把对应的dubbo服务也下线：

#!/bin/bash  
  
# 定义一个数组来存储服务名称和端口号的映射
declare -A services_ports
services_ports[service1]=18001
services_ports[service2]=18002

declare -A dubbo_ports
dubbo_ports[service1]=20900
dubbo_ports[service2]=20901

username=nacos_username
password=nacos_password

server_ip=$1
service_name=$2
service_port=${services_ports[$service_name]}
dubbo_port=${dubbo_ports[$service_name]}


echo set $service_name service offline 
curl -X PUT 'http://192.168.0.xx:8848/nacos/v2/ns/instance?namespaceId=prod&groupName=DEFAULT_GROUP&serviceName='$service_name'&ip='$server_ip'&port='$service_port'&clusterName=DEFAULT&enabled=false&username='$username'&password='$password''
echo ""
echo set $service_name dubbo service offline 
curl -X PUT 'http://192.168.0.xx:8848/nacos/v2/ns/instance?namespaceId=prod&groupName=DUBBO_GROUP&serviceName='$service_name'&ip='$server_ip'&port='$dubbo_port'&clusterName=DEFAULT&enabled=false&username='$username'&password='$password''  
echo ""

替换以下内容：

（1）脚本中的service1为具体的服务名称，端口号为对应服务的端口号。

（2）username为Nacos的用户名，password为nacos的密码。

（3）http://192.168.0.xx:8848 修改为nacos服务的地址和端口。

（4）修改Curl 命令后面的参数groupName的值为具体nacos中的group名称。

保存上面的脚本保存为set_service_off.sh,并设为可执行：

chmod +x set_service_off.sh

使用以下命令：

./set_service_off.sh ip service_name

其中ip为微服务所在服务器的ip；service_name 为脚本中定义的微服务名称

三. 服务网关更新服务列表

在调用服务下线后，等待1-3秒，将不再有请求分配到该实例上。可通过执行下线脚本后执行

sleep(3)

四. 部署微服务

通过脚本或者通过自动化部署平台集成服务下线和上线脚本。

五. 服务上线脚本

服务上线脚本可以复制服务上线脚本，修改Nacos API其中的参数enabled=true，来上线微服务。

#!/bin/bash  
  
# 定义一个数组来存储服务名称和端口号的映射
declare -A services_ports
services_ports[service1]=18001
services_ports[service2]=18002

declare -A dubbo_ports
dubbo_ports[service1]=20900
dubbo_ports[service2]=20901

username=nacos_username
password=nacos_password

server_ip=$1
service_name=$2
service_port=${services_ports[$service_name]}
dubbo_port=${dubbo_ports[$service_name]}


echo set $service_name service offline 
curl -X PUT 'http://192.168.0.xx:8848/nacos/v2/ns/instance?namespaceId=prod&groupName=DEFAULT_GROUP&serviceName='$service_name'&ip='$server_ip'&port='$service_port'&clusterName=DEFAULT&enabled=true&username='$username'&password='$password''
echo ""
echo set $service_name dubbo service offline 
curl -X PUT 'http://192.168.0.xx:8848/nacos/v2/ns/instance?namespaceId=prod&groupName=DUBBO_GROUP&serviceName='$service_name'&ip='$server_ip'&port='$dubbo_port'&clusterName=DEFAULT&enabled=true&username='$username'&password='$password''  
echo ""