配置管理（适用于2.x版本）

使用须知

• 配置项使用明文存储，请勿附带敏感数据。
• 当引擎规格限定的配置条目配额即将用完时，为了保证尽量可用，引擎允许超出剩余配额的新建配置项操作同时成功。请尽快扩容引擎，避免后续新建配置失败。
• 对于编辑或删除配置项，若配置项已被微服务使用，可能导致微服务读取不到配置或读取错误配置，引发业务异常。因此在操作修改或删除配置项前请备份配置。

创建应用级配置

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“新建配置”，参考下表设置配置参数。参数前面带*号的是必须设置的参数。

   参数名称	参数说明
   *配置项	输入配置项。 配置项为该配置的全局ID，在编码阶段通过配置项对配置进行索引及操作。建议采用类Java包命名方式（如cse.service.registry.address）的命名规则来保证配置项的可读性和唯一性。 说明： 创建应用级配置时不允许创建以“servicecomb.matchGroup.”开头的配置项，此开头的配置会与创建业务场景治理生成的配置冲突，导致业务场景无法显示。
   配置范围	选择“应用级配置”。
   *应用	选择或输入应用名称。 选择环境。
   配置格式	选择配置格式，支持TEXT、YAML、JSON、Properties、INI、XML常见配置格式在线编辑。默认为：TEXT。
   *配置内容	输入配置内容。
   是否启用	选择是否启用配置： 现在启用：创建成功后，配置立即生效。 暂不启用：创建成功后，配置暂不生效。

6. 单击“立即创建”，启用该配置项。

创建微服务级配置

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“新建配置”，参考下表设置配置参数。参数前面带*号的是必须设置的参数。

   参数名称	参数说明
   *配置项	输入配置项。 配置项为该配置的全局ID，在编码阶段通过配置项对配置进行索引及操作。建议采用类Java包命名方式（如cse.service.registry.address）的命名规则来保证配置项的可读性和唯一性。
   配置范围	选择“微服务级配置”。
   *微服务	选择或者输入微服务名称。 选择或输入应用名称。 选择环境。
   配置格式	选择配置格式，支持TEXT、YAML、JSON、Properties、INI、XML常见配置格式在线编辑。默认为：TEXT。
   *配置内容	输入配置内容。
   是否启用	选择是否启用配置： 现在启用：创建成功后，配置立即生效。 暂不启用：创建成功后，配置暂不生效。

6. 单击“立即创建”，启用该配置项。

创建自定义配置

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“新建配置”，参考下表设置配置参数。参数前面带*号的是必须设置的参数。

   参数名称	参数说明
   *配置项	输入配置项。 配置项为该配置的全局ID，在编码阶段通过配置项对配置进行索引及操作。建议采用类Java包命名方式（如cse.service.registry.address）的命名规则来保证配置项的可读性和唯一性。
   配置范围	选择“自定义配置”。
   标签	当应用级配置、微服务级配置不能满足使用需求，可通过标签创建自定义配置。
   配置格式	选择配置格式，支持TEXT、YAML、JSON、Properties、INI、XML常见配置格式在线编辑。默认为：TEXT。
   *配置内容	输入配置内容。
   是否启用	选择是否启用配置： 现在启用：创建成功后，配置立即生效。 暂不启用：创建成功后，配置暂不生效。

6. 单击“立即创建”，启用该配置项。

导入配置

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击右上角的“导入”，参考下表设置导入参数。

   参数名称	参数说明
   导入至特定环境	关闭：导入的配置不改变环境标签。 开启：把配置导入至特定环境，将会改变环境标签。
   相同配置	终止导入：导入过程中，如果遇到和系统中相同的配置，导入终止。 跳过：导入过程中，如果遇到和系统中相同的配置，该配置会被跳过，继续导入其余配置。 覆盖：导入过程中，如果遇到和系统中相同的配置，该配置的值会被替换。
   配置文件	单击“导入文件”，选择待导入配置文件。 说明： 待导入的配置文件大小不超过2MB。

6. 单击“关闭”，完成导入。

导出配置

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 勾选待导出的配置项，单击“导出”，在弹出框中单击“导出”，配置文件导出成功。也可单击右上方的“全部导出”导出所有配置信息。

对比配置版本

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击待对比的配置项名称。
6. 单击“历史版本”。
7. 在左侧“历史版本”列表选择待查看的历史版本。

   在右侧“配置文件”列，可查看历史版本和当前版本的差异。

   

   在“历史版本”列表中最多可显示100个历史版本。

回滚版本

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击待操作的配置项名称。
6. 单击“历史版本”。
7. 在左侧“历史版本”列表，选择待回滚到的历史版本。
8. 在右侧“配置文件”列，单击“回滚到此版本”。

查看历史版本

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击某配置项右侧“操作”列的“查看历史版本”，进入“历史版本”页面可查看该配置项的历史版本，在该页面也可对比配置版本和回滚版本操作。

编辑配置项

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击待编辑的配置项右侧“操作”列的“编辑”，也可单击待编辑的配置项名称，在配置详情页面，单击“编辑”。
6. 在“配置内容”输入框输入配置信息，单击“保存”编辑配置项完成。

禁用配置项

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 在待禁用的配置项右侧“操作”列选择“更多 > 禁用”。
6. 在弹出框中单击“确定”禁用该配置项。

删除配置项

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 选择“配置管理”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 在待删除的配置项右侧“操作”列选择“更多 > 删除”，也可单击待删除的配置项名称，在配置详情页面，单击“删除”。
6. 在弹出框中单击“确定”删除该配置项。