首页 > 其他分享 >Nacos 2.0 升级文档

Nacos 2.0 升级文档

时间：2024-06-13 14:58:10浏览次数：29  
标签：请求 Nacos nacos 升级 v1 文档 版本 字符串 2.0

Nacos 2.0.0 部署及升级文档

本文档包含两个部分：Nacos2.0.0的部署，以及如何从Nacos1.x平滑升级至Nacos2.0.0。

部署部分，适用于直接部署Nacos2.0.0以上版本的用户。

升级部分，适用于从Nacos1.X版本平滑升级到Nacos2.0.0版本（以及2.0.0-BETA版本）的用户。Nacos2.0.0-ALPHA版本无法进行平滑升级，请勿参照本文档进行升级。

由于Nacos1.X和Nacos2.0的数据结构发生了变化，为了能够完成平滑升降级，需要将数据进行双写，分别生成Nacos1和Nacos2的数据结构进行存储。因此会对性能有一定影响。当集群升级并稳定运行后，可以关闭双写，关闭双写后将会失去平滑降级的功能。

在Nacos2.1.0版本后，默认关闭了双写能力，因此无法支持从Nacos1.X版本平滑升级到2.1.0的能力，若需要使用平滑升级能力，从Nacos1.X直接升级到Nacos2.1.0版本，需要在application.properties文件中设置配置nacos.core.support.upgrade.from.1x=true.

部署步骤

本部分，适用于直接部署Nacos2.0.0以上版本的用户。

1.预备环境准备

Nacos 依赖 Java 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 Maven环境，请确保是在以下版本环境中安装使用:

  1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。
  2. 64 bit JDK 1.8+；下载 & 配置。
  3. Maven 3.2.x+；下载 & 配置。

2.下载源码或者安装包

你可以通过源码和发行包两种方式来获取 Nacos。

从 Github 上下载源码方式

Terminal window git clone https://github.com/alibaba/nacos.git cd nacos/ mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U ls -al distribution/target/   // change the $version to your actual path cd distribution/target/nacos-server-$version/nacos/bin  

下载编译后压缩包方式

您可以从 最新稳定版本 下载 nacos-server-$version.zip 包。

Terminal window unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz cd nacos/bin  

3.启动服务器

Linux/Unix/Mac

单机启动命令(standalone代表着单机模式运行):

sh startup.sh -m standalone

如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行：

bash startup.sh -m standalone

单机启动，使用内置数据库（注：使用内置Derby数据库需要保证~/nacos/data/derby-data文件夹下无残留数据）：

bash startup.sh -p embedded

集群启动（使用内嵌数据库）：

bash startup.sh -p embedded

集群启动（使用外置数据库）：

bash startup.sh

4.启动后自检

集群中所有机器部署为2.0.X版本并启动时，应当进行启动之后的检查。

当集群中所有节点logs/naming-server.log日志中观察到upgrade check result true及Upgrade to 2.0.X，便判定为集群准备完毕时，此时才可以使用Nacos2.0。

5.关闭双写

为了节省性能开销，当集群部署完成后，可以先观察一段时间运行情况，当确认无误后，可以关闭双写，从而释放性能，具体的关闭方式是通过API进行：

curl -X PUT 'localhost:8848/nacos/v1/ns/operator/switches?entry=doubleWriteEnabled&value=false'

关闭后可以从logs/naming-server.log日志中观察到Disable Double write, stop and clean v1.x cache and features字样。说明关闭双写。

注意，关闭双写后无法在进行平滑降级，请先确认关闭前集群正确运行。

6.关闭服务器

Linux/Unix/Mac

sh shutdown.sh

Windows

cmd shutdown.cmd

或者双击shutdown.cmd运行文件。

升级步骤

以linux系统为例。window系统请自行替换sh脚本为cmd脚本。

1. 停止旧节点

选择集群中一台Nacos1.X节点，使用Nacos目录下nacos/bin/shutdown.sh进行停止。

