tianxiaoliang commented on a change in pull request #199:
URL: https://github.com/apache/servicecomb-docs/pull/199#discussion_r512557324
##########
File path:
java-chassis-reference/zh_CN/docs/build-provider/definition/service-definition.md
##########
@@ -12,46 +12,73 @@ servicecomb 微服务定义包括两个基础模型 `Microservice` 和 `Microser
servicecomb 的实例信息在类 `MicroserviceInstance` 中定义。 它主要包含网络地址(endpoints) 信息。
+微服务的定义会用于微服务管理、微服务的发现、治理等多种场景。专题文章[微服务实例间多环境隔离](../../general-development/multienvironment.md)介绍
+了微服务定义的一些常见应用场景。
+
# 场景描述
开发一个微服务，需要在 `microservice.yaml` 文件中配置微服务的基本信息。 如果使用 spring boot，也可以在
-`application.yml` 文件中配置微服务的基本信息。
-
-`microservice.yaml` 文件在项目中的存放路径为 `src\main\resources\microservice.yaml`。
+`application.yml` 文件中配置微服务的基本信息。 `microservice.yaml` 文件在项目中的存放路径为
`src\main\resources\microservice.yaml`。
+微服务信息和实例信息属于基础元数据信息， 只能够在配置文件指定，无法通过配置中心指定。
-表1-1配置项说明
+***表1-1 微服务信息配置项说明***
-| 配置项 | 默认值 | 取值范围 | 是否必选 | 含义 | 注意 |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| APPLICATION\_ID | - | - | 是 | 应用名 | - |
-| service\_description.name | - | - | 是 | 微服务名 |
应确保app内部唯一。微服务名支持数字、大小写字母和"-"、"\_"、"."三个特殊字符，但是不能以特殊字符作为首尾字符，命名规范为：^\[a-zA-Z0-9\]+$|^\[a-zA-Z0-9\]\[a-zA-Z0-9\_-.\]\*\[a-zA-Z0-9\]$。
|
-| service\_description.version | - | - | 是 | 微服务版本号 | - |
-| service\_description.description | - | - | 否 | 微服务描述 | |
-| service\_description.properties | - | - | 否 |
微服务元数据配置（通过microservice.yaml文件进行配置） | - |
-| service\_description.propertyExtendedClass | - | - | 否 |
微服务元数据配置（通过实现接口PropertyExtended进行配置） | 接口返回的配置会覆盖配置文件中key相同的配置。 |
-| instance\_description.properties | - | - | 否 |
服务实例元数据配置（通过microservice.yaml文件进行配置） | |
-| instance\_description.propertyExtendedClass | - | - | 否 |
微服务元数据配置（通过实现接口PropertyExtended进行配置） |
同service\_description.propertyExtendedClass |
+| 配置项 | 版本 | 默认值 | 是否必选 | 含义 |
+| :--- | :--- | :--- | :--- | :--- |
+| servicecomb.service.application | 2.1.2 | default | 是 | 应用名 |
+| servicecomb.service.name | 2.1.2 | defaultMicroservice | 是 | 微服务名,
应确保应用内部唯一。微服务名支持数字、大小写字母和"-"、"\_"、"."三个特殊字符，但是不能以特殊字符作为首尾字符，命名规范为：^\[a-zA-Z0-9\]+$|^\[a-zA-Z0-9\]\[a-zA-Z0-9\_-.\]\*\[a-zA-Z0-9\]$。
|
+| servicecomb.service.version | 2.1.2 | 1.0.0.0 | 是 | 微服务版本号 |
+| servicecomb.service.role | 2.1.2 | FRONT | 否 | 服务类型 |
+| servicecomb.service.description | 2.1.2+| - | 否 | 微服务描述 |
+| ervicecomb.service.environment | 2.1.2 | - | 否 | 运行环境，比如 development,
production 等 |
+| servicecomb.service.propertyExtendedClass | 2.1.2 | - | 否 | 微服务元数据配置扩展信息，
接口返回的配置会覆盖配置文件中key相同的配置。|
+| servicecomb.service.properties | 2.1.2 | - | 否 |
服务实例元数据配置（通过microservice.yaml文件进行配置）|
+| servicecomb.service.paths | 2.1.2 | - | 否 | URL 前缀列表 |
+| APPLICATION_ID | 2.1.2之前 | default | 是 | 应用名 |
+| service_description.name | 2.1.2之前 | defaultMicroservice | 是 | 微服务名,
应确保应用内部唯一。微服务名支持数字、大小写字母和"-"、"\_"、"."三个特殊字符，但是不能以特殊字符作为首尾字符，命名规范为：^\[a-zA-Z0-9\]+$|^\[a-zA-Z0-9\]\[a-zA-Z0-9\_-.\]\*\[a-zA-Z0-9\]$。
|
+| service_description.version | 2.1.2之前 | 1.0.0.0 | 是 | 微服务版本号 |
Review comment:
老的配置从文档里移除
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
