# 创建2.x版本ServiceComb引擎配置
ServiceComb引擎定义了一套与开发框架无关的配置机制。配置项由key、label和value组成，通过label区分配置项属于全局配置、微服务配置等作用范围，label也可以表示value的类型。
#### 约束与限制
- 配置项使用明文存储，请勿附带敏感数据。
- 当引擎规格限定的配置条目配额即将用完时，为了保证尽量可用，引擎允许超出剩余配额的新建配置项操作同时成功。请尽快扩容引擎，避免后续新建配置失败。
- 对于编辑或删除配置项，若配置项已被微服务使用，可能导致微服务读取不到配置或读取错误配置，引发业务异常。因此在操作修改或删除配置项前请备份配置。
 
#### 创建应用级配置
将新建的配置关联到某一应用，并添加应用名称和所在环境标签。
![](https://support.huaweicloud.com/usermanual-cse/public_sys-resources/note_3.0-zh-cn.png)
**配置项使用明文存储，请勿附带敏感数据。**
1. 登录[微服务引擎控制台](https://console.huaweicloud.com/cse2/)。
2. 在左侧导航栏选择"ServiceComb引擎专享版"。

3. 单击待操作的引擎名称。
4. 选择"配置管理"。 
   - 未开启安全认证的引擎，请执行[6]。
   
   - 开启安全认证的引擎，当登录控制台的用户为[导入IAM账号](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0024.html#cse_usermanual_0024__section176291011154918)中导入的用户，请执行[6]，其他用户请执行[5]。
   
   
   
   
5. 在弹出的"安全认证"对话框输入账号名及其密码，单击"确定"。
   
   ![](https://support.huaweicloud.com/usermanual-cse/public_sys-resources/note_3.0-zh-cn.png)
   - 首次连接ServiceComb引擎，请输入root账号名及[创建ServiceComb引擎](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0005.html)时输入的密码。
   
   - 创建账号请参考[新增账号](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0024.html#cse_usermanual_0024__section1417318590327)。
    
   
   
6. 单击"新建配置"，参考下表设置配置参数。参数前面带\*号的是必须设置的参数。
   
   
   | 参数名称   | 参数说明                                                                                                                                                                                                                                                       |
   |:---|:---|
   | \*配置项  | 输入配置项。 配置项为该配置的全局ID，在编码阶段通过配置项对配置进行索引及操作。建议采用类Java包命名方式（如cse.service.registry.address）的命名规则来保证配置项的可读性和唯一性。 **创建应用级配置时不允许创建以"servicecomb.matchGroup."开头的配置项，此开头的配置会与创建业务场景治理生成的配置冲突，导致业务场景无法显示。** |
   | 配置范围   | 选择"应用级配置"。                                                                                                                                                                                                                                                 |
   | \*应用   | 1. 选择或输入应用名称。  2. 选择环境。                                                                          |
   | 配置格式   | 选择配置格式，支持TEXT、YAML、JSON、Properties、INI、XML六种常见配置格式在线编辑。默认为：TEXT。                                                                                                                                                                                           |
   | \*配置内容 | 输入配置内容。                                                                                                                                                                                                                                                    |
   | 是否启用   | 选择是否启用配置： - 现在启用：创建成功后，配置立即生效。  - 暂不启用：创建成功后，配置暂不生效。                |
      
   
   
7. 单击"立即创建"，启用该配置项。
 
#### 创建微服务级配置
将新建的配置关联到某一微服务，并添加微服务名称、应用名称和环境。
![](https://support.huaweicloud.com/usermanual-cse/public_sys-resources/note_3.0-zh-cn.png)
**配置项使用明文存储，请勿附带敏感数据。**
1. 登录[微服务引擎控制台](https://console.huaweicloud.com/cse2/)。
2. 在左侧导航栏选择"ServiceComb引擎专享版"。

3. 单击待操作的引擎名称。
4. 选择"配置管理"。 
   - 未开启安全认证的引擎，请执行[6]。
   
   - 开启安全认证的引擎，当登录控制台的用户为[导入IAM账号](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0024.html#cse_usermanual_0024__section176291011154918)中导入的用户，请执行[6]，其他用户请执行[5]。
   
   
   
   
5. 在弹出的"安全认证"对话框输入账号名及其密码，单击"确定"。
   
   ![](https://support.huaweicloud.com/usermanual-cse/public_sys-resources/note_3.0-zh-cn.png)
   - 首次连接ServiceComb引擎，请输入root账号名及[创建ServiceComb引擎](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0005.html)时输入的密码。
   
   - 创建账号请参考[新增账号](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0024.html#cse_usermanual_0024__section1417318590327)。
    
   
   
6. 单击"新建配置"，参考下表设置配置参数。参数前面带\*号的是必须设置的参数。
   
   
   | 参数名称   | 参数说明                                                                                                                                                                                                                                                  |
   |:---|:---|
   | \*配置项  | 输入配置项。 配置项为该配置的全局ID，在编码阶段通过配置项对配置进行索引及操作。建议采用类Java包命名方式（如cse.service.registry.address）的命名规则来保证配置项的可读性和唯一性。                                                                                                               |
   | 配置范围   | 选择"微服务级配置"。                                                                                                                                                                                                                                           |
   | \*微服务  | 1. 选择或者输入微服务名称。  2. 选择或输入应用名称。  3. 选择环境。   |
   | 配置格式   | 选择配置格式，支持TEXT、YAML、JSON、Properties、INI、XML六种常见配置格式在线编辑。默认为：TEXT。                                                                                                                                                                                      |
   | \*配置内容 | 输入配置内容。                                                                                                                                                                                                                                               |
   | 是否启用   | 选择是否启用配置： - 现在启用：创建成功后，配置立即生效。  - 暂不启用：创建成功后，配置暂不生效。                         |
      
   
   

7. 单击"立即创建"，启用该配置项。
 
#### 创建自定义配置
当应用级配置、微服务级配置不能满足使用需求时，可自定义配置文件。
![](https://support.huaweicloud.com/usermanual-cse/public_sys-resources/note_3.0-zh-cn.png)
**配置项使用明文存储，请勿附带敏感数据。**
1. 登录[微服务引擎控制台](https://console.huaweicloud.com/cse2/)。
2. 在左侧导航栏选择"ServiceComb引擎专享版"。

3. 单击待操作的引擎名称。
4. 选择"配置管理"。 
   - 未开启安全认证的引擎，请执行[6]。
   
   - 开启安全认证的引擎，当登录控制台的用户为[导入IAM账号](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0024.html#cse_usermanual_0024__section176291011154918)中导入的用户，请执行[6]，其他用户请执行[5]。
   
   
   
   
5. 在弹出的"安全认证"对话框输入账号名及其密码，单击"确定"。
   
   ![](https://support.huaweicloud.com/usermanual-cse/public_sys-resources/note_3.0-zh-cn.png)
   - 首次连接ServiceComb引擎，请输入root账号名及[创建ServiceComb引擎](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0005.html)时输入的密码。
   
   - 创建账号请参考[新增账号](https://support.huaweicloud.com/usermanual-cse/cse_usermanual_0024.html#cse_usermanual_0024__section1417318590327)。
    
   
   
6. 单击"新建配置"，参考下表设置配置参数。参数前面带\*号的是必须设置的参数。
   
   
   | 参数名称   | 参数说明                                                                                                                                                                                                                                            |
   |:---|:---|
   | \*配置项  | 输入配置项。 配置项为该配置的全局ID，在编码阶段通过配置项对配置进行索引及操作。建议采用类Java包命名方式（如cse.service.registry.address）的命名规则来保证配置项的可读性和唯一性。                                                                                                         |
   | 配置范围   | 选择"自定义配置"。                                                                                                                                                                                                                                      |
   | 标签     | 当应用级配置、微服务级配置不能满足使用需求，可通过标签创建自定义配置。                                                                                                                                                                                                             |
   | 配置格式   | 选择配置格式，支持TEXT、YAML、JSON、Properties、INI、XML常见配置格式在线编辑。默认为：TEXT。                                                                                                                                                                                  |
   | \*配置内容 | 输入配置内容。                                                                                                                                                                                                                                         |
   | 是否启用   | 选择是否启用配置： - 现在启用：创建成功后，配置立即生效。  - 暂不启用：创建成功后，配置暂不生效。   |
      
   
   
7. 单击"立即创建"，启用该配置项。