2. 替换文件

下载并解压缩nacos-server-2.0.2.tar.gz，将其下的bin，conf，target目录覆盖原Nacos1.X的安装目录下。

3. 修改配置

自行修改nacos/bin/startup.sh中的JVM参数，conf/cluster.conf中的集群列表以及conf/application.prpperties中数据库或其他相关参数。

4. 启动Nacos2.0

使用nacos目录下nacos/bin/startup.sh启动nacos2.0，其他更多启动指令请查看Nacos部署环境 。

5. 观察是否启动成功

首先查看nacos目录下 logs/start.out或logs/nacos.log 观察到nacos启动成功的日志，如 Nacos started successfully in cluster mode. use xxx storage 说明程序已启动成功。

之后在观察 logs/naming-server.log 中，可以看到有upgrade check result false 以及 Check whether close double write等日志信息。

属于正常现象。

6. 升级其他节点

待该节点的服务及实例信息已经同步完毕后（可从控制台进行确认）。重复1～5步骤，将其他的nacos节点也进行升级。

7. 确认升级完成

当集群中最后一个节点也升级到2.0.X版本时，集群会开始进行升级检测。每个节点会对该节点的服务信息和实例信息进行校验，并检测是否还有未完成的双写任务。

当该节点的服务信息和实例信息已经核对成功，并且没有双写任务存在时，该节点会判定自己已经做好升级准备，并修改自己的状态且通知其他Nacos节点。每台节点是否完成升级准备可以从控制台的集群管理中元数据信息中看到"readyToUpgrade": false/true。

当集群中所有节点均判定为准备完毕时。Nacos集群中的节点会进行升级切换，自动升级到Nacos2.0的处理逻辑。

可以从logs/naming-server.log日志中观察到upgrade check result true及Upgrade to 2.0.X。

 

8.1 关闭双写

当集群升级完成后，可以先观察一段时间运行情况，当确认无误后，可以关闭双写，从而释放性能，具体的关闭方式是通过API进行：

curl -X PUT 'localhost:8848/nacos/v1/ns/operator/switches?entry=doubleWriteEnabled&value=false'

关闭后可以从logs/naming-server.log日志中观察到Disable Double write, stop and clean v1.x cache and features字样。说明关闭双写。

注意，关闭双写后无法在进行平滑降级，请先确认关闭前集群正确运行。

8.2 降级

集群升级完毕后，依旧会进行双写，当升级后发现Nacos2.0存在问题时，可以快速进行降级，降级流程为重复步骤1～6，只是将版本改为对应的1.X版本。

当第一台降级完成后，集群即可观察到logs/naming-server.log 中的upgrade check result false ，且控制台集群管理中，所有新版本"readyToUpgrade": false。

升级相关的openAPI

在2.0.2版本中，nacos-server提供了一些方便查看升级状态及不同版本中的数据区别，方便用户排查升级中的问题。

查看统计

描述

查看当前升级状态

请求类型

GET

请求URL

/nacos/v1/ns/upgrade/ops/metrics

请求参数

无

返回参数

参数类型描述
string 升级状态

示例

upgraded = true isAll20XVersion = true isDoubleWriteEnabled = false doubleWriteDelayTaskCount = 0 serviceCountV1 = 0 instanceCountV1 = 0 serviceCountV2 = 0 instanceCountV2 = 0 subscribeCountV2 = 0 responsibleServiceCountV1 = 0 responsibleInstanceCountV1 = 0 ephemeralServiceCountV2 = 0 persistentServiceCountV2 = 0 ephemeralInstanceCountV2 = 0 persistentInstanceCountV2 = 0 service.V1.not.in.V2 = service.V2.not.in.V1 =  

查询服务

描述

查询对应Nacos版本中一个服务内容

请求类型

GET

请求路径

/nacos/v1/ns/upgrade/ops/service  

请求参数

