Develop astro nacos 2.5 (#853)

* Update upgrading document for 2.5 * Enhance addressing document. * Update download for 2.5.0-beta.
nacos-group · Dec 19, 2024 · a8c1aaf · a8c1aaf
1 parent ce714bc
commit a8c1aaf
Show file tree

Hide file tree

Showing 6 changed files with 65 additions and 10 deletions.
diff --git a/src/content/docs/next/en/manual/admin/upgrading.mdx b/src/content/docs/next/en/manual/admin/upgrading.mdx
@@ -19,10 +19,18 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
 | 0.X ～ 1.1.X | 不支持 | 0.X ~ 1.1.X 版本需要先升级到1.2以上的，然后参考[Nacos2.0升级文档](https://nacos.io/docs/v2/upgrading/200-upgrading/) 先升级到2.0或2.1版本后再进行升级 |
 | 1.2.X ~ 1.4.X | 不支持 | 2.4.X版本不支持从 1.2.X ~ 1.4.X 之间的版本直接升级，请参考[Nacos2.0升级文档](https://nacos.io/docs/v2/upgrading/200-upgrading/) 先升级到2.0或2.1版本后再进行升级 |
 | 2.0.X | 支持 | 2.4.X版本支持从 2.0.X 升级到 2.4.X， 但数据库表结构有发生变化，请升级前对比[mysql-schema.sql](https://github.com/alibaba/nacos/blob/master/distribution/conf/mysql-schema.sql)文件，并应用新的表结构后进行升级 |
-| 2.1.X ~ 2.3.X | 支持 | 2.4.X版本支持从 2.1.X ~ 2.3.X 升级到 2.4.X |
+| 2.1.X ~ 2.4.X | 支持 | 2.5.X版本支持从 2.1.X ~ 2.4.X 升级到 2.5.X，但数据库表结构有发生变化，请升级前对比[mysql-schema.sql](https://github.com/alibaba/nacos/blob/master/distribution/conf/mysql-schema.sql)文件，并应用新的表结构后进行升级 |
 
 ## 2. 升级步骤
 
+:::note
+2.5.X 版本中对配置的灰度功能进行了一定程度的重构和优化，支持配置灰度的历史变化记录；这会导致表结构出现一定变化，同时在首次启动时会对存量数据进行升级，如果升级的集群正在使用老版本的`BETA发布`功能，可能会导致新版本节点首次启动时启动较慢。
+
+若需要加速数据升级的过程，可以在配置文件`application.properties`中增加数据升级到线程池比例参数`nacos.gray.migrate.executor.multi`，默认值为4，即启动`CPU核心数 * 4`个线程进行数据升级操作。
+
+若您确认没有使用`BETA发布`功能，可以忽略此步骤。
+:::
+
 ### 2.1. 发行版升级
 
 #### 2.1.1 确认表结构
@@ -32,7 +40,14 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
 若文件中表结构存在变化，请先进行数据库变更，例如：
 
 ```SQL
-ALTER TABLE `config_info` ADD COLUMN `encrypted_data_key` varchar(255) NOT NULL COMMENT '密钥',
+-- 从 2.0.X 升级时需要执行下列所有SQL, 从2.1.X之后版本升级仅需执行最后两行。
+ALTER TABLE `config_info` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `config_info_gray` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `config_info_beta` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `his_config_info` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `his_config_info` ADD COLUMN `publish_type` varchar(50)  DEFAULT 'formal' COMMENT 'publish type gray or formal';
+ALTER TABLE `his_config_info` ADD COLUMN `gray_name` varchar(50)  DEFAULT NULL COMMENT 'gray name';
+ALTER TABLE `his_config_info` ADD COLUMN `ext_info`  longtext DEFAULT NULL COMMENT 'ext info';
 ```
 
 #### 2.1.2. 下载新版本
@@ -102,7 +117,14 @@ ${nacos.home}/bin/startup.cmd
 若文件中表结构存在变化，请先进行数据库变更，例如：
 
 ```SQL
-ALTER TABLE `config_info` ADD COLUMN `encrypted_data_key` varchar(255) NOT NULL COMMENT '密钥',
+-- 从 2.0.X 升级时需要执行下列所有SQL, 从2.1.X之后版本升级仅需执行最后三行。
+ALTER TABLE `config_info` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `config_info_gray` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `config_info_beta` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `his_config_info` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `his_config_info` ADD COLUMN `publish_type` varchar(50)  DEFAULT 'formal' COMMENT 'publish type gray or formal';
+ALTER TABLE `his_config_info` ADD COLUMN `gray_name` varchar(50)  DEFAULT NULL COMMENT 'gray name';
+ALTER TABLE `his_config_info` ADD COLUMN `ext_info`  longtext DEFAULT NULL COMMENT 'ext info';
 ```
 
 #### 2.2.2. 确认环境变量

diff --git a/src/content/docs/next/en/manual/user/addressing.mdx b/src/content/docs/next/en/manual/user/addressing.mdx
@@ -202,7 +202,7 @@ ServerListProvider的相应接口如果：
 |getServerName|无|String|获取`ServerListProvider`所对应的服务端名称，用于标记地址列表所对应的服务端名称|
 |getNamespace|无|String|获取`ServerListProvider`所归属的命名空间，也即此Nacos客户端所归属的命名空间|
 |getContextPath|无|String|获取`ServerListProvider`所对应的服务端上下文路径，当Nacos服务端配置了上下文路径时，需要此上下文路径，以便于Nacos客户端访问服务端|
-|getOrder|无|int|获取`ServerListProvider`的优先级，数字越大优先级越高，`EndpointServerListProvider`的优先级为`500`,`PropertiesServerListProvider`的优先级为499|
+|getOrder|无|int|获取`ServerListProvider`的优先级，数字越大优先级越高，`EndpointServerListProvider`的优先级为`500`,`PropertiesServerListProvider`的优先级为`499`|
 |match|NacosClientProperties|boolean|判断当前`ServerListProvider`是否匹配当前Nacos客户端的配置，如果匹配，则Nacos客户端会调用`init`对此`ServerListProvider`进行初始化|
 |isFixed|无|boolean|判断当前`ServerListProvider`是否所提供的地址列表是否为固定的，比如`EndpointServerListProvider`是可变的，`PropertiesServerListProvider`是固定的|
 |getAddressSource|无|String|获取`ServerListProvider`的地址列表来源地址，比如`EndpointServerListProvider`返回是`Endpoint`的地址，`PropertiesServerListProvider`是``（空字符串）|

diff --git a/src/content/docs/next/zh-cn/manual/admin/upgrading.mdx b/src/content/docs/next/zh-cn/manual/admin/upgrading.mdx
@@ -19,10 +19,18 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
 | 0.X ～ 1.1.X | 不支持 | 0.X ~ 1.1.X 版本需要先升级到1.2以上的，然后参考[Nacos2.0升级文档](https://nacos.io/docs/v2/upgrading/200-upgrading/) 先升级到2.0或2.1版本后再进行升级 |
 | 1.2.X ~ 1.4.X | 不支持 | 2.4.X版本不支持从 1.2.X ~ 1.4.X 之间的版本直接升级，请参考[Nacos2.0升级文档](https://nacos.io/docs/v2/upgrading/200-upgrading/) 先升级到2.0或2.1版本后再进行升级 |
 | 2.0.X | 支持 | 2.4.X版本支持从 2.0.X 升级到 2.4.X， 但数据库表结构有发生变化，请升级前对比[mysql-schema.sql](https://github.com/alibaba/nacos/blob/master/distribution/conf/mysql-schema.sql)文件，并应用新的表结构后进行升级 |
-| 2.1.X ~ 2.3.X | 支持 | 2.4.X版本支持从 2.1.X ~ 2.3.X 升级到 2.4.X |
+| 2.1.X ~ 2.4.X | 支持 | 2.5.X版本支持从 2.1.X ~ 2.4.X 升级到 2.5.X，但数据库表结构有发生变化，请升级前对比[mysql-schema.sql](https://github.com/alibaba/nacos/blob/master/distribution/conf/mysql-schema.sql)文件，并应用新的表结构后进行升级 |
 
 ## 2. 升级步骤
 
+:::note
+2.5.X 版本中对配置的灰度功能进行了一定程度的重构和优化，支持配置灰度的历史变化记录；这会导致表结构出现一定变化，同时在首次启动时会对存量数据进行升级，如果升级的集群正在使用老版本的`BETA发布`功能，可能会导致新版本节点首次启动时启动较慢。
+
+若需要加速数据升级的过程，可以在配置文件`application.properties`中增加数据升级到线程池比例参数`nacos.gray.migrate.executor.multi`，默认值为4，即启动`CPU核心数 * 4`个线程进行数据升级操作。
+
+若您确认没有使用`BETA发布`功能，可以忽略此步骤。
+:::
+
 ### 2.1. 发行版升级
 
 #### 2.1.1 确认表结构
@@ -32,7 +40,14 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
 若文件中表结构存在变化，请先进行数据库变更，例如：
 
 ```SQL
-ALTER TABLE `config_info` ADD COLUMN `encrypted_data_key` varchar(255) NOT NULL COMMENT '密钥',
+-- 从 2.0.X 升级时需要执行下列所有SQL, 从2.1.X之后版本升级仅需执行最后两行。
+ALTER TABLE `config_info` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `config_info_gray` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `config_info_beta` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `his_config_info` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `his_config_info` ADD COLUMN `publish_type` varchar(50)  DEFAULT 'formal' COMMENT 'publish type gray or formal';
+ALTER TABLE `his_config_info` ADD COLUMN `gray_name` varchar(50)  DEFAULT NULL COMMENT 'gray name';
+ALTER TABLE `his_config_info` ADD COLUMN `ext_info`  longtext DEFAULT NULL COMMENT 'ext info';
 ```
 
 #### 2.1.2. 下载新版本
@@ -102,7 +117,14 @@ ${nacos.home}/bin/startup.cmd
 若文件中表结构存在变化，请先进行数据库变更，例如：
 
 ```SQL
-ALTER TABLE `config_info` ADD COLUMN `encrypted_data_key` varchar(255) NOT NULL COMMENT '密钥',
+-- 从 2.0.X 升级时需要执行下列所有SQL, 从2.1.X之后版本升级仅需执行最后三行。
+ALTER TABLE `config_info` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `config_info_gray` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `config_info_beta` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `his_config_info` ADD COLUMN `encrypted_data_key` varchar(1024) NOT NULL DEFAULT '' COMMENT '密钥';
+ALTER TABLE `his_config_info` ADD COLUMN `publish_type` varchar(50)  DEFAULT 'formal' COMMENT 'publish type gray or formal';
+ALTER TABLE `his_config_info` ADD COLUMN `gray_name` varchar(50)  DEFAULT NULL COMMENT 'gray name';
+ALTER TABLE `his_config_info` ADD COLUMN `ext_info`  longtext DEFAULT NULL COMMENT 'ext info';
 ```
 
 #### 2.2.2. 确认环境变量

diff --git a/src/content/docs/next/zh-cn/manual/user/addressing.mdx b/src/content/docs/next/zh-cn/manual/user/addressing.mdx
@@ -202,7 +202,7 @@ ServerListProvider的相应接口如果：
 |getServerName|无|String|获取`ServerListProvider`所对应的服务端名称，用于标记地址列表所对应的服务端名称|
 |getNamespace|无|String|获取`ServerListProvider`所归属的命名空间，也即此Nacos客户端所归属的命名空间|
 |getContextPath|无|String|获取`ServerListProvider`所对应的服务端上下文路径，当Nacos服务端配置了上下文路径时，需要此上下文路径，以便于Nacos客户端访问服务端|
-|getOrder|无|int|获取`ServerListProvider`的优先级，数字越大优先级越高，`EndpointServerListProvider`的优先级为`500`,`PropertiesServerListProvider`的优先级为499|
+|getOrder|无|int|获取`ServerListProvider`的优先级，数字越大优先级越高，`EndpointServerListProvider`的优先级为`500`,`PropertiesServerListProvider`的优先级为`499`|
 |match|NacosClientProperties|boolean|判断当前`ServerListProvider`是否匹配当前Nacos客户端的配置，如果匹配，则Nacos客户端会调用`init`对此`ServerListProvider`进行初始化|
 |isFixed|无|boolean|判断当前`ServerListProvider`是否所提供的地址列表是否为固定的，比如`EndpointServerListProvider`是可变的，`PropertiesServerListProvider`是固定的|
 |getAddressSource|无|String|获取`ServerListProvider`的地址列表来源地址，比如`EndpointServerListProvider`返回是`Endpoint`的地址，`PropertiesServerListProvider`是``（空字符串）|

diff --git a/src/content/download/en/nacos-server.mdx b/src/content/download/en/nacos-server.mdx
@@ -7,6 +7,11 @@ order: 0
 Nacos Server **2.4.3** has been officially released. It fixes some issues from version `2.4.2`.
 
 Feel free to [download and try it out](#stable-versions).
+
+Nacos Server **2.5.0-BETA** and **3.0.0-ALPHA** has also been officially released.
+
+[download and try 2.5.0-BETA or 3.0.0-ALPHA](#snapshot-versions).
+
 :::
 ## System Requirements
 :::note
@@ -37,4 +42,5 @@ Support for Nacos 1.x has stopped, please upgrade to version 2.x as soon as poss
 Snapshot versions are still in development. We encourage you to try them out and provide feedback, but it is not recommended for production use.
 | Version | Binary Package Download                                                | Docker Image                                                 | MD5                         | Release Notes                                     | Reference Documentation                                  |
 | ---- | ---- | ---- | ---- | ---- | ---- |
-| 3.0.0-ALPHA | [3.0.0-ALPHA.zip](https://github.com/alibaba/nacos/releases/download/3.0.0-alpha/nacos-server-3.0.0-ALPHA.zip) | Snapshots do not provide images. For images, it is recommended to use the stable version: [nacos/nacos-server:latest](https://hub.docker.com/r/nacos/nacos-server/tags?page=1&name=latest) | 87a6ba53fec3b6d53a7c600a90a60f2e | [Release Notes](https://github.com/alibaba/nacos/releases/tag/3.0.0-alpha) | [Quick Start](/docs/v3.0/quickstart/quick-start) |
+| 3.5.0-BETA | [2.5.0-BETA.zip](https://github.com/alibaba/nacos/releases/download/2.5.0-BETA/nacos-server-2.5.0-BETA.zip) | Snapshots do not provide images. For images, it is recommended to use the stable version: [nacos/nacos-server:latest](https://hub.docker.com/r/nacos/nacos-server/tags?page=1&name=latest) | 094df21315e4eb35295385f1ab3ba9b5 | [Release Notes](https://github.com/alibaba/nacos/releases/tag/2.5.0-BETA) | [Quick Start](/docs/next/quickstart/quick-start/) |
+| 3.0.0-ALPHA | [3.0.0-ALPHA.zip](https://github.com/alibaba/nacos/releases/download/3.0.0-alpha/nacos-server-3.0.0-ALPHA.zip) | Snapshots do not provide images. For images, it is recommended to use the stable version: [nacos/nacos-server:latest](https://hub.docker.com/r/nacos/nacos-server/tags?page=1&name=latest) | 87a6ba53fec3b6d53a7c600a90a60f2e | [Release Notes](https://github.com/alibaba/nacos/releases/tag/3.0.0-alpha) | [Quick Start](/docs/v3.0/quickstart/quick-start/) |
diff --git a/src/content/download/zh-cn/nacos-server.mdx b/src/content/download/zh-cn/nacos-server.mdx
@@ -12,6 +12,10 @@ Nacos Server **2.4.3** 已正式发布。修复一些`2.4.2`版本中的问题
 
 欢迎[下载和试用](#稳定版本)。
 
+Nacos Server **2.5.0-BETA** 和 **3.0.0-ALPHA** 也已经发布，欢迎试用。
+
+[下载和试用2.5.0-BETA或3.0.0-ALPHA](#快照版本)。
+
 :::
 
 
@@ -57,4 +61,5 @@ Nacos 1.x 已经停止功能维护，请尽快升级到 2.x 版本。
 
 | 版本 | 二进制包下载                                                | Docker 镜像                                                 | MD5                         | 发布说明                                     | 参考文档                                  |
 | ---- | ---- | ---- | ---- | ---- | ---- |
-| 3.0.0-ALPHA | [3.0.0-ALPHA.zip](https://github.com/alibaba/nacos/releases/download/3.0.0-alpha/nacos-server-3.0.0-ALPHA.zip) | 快照版本不提供镜像，需要使用镜像推荐使用稳定版：[nacos/nacos-server:latest](https://hub.docker.com/r/nacos/nacos-server/tags?page=1&name=latest) | 87a6ba53fec3b6d53a7c600a90a60f2e | [发布说明](https://github.com/alibaba/nacos/releases/tag/3.0.0-alpha) | [快速开始](/docs/v3.0/quickstart/quick-start) |
+| 3.5.0-BETA | [2.5.0-BETA.zip](https://github.com/alibaba/nacos/releases/download/2.5.0-BETA/nacos-server-2.5.0-BETA.zip) | 快照版本不提供镜像，需要使用镜像推荐使用稳定版：[nacos/nacos-server:latest](https://hub.docker.com/r/nacos/nacos-server/tags?page=1&name=latest) | 094df21315e4eb35295385f1ab3ba9b5 | [发布说明](https://github.com/alibaba/nacos/releases/tag/2.5.0-BETA) | [快速开始](/docs/next/quickstart/quick-start/) |
+| 3.0.0-ALPHA | [3.0.0-ALPHA.zip](https://github.com/alibaba/nacos/releases/download/3.0.0-alpha/nacos-server-3.0.0-ALPHA.zip) | 快照版本不提供镜像，需要使用镜像推荐使用稳定版：[nacos/nacos-server:latest](https://hub.docker.com/r/nacos/nacos-server/tags?page=1&name=latest) | 87a6ba53fec3b6d53a7c600a90a60f2e | [发布说明](https://github.com/alibaba/nacos/releases/tag/3.0.0-alpha) | [快速开始](/docs/v3.0/quickstart/quick-start/) |