微服务专享版引擎版本从1.x升级到2.x时有哪些注意事项？

更新时间：2023-10-30 GMT+08:00

查看PDF

微服务引擎专享版从1.x升级到2.x的过程中及升级完以后可能会出现的现象及解决方法如下：

现象1：在微服务引擎专享版从1.x版本升级至2.x版本的过程中，使用接口获取配置或更新配置失败，报connection refused或Connection was closed，出现错误信息示例如下：
```
[ERROR] Config update from xxx.xxx.xxx.xx failed. Error message is [Connection refused: xxx.xxx.xxx.xx]. org.apache.servicecomb.config.client.ConfigCenterClient$ConfigRefresh.lambda$null$13(ConfigCenterClient.java:428)
```
或
```
[ERROR]Config update from xxx.xxx.xxx.xx failed. Error message is [Connection was closed]. org.apache.servicecomb.config.client.ConfigCenterClient$ConfigRefresh.lambda$null$13(ConfigCenterClient.java:428)
```
解决方法：微服务引擎专享版1.x版本升级至2.x版本时配置中心会有短暂的重启，重启期间获取配置或更新配置会报错断连。因此引擎升级过程中避免更新配置，升级完成后该问题即可解决。
现象2：使用引擎版本为1.x配置中心接入的用户，无法使用“业务场景治理”功能。
解决办法：由于引擎版本为2.x的配置中心换成了kie，需要将配置中心接入方式切换为kie，具体切换方式详见Spring Cloud使用配置中心中相关内容。

现象3：在使用版本为2.x的微服务引擎时，使用导入配置文件功能，存在原配置中心格式的文件无法导入，提示文件为空或者格式错误。

解决办法：将配置文件的配置项格式修改为2.x引擎要求的配置文件格式，新的配置文件为json文件，内容格式如下：

{
    "data":[
        {
            "key":"xxx",
            "labels":{
                "environment":"xxx",
		"service": "xxx",
		"app": "xxx",
		"version": "xxx"
            },
            "value":"xxx",
            "value_type":"text",
            "status":"enabled"
        },
		{
            "key":"xxx",
            "labels":{
                "environment":"xxx"
            },
            "value":"xxx",
            "value_type":"text",
            "status":"enabled"
        },
		{
            "key":"xxx",
            "labels":{
                "environment":"xxx",
		"service": "xxx"
            },
            "value":"xxx",
            "value_type":"text",
            "status":"enabled"
        },
		{
            "key":"xxx",
            "labels":{
                "environment":"xxx",
		"service": "xxx",
		"app": "xxx"
            },
            "value":"xxx",
            "value_type":"text",
            "status":"enabled"
        }
    ]
}

其中：

key和value是配置项对应的键和值，其为必填。
labels是配置范围，其为必填，通过填写environment，service，app，version等字段来确定配置范围。
value_type是配置项类型，其为必填，可以选择ini、json、text、yaml、properties、xml，默认为text。
status是配置是否启用，其为选填，可以选择enabled（开启），disabled（关闭），默认关闭。

现象4：若在微服务引擎1.x版本的配置中心设置了全局配置，当升级到2.x之后，全局配置根据配置中心升级后的范围会相应的自动调整作用范围environment=${environmentName}，environmentName取值可以为空、development、testing、acceptance或production。此时如果SDK调整以kie作为配置中心时，需要在项目配置文件中增加自定义标签以获取该部分配置，以下以environment=production为例展示：
spring-cloud-huawei框架：
```
spring:
  cloud:
    servicecomb:
      config:
        serverType: kie
        kie:
          customLabel: environment
          customLabelValue: production
```
servicecomb-java-chassis框架：
```
servicecomb:
  kie:
    customLabel: environment
    customLabelValue: production
```

父主题： 基础设施

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

微服务专享版引擎版本从1.x升级到2.x时有哪些注意事项？

意见反馈

文档内容是否对您有帮助？

文档反馈