名称类型是否必选描述
serviceName 字符串 是 服务名
groupName 字符串 否 分组名
namespaceId 字符串 否 命名空间ID
ver 字符串 否 版本 v1 或者 v2, 默认v2

示例请求

curl -X GET '127.0.0.1:8848/nacos/v1/ns/upgrade/ops/service?serviceName=nacos.test.2'  

示例返回

{ metadata: { }, groupName: "DEFAULT_GROUP", namespaceId: "public", name: "nacos.test.2", selector: { type: "none" }, protectThreshold: 0, clusters: [ { healthChecker: { type: "TCP" }, metadata: { }, name: "c1" } ] }  

查询服务列表

描述

查询对应Nacos版本的服务列表

请求类型

GET

请求路径

/nacos/v1/ns/upgrade/ops/service/list  

请求参数

名称类型是否必选描述
pageNo int 是 当前页码
pageSize int 是 分页大小
groupName 字符串 否 分组名
namespaceId 字符串 否 命名空间ID
ver 字符串 否 版本 v1 或者 v2, 默认v2

示例请求

curl -X GET '127.0.0.1:8848/nacos/v1/ns/upgrade/ops/service/list?pageNo=1&pageSize=2'  

示例返回

{ "count":148, "doms": [ "nacos.test.1", "nacos.test.2" ] }  

查询实例列表

描述

查询对应Nacos版本中某个服务下的实例列表

请求类型

GET

请求路径

/nacos/v1/ns/upgrade/ops/instance/list  

请求参数

名称类型是否必选描述
serviceName 字符串 是 服务名
groupName 字符串 否 分组名
namespaceId 字符串 否 命名空间ID
clusters 字符串，多个集群用逗号分隔 否 集群名称
healthyOnly boolean 否，默认为false 是否只返回健康实例
ver 字符串 否 版本 v1 或者 v2, 默认v2

示例请求

curl -X GET '127.0.0.1:8848/nacos/v1/ns/upgrade/ops/instance/list?serviceName=nacos.test.1'  

示例返回

{ "dom": "nacos.test.1", "cacheMillis": 1000, "useSpecifiedURL": false, "hosts": [{ "valid": true, "marked": false, "instanceId": "10.10.10.10-8888-DEFAULT-nacos.test.1", "port": 8888, "ip": "10.10.10.10", "weight": 1.0, "metadata": {} }], "checksum": "3bbcf6dd1175203a8afdade0e77a27cd1528787794594", "lastRefTime": 1528787794594, "env": "", "clusters": "" }  

查询实例详情

描述

查询一个对应Nacos版本中某个服务下个某个实例详情。

请求类型

GET

请求路径

/nacos/v1/ns/upgrade/ops/instance  

请求参数

名称类型是否必选描述
serviceName 字符串 是 服务名
groupName 字符串 否 分组名
ip 字符串 是 实例IP
port 字符串 是 实例端口
namespaceId 字符串 否 命名空间ID
cluster 字符串 否 集群名称
healthyOnly boolean 否，默认为false 是否只返回健康实例
ephemeral boolean 否 是否临时实例
ver 字符串 否 版本 v1 或者 v2, 默认v2

示例请求

curl -X GET '127.0.0.1:8848/nacos/v1/ns/upgrade/ops/instance?serviceName=nacos.test.2&ip=10.10.10.10&port=8888&cluster=DEFAULT'  

示例返回

{ "metadata": {}, "instanceId": "10.10.10.10-8888-DEFAULT-nacos.test.2", "port": 8888, "service": "nacos.test.2", "healthy": false, "ip": "10.10.10.10", "clusterName": "DEFAULT", "weight": 1.0 }  

添加服务

描述

补充添加一个服务到对应Nacos版本下

请求类型

POST

请求路径

/nacos/v1/ns/upgrade/ops/service  

请求参数

名称类型是否必选描述
serviceName 字符串 是 服务名
groupName 字符串 否 分组名
namespaceId 字符串 否 命名空间ID
protectThreshold 浮点数 否 保护阈值,取值0到1,默认0
metadata 字符串 否 元数据
selector JSON格式字符串 否 访问策略
ver 字符串 否 版本 v1 或者 v2, 默认v2

