Skip to content

Commit

Permalink
Merge pull request #1613 from JimmyShi22/release-2
Browse files Browse the repository at this point in the history
Release 3.2.0
  • Loading branch information
JimmyShi22 committed Jan 21, 2023
2 parents 7f7e8cf + 77a5e59 commit 29885ee
Show file tree
Hide file tree
Showing 31 changed files with 1,283 additions and 81 deletions.
30 changes: 29 additions & 1 deletion 2.x/docs/compatibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -234,7 +234,35 @@ FISCO-BCOS 3.0.0 及之后的版本之间相互兼容。FISCO-BCOS 3.0.0-rc的
| spring-boot-crud | Maven SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0-rc4#spring-boot-crud) | [github](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | |
| generator | 企业区块链部署工具 | 不支持 | | | | |
| WeBASE | 区块链中间件平台 | v3.0.0 | [文档](https://webasedoc.readthedocs.io/zh_CN/lab/) | [github](https://github.com/WeBankBlockchain/WeBASE/tree/master-3.0) | [gitee](https://gitee.com/WeBank/WeBASE/tree/master-3.0) | |
| WeCross | 跨链协作平台 | v1.3.0(开发中) | | | | |
| WeCross | 跨链协作平台 | v1.3.0(测试中) | | | | |
| WeIdentity | 分布式身份解决方案 | v1.8.5-rc1 | [文档](https://weidentity.readthedocs.io/zh_CN/latest/) | [github](https://github.com/WeBankBlockchain/WeIdentity) | [gitee](https://gitee.com/WeBank/WeIdentity) | |
| WeBankBlockchain-Data-Export | 数据导出组件 | V3 | [文档](https://data-doc.readthedocs.io/zh_CN/data_export_3.0/docs/WeBankBlockchain-Data-Export/index.html) | [github](https://github.com/WeBankBlockchain/Data-Export/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Data-Export/tree/V3/) | |
| WeBankBlockchain-Data-Stash | 数据仓库组件 | 不支持 | | | | |
| WeBankBlockchain-Data-Reconcile | 数据对账组件 | v1.0.0 | [文档](https://data-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Data-Reconcile/index.html) | [github](https://github.com/WeBankBlockchain/Data-Reconcile) | [gitee](https://gitee.com/WeBankBlockchain/Data-Reconcile) | |
| WeBankBlockchain-SmartDev-Scaffold | 应用开发脚手架 | V3 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Scaffold/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3/) | |
| WeBankBlockchain-SmartDev-SCGP | 智能合约编译插件 | v1.0.1 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-SCGP/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-SCGP) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-SCGP) | |
| WeBankBlockchain-SmartDev-Contract | 智能合约库 | v1.0.0 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Contract/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Contract) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Contract) | |
| WeBankBlockchain-Governance-Cert | 证书管理组件 | v1.0.1 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Cert/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Cert) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Cert) | |
| WeBankBlockchain-Governance-Key | 私钥管理组件 | v1.0.2 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Key/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Key) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Key) | |
| WeBankBlockchain-Governance-Authority | 权限治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Acct/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Account/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Account/tree/V3/) | |
| WeBankBlockchain-Governance-Account | 账户治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Auth/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Authority/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Authority/tree/V3/) | |

#### 3.2.6. FISCO-BCOS v3.2.x