示例请求

curl -X POST '127.0.0.1:8848/nacos/v1/ns/service?serviceName=nacos.test.2&metadata=k1%3dv1'  

示例返回

ok  

删除服务

描述

从对应Nacos版本中删除一个服务,如果删除v2服务，只有当服务下实例数为0时允许删除。

请求类型

DELETE

请求路径

/nacos/v1/ns/upgrade/ops/service  

请求参数

名称类型是否必选描述
serviceName 字符串 是 服务名
groupName 字符串 否 分组名
namespaceId 字符串 否 命名空间ID
ver 字符串 否 版本 v1 或者 v2, 默认v2

示例请求

curl -X DELETE '127.0.0.1:8848/nacos/v1/ns/service?serviceName=nacos.test.2'  

示例返回

ok  

注册实例

描述

注册一个实例到对应Nacos版本的服务下。

请求类型

POST

请求路径

/nacos/v1/ns/upgrade/ops/instance  

请求参数

名称类型是否必选描述
ip 字符串 是 服务实例IP
port int 是 服务实例port
namespaceId 字符串 否 命名空间ID
weight double 否 权重
enabled boolean 否 是否上线
healthy boolean 否 是否健康
metadata 字符串 否 扩展信息
clusterName 字符串 否 集群名
serviceName 字符串 是 服务名
groupName 字符串 否 分组名
ephemeral boolean 否 是否临时实例
ver 字符串 否 版本 v1 或者 v2, 默认v2

示例请求

curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?port=8848&healthy=true&ip=11.11.11.11&weight=1.0&serviceName=nacos.test.3&encoding=GBK&namespaceId=n1'  

示例返回

ok

注销实例

描述

删除对应Nacos版本服务下的一个实例。

请求类型

DELETE

请求路径

/nacos/v1/ns/upgrade/ops/instance  

请求参数

名称类型是否必选描述
serviceName 字符串 是 服务名
groupName 字符串 否 分组名
ip 字符串 是 服务实例IP
port int 是 服务实例port
clusterName 字符串 否 集群名称
namespaceId 字符串 否 命名空间ID
ephemeral boolean 否 是否临时实例
ver 字符串 否 版本 v1 或者 v2, 默认v2

示例请求

curl -X DELETE '127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.test.1&ip=1.1.1.1&port=8888&clusterName=TEST1'  

示例返回

ok

升级过程中可能遇到的问题

1. 最后一台节点升级完成时，注册的服务出现波动（变成不健康或暂时被摘除）

升级过程中，为了节约性能，双写的内容仅是内容发生变更时的状态，心跳等内容不会被双写，因此切换版本时，可能有部分实例的心跳过久而健康检查又刚好开始执行，从而被标记非健康或摘除。

后续心跳处理将会把数据补充回来，最终会一致。

2. 升级完成后，升级的最后一台服务端报错Server is DOWN

这可能是因为Raft选主失败导致的，解决方法是重启最后一台升级的服务端。或先将最后一台服务端降级，之后再重新进行一次升级即可

标签：请求,Nacos,nacos,升级,v1,文档,版本,字符串,2.0
From： https://www.cnblogs.com/cheyunhua/p/18245847

相关文章

  • OpenEuler22.03安装openGauss5.0.2LTS版本
    OpenEuler22.03安装openGauss5.0.2LTS版本文章目录OpenEuler22.03安装openGauss5.0.2LTS版本一、安装规划二、安装准备2.1修改主机名2.2安装依赖2.3同步时间2.4关闭防火墙2.5关闭selinux2.6关闭透明大页2.7重启机器2.8设置网卡MTU2.9设置字符......
  • Python文档处理操作（1）——统计分析文档内容
    -----案例1：要求-----读取文件data1.txt的内容，统计其中所有不同字符的数量，并输出结果。-----案例1：代码示例-----f=open('data1.txt')#打开名为'data1.txt'的文件，并将文件对象赋值给变量fls=[]#初始化一个空列表ls，用于存储文件中出现的不同字......
  • 软件开发文档汇总（开发&实施&运维&安全&交付）
       前言：在软件项目管理中，每个阶段都有其特定的目标和活动，确保项目的顺利进行和最终的成功交付。以下是软件项目管理各个阶段的详细资料：软件项目管理部分文档清单： 工作安排任务书，可行性分析报告，立项申请审批表，产品需求规格说明书，需求调研计划，用户需求调查单，用户需求说明......
  • CP AUTOSAR标准中文文档链接索引（更新中）
    AUTOSAR标准的核心组件包括通信、诊断、安全等，这些组件通过模块化结构进行组织。系统被划分为多个模块，每个模块负责特定的功能。模块之间通过接口进行通信，接口定义了模块之间的交互规则。AUTOSAR标准支持模块的配置，可以根据不同的需求进行定制和优化。应用程序接口通信驱......
  • 记录一下这两天在处理文档时遇到的小问题。
    第一个任务是读取两个文件，一个存放了很多正则表达式，另一个是要修改的excel文件。读取已有的正则，然后挨个到excel里匹配并替换。第一个问题报了re.error:badcharacterrange-\dat搜了，说是：re分割字符串时，所用的分隔符集合必须按其ASCII值的大小，从小到大排列记一下……本人......
  • 【文档智能 & RAG】RAG增强之路：增强PDF解析并结构化技术路线方案及思路
    前言现阶段，尽管大模型在生成式问答上取得了很大的成功，但由于大部分的数据都是私有数据，大模型的训练及微调成本非常高，RAG的方式逐渐成为落地应用的一种重要的选择方式。然而，如何准确的对文档进行划分chunks，成为一种挑战，在现实中，大部分的专业文档都是以PDF格式存储，低精度的......
  • zabbix(ubuntu22.04)
    zabbix是一款监控软件，可监控各种网络参数，同时支持灵活的告警机制。常用术语主机(Host)：需要监控的网络设备，可用IP或域名表示主机群组(Hostgroup)：为了方面批量管理大量Host，我们会通过主机群组的方式设置一些通用的权限设置监控项(Item)：一个特定监控指标的相关数据，这些数据来......
  • 加密好的WPSword文档，忘记密码怎么办？
    在日常办公和学习中，我们经常使用WPSWord等文档处理软件来创建和编辑重要文件。为了保护这些文件不被未经授权的人访问，我们通常会选择给文档设置密码。然而，有时我们可能会因为时间久远或其他原因而忘记自己设置的密码，这时该如何是好呢？下面，我将为大家详细介绍几种应对加密WPSWo......
  • 在ubuntu22.04下安装cursor
    在ubuntu22.04下安装cursor安装Cursor编程软件1.访问Cursor网站下载Linux版本的AppImage文件2.如果出现“dlopen():errorloadinglibfuse.so.2”错误，需要安装fuse。3.将Cursor添加到应用程序列表4.保存.desktop文件，Cursor就会出现在应用程序列表中。5.如果出现点击curs......
  • 最新AI系统+ChatGPT网站H5源码+AI绘画系统，DALL-E3文生图，详细图文搭建教程/文档分析/识
    目录一、文章前言系统文档 二、系统演示三、系统功能模块3.1AI全模型支持/插件系统AI模型提问文档分析​识图理解能力3.2GPts应用3.2.1GPTs应用3.2.2GPTs工作台3.2.3自定义创建预设应用3.3AI专业绘画3.3.1文生图/图生图（垫图）3.3.2 局部编辑重绘3.3.3 ......

赞助商

阅读排行

网站主页关于我们联系我们网站地图

本网站内容转载自其他媒体，侵权联系[admin##ips99.com]。

Copyright © 2020-2023 IPS99 版权所有 IPS99