| 项目 | 功能简介 | 版本 | 文档 | github | gitee | 备注 |
| ------------------------------------- | -------------------------- | ------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------------------------- |
| FISCO-BCOS | 区块链底层平台 | v3.2.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/) | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.2.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.2.0) | |
| Solidity | solidity智能合约 | v0.8.11 | [文档](https://docs.soliditylang.org/en/v0.8.11) | | | **最高支持solidity v0.8.11** |
| JavaSDK | Java语言SDK | v3.2.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/sdk/java_sdk/index.html) | [github](https://github.com/FISCO-BCOS/java-sdk/tree/v3.2.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk/tree/v3.2.0) | |
| GoSDK | Go语言SDK | 暂不支持</br>后续版本规划 | | | | |
| PythonSDK | Python语言SDK | 暂不支持</br>后续版本规划 | | | | |
| 控制台(console) | 交互式命令行工具 | v3.2.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/index.html) | [github](https://github.com/FISCO-BCOS/console/tree/v3.2.0) | [gitee](https://gitee.com/FISCO-BCOS/console/tree/v3.2.0) | |
| java-sdk-demo | Java压测工具 | v3.2.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/stress_testing.html) | [github](https://github.com/FISCO-BCOS/java-sdk-demo/tree/3.2.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk-demo/tree/3.2.0) | |
| spring-boot-starter | Gradle SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0-rc4#spring-boot-starter) | [github](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | |
| spring-boot-crud | Maven SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0-rc4#spring-boot-crud) | [github](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | |
| generator | 企业区块链部署工具 | 不支持 | | | | |
| WeBASE | 区块链中间件平台 | v3.0.0 | [文档](https://webasedoc.readthedocs.io/zh_CN/lab/) | [github](https://github.com/WeBankBlockchain/WeBASE/tree/master-3.0) | [gitee](https://gitee.com/WeBank/WeBASE/tree/master-3.0) | |
| WeCross | 跨链协作平台 | v1.3.0(测试中) | | | | |
| WeIdentity | 分布式身份解决方案 | v1.8.5-rc1 | [文档](https://weidentity.readthedocs.io/zh_CN/latest/) | [github](https://github.com/WeBankBlockchain/WeIdentity) | [gitee](https://gitee.com/WeBank/WeIdentity) | |
| WeBankBlockchain-Data-Export | 数据导出组件 | V3 | [文档](https://data-doc.readthedocs.io/zh_CN/data_export_3.0/docs/WeBankBlockchain-Data-Export/index.html) | [github](https://github.com/WeBankBlockchain/Data-Export/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Data-Export/tree/V3/) | |
| WeBankBlockchain-Data-Stash | 数据仓库组件 | 不支持 | | | | |
Expand Down
2 changes: 2 additions & 0 deletions 3.x/zh_CN/docs/change_log/3_1_0.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,8 @@
"code":0,
"msg":"success"
}
注:若开启权限治理功能,需要使用 setSysConfigProposal 命令
```

设置成功,再次查询,得到当前版本已升级为3.1.0
Expand Down
2 changes: 2 additions & 0 deletions 3.x/zh_CN/docs/change_log/3_1_1.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,8 @@
"code":0,
"msg":"success"
}
注:若开启权限治理功能,需要使用 setSysConfigProposal 命令
```

设置成功,再次查询,得到当前版本已升级为3.1.0
Expand Down
66 changes: 66 additions & 0 deletions 3.x/zh_CN/docs/change_log/3_1_2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# v3.1.2

#### 新增

* 交易结构新增extraData字段,以方便业务对交易进行标识,该字段不纳入交易hash的计算

#### 兼容性

* 历史版本升级

需要升级的链的“数据兼容版本号([compatibility_version](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/change_log/3_1_2.html#id5))”为如下版本时:

* 3.1.0:本版本的数据兼容版本号依然为3.1.0,直接替换二进制即可完成升级
* 3.0.x:支持通过替换二进制进行灰度升级,若需使用当前版本的新特性,需升级数据兼容版本号,操作见[文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/change_log/3_1_1.html#id5)
* 3.0-rc x:数据不兼容,无法升级,可考虑逐步将业务迁移至3.x正式版
* 2.x:数据不兼容,2.x版本仍持续维护,可考虑升级为2.x的最新版本

* 组件兼容性

| | 推荐版本 | 最低版本 | 说明 |
| ---------- | --------- | ------------------------ | ---------------------------------- |
| Console | 3.1.0 | 3.0.0 | |
| Java SDK | 3.1.2 | 3.0.0 | |
| CPP SDK | 3.1.0 | 3.0.0 | |
| Solidity | 0.8.11 | 最低 0.4.25,最高 0.8.11 | 需根据合约版本下载编译器(控制台) |
| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | |

#### 升级方法

该操作仅支持将3.x版本升级为本版本,不支持3.0-rc或2.x的升级。

##### 查询数据兼容版本号(compatibility_version)

[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/console_commands.html#getsystemconfigbykey)进行查询,如当前返回的版本为3.0.1

```
[group0]: /apps> getSystemConfigByKey compatibility_version
3.0.1
```

##### 替换节点二进制

需将**所有节点**的二进制逐步替换为当前版本。为了不影响业务,替换过程能够以灰度方式进行,逐个替换并重启节点。替换过程中,当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后,需用控制台修改数据兼容版本号为当前版本。

##### 设置数据兼容版本号(compatibility_version)

[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/console_commands.html#setsystemconfigbykey)设置数据兼容版本号,如当前版本为3.1.0

```
[group0]: /apps> setSystemConfigByKey compatibility_version 3.1.0
{
"code":0,
"msg":"success"
}
注:若开启权限治理功能,需要使用 setSysConfigProposal 命令
```

设置成功,再次查询,得到当前版本已升级为3.1.0

```
[group0]: /apps> getSystemConfigByKey compatibility_version
3.1.0
```

当前链已经完成升级,至此,**链开始以新的逻辑继续运行**,并支持了新的特性。
84 changes: 84 additions & 0 deletions 3.x/zh_CN/docs/change_log/3_2_0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# v3.2.0

#### 新增

* CRUD 新增更多接口
* 网关内白名单
* 适配硬件加密机
* 适配麒麟操作系统
* 新增EVM的analysis缓存,降低大合约的执行开销
* 出块时间可配置上限
* 数据归档工具
* tikv 读写工具
* max支持手动部署

#### 更改

* 配置文件中重要字段去除默认值,必须在配置文件中进行配置
* INFO 日志优化日志大小

#### 修复

* 超过3级跳转的消息路由问题
* rpc sendTransaction接口的交易哈希校验问题

#### 兼容性

* 历史版本升级

需要升级的链的“数据兼容版本号([compatibility_version](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/change_log/3_1_2.html#id5))”为如下版本时:

* 3.2.0:数据完全兼容当前版本,直接替换二进制即可完成升级
* 3.1.x/3.0.x:支持通过替换二进制进行灰度升级,若需使用当前版本的新特性,需升级数据兼容版本号,操作见[文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/change_log/3_2_0.html#id5)
* 3.0-rc x:数据不兼容,无法升级,可考虑逐步将业务迁移至3.x正式版
* 2.x:数据不兼容,2.x版本仍持续维护,可考虑升级为2.x的最新版本

* 组件兼容性

| | 推荐版本 | 最低版本 | 说明 |
| ---------- | --------- | ------------------------ | ---------------------------------- |
| Console | 3.2.0 | 3.0.0 | |
| Java SDK | 3.2.0 | 3.0.0 | |
| CPP SDK | 3.2.0 | 3.0.0 | |
| Solidity | 0.8.11 | 最低 0.4.25,最高 0.8.11 | 需根据合约版本下载编译器(控制台) |
| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | |

#### 升级方法

该操作仅支持将3.x版本升级为本版本,不支持3.0-rc或2.x的升级。

##### 查询数据兼容版本号(compatibility_version)

[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/console_commands.html#getsystemconfigbykey)进行查询,如当前返回的版本为3.0.1

```
[group0]: /apps> getSystemConfigByKey compatibility_version
3.0.1
```

##### 替换节点二进制

需将**所有节点**的二进制逐步替换为当前版本。为了不影响业务,替换过程能够以灰度方式进行,逐个替换并重启节点。替换过程中,当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后,需用控制台修改数据兼容版本号为当前版本。

##### 设置数据兼容版本号(compatibility_version)

[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/console_commands.html#setsystemconfigbykey)设置数据兼容版本号,如当前版本为3.1.0。

```
[group0]: /apps> setSystemConfigByKey compatibility_version 3.1.0
{
"code":0,
"msg":"success"
}
注:若开启权限治理功能,需要使用 setSysConfigProposal 命令
```

设置成功,再次查询,得到当前版本已升级为3.1.0

```
[group0]: /apps> getSystemConfigByKey compatibility_version
3.1.0
```

当前链已经完成升级,至此,**链开始以新的逻辑继续运行**,并支持了新的特性。
23 changes: 23 additions & 0 deletions 3.x/zh_CN/docs/change_log/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,33 @@
相关软件和环境版本说明!`请查看 <https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html>`_


v3.2.x
------------------

.. admonition:: FISCO BCOS 3.x Releases

- `FISCO BCOS v3.2.0 <./3_2_0.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.2.0>`_]


.. admonition:: 查看节点和数据版本

- 查看Air版本FISCO BCOS节点二进制版本:``./fisco-bcos --version``
- 查看Pro版本FISCO BCOS节点二进制版本:``./BcosNodeService --version``, ``./BcosRpcService --version``, ``./BcosGatewayService --version``
- 查看Max版本FISCO BCOS节点二进制版本:``./BcosMaxNodeService --version``, ``./BcosRpcService --version``, ``./BcosGatewayService --version``, ``./BcosExecutorService --version``
- 查看轻节点二进制版本:``../fisco-bcos-lightnode --version``

.. toctree::
:hidden:
:maxdepth: 0

3_2_0.md

v3.1.x
------------------

.. admonition:: FISCO BCOS 3.x Releases

- `FISCO BCOS v3.1.2 <./3_1_2.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.1.2>`_]
- `FISCO BCOS v3.1.1 <./3_1_1.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.1.1>`_]
- `FISCO BCOS v3.1.0 <./3_1_0.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.1.0>`_]

Expand All @@ -30,6 +52,7 @@ v3.1.x
:hidden:
:maxdepth: 0

3_1_2.md
3_1_1.md
3_1_0.md

Expand Down

0 comments on commit 29885ee

Please sign in to comment.