更新时间:2025-08-26 GMT+08:00

创建配置文件

本章节指导您创建配置文件,将组件所在环境和应用的系统变量填充到配置文件对应的变量中,便于不同应用下有多个组件在不同环境中部署、升级时使用。

同一个项目下,最多支持创建1,000个配置文件。

创建配置文件

  1. 登录ServiceStage控制台
  2. 选择配置管理 > 配置列表 > 创建配置
  3. “基本信息”区域,参考下表填写配置文件基本信息。

    参数名称

    参数说明

    配置名称

    配置文件的名称,创建后不支持修改。

    配置文件名称可以包含英文字母、数字、下划线(_)或中划线(-)。

    长度1到64个字符。配置文件扩展名可选,最大长度(包含.)不超过17个字符。

    配置分组

    分组用于分类管理配置文件,同一个分组内配置文件名称必须唯一。

    • 选择下拉列表中已存在的分组。
    • 单击“创建分组”,可以参考创建分组创建新的分组。

    配置描述

    配置文件描述信息。

    1. 单击
    2. 输入配置文件的描述信息,不超过128个字符。
    3. 单击,完成配置文件描述信息输入。

  4. “配置内容”区域,根据实际业务需要参考下表设置配置文件参数。

    参数名称

    参数说明

    关联密钥

    如果您的配置项中有密码等敏感信息需要加密存放,您可以对接密钥管理服务(DEW)通过自定义密钥加解密敏感信息。

    1. 单击“绑定关联密钥”
    2. 选择“选择密钥”下拉列表中已经创建好的密钥。

      如需选择新的密钥,请单击“前往创建密钥”,参考创建密钥

    3. 单击“确定”

    挂载方式

    仅容器部署方式部署的组件,支持设置“挂载方式”

    • secret:如果配置文件中存在密码等敏感数据,适用于通过secret方式挂载。
    • configmap:如果配置文件中不存在敏感数据,适用于通过configmap方式挂载。

  5. “配置内容”区域,根据实际业务需要参考下表中的方法设置配置文件内容。

    方法

    说明

    手动输入

    根据您的实际业务需要在编辑栏手工输入配置文件内容。

    您可以根据实际业务需要参考如下说明选择是否对变量(例如:xxx)进行加密:

    • xxx,表示不加密,在组件部署时会自动将变量xxx替换为实际值。
    • #{xxx},表示加密,在组件部署时会自动将变量xxx对应的实际值通过选择的DEW密钥加密。

    修改示例

    根据您的实际业务需要修改ServiceStage提供的参考示例迅速完成配置文件内容设置。

    1. 单击“查看参考示例”,弹出“参考示例”对话框。
    2. 单击,复制示例内容。
    3. 单击,关闭“参考示例”对话框。
    4. 将复制的示例内容粘贴到“配置内容”区域的编辑栏,根据您的实际业务需要进行编辑。

      您可以根据实际业务需要参考如下说明选择是否对变量(例如:${xxx})进行加密:

      • ${xxx},表示不加密,在组件部署时会自动将变量替换为实际值。
      • #{${xxx}},表示加密,在组件部署时会自动将变量对应的实际值通过选择的DEW密钥加密。

    插入系统变量

    ServiceStage提供了如表1所示的环境、应用、组件相关的变量,您可以在配置文件中使用这些系统变量。

    1. 单击“系统变量”
    2. 鼠标移动到“变量”列表中待写入配置文件的变量名,例如:xxx。
      • 单击“插入”,会将${xxx} 插入“配置内容”下的编辑栏。在组件部署时会自动将系统变量${xxx} 替换为实际值。
      • 单击“插入并加密”,会将#{${xxx}}插入“配置内容”下的编辑栏,#表示开启加密,在组件部署时会自动将系统变量${xxx} 对应的实际值通过选择的DEW密钥加密。

  6. (可选)单击“内容校验”,根据内容正确性校验提示完成配置内容修改。
  7. 单击“发布”,系统会自动进行内容正确性校验,请根据内容正确性校验提示完成配置内容修改。

    创建成功后,在“配置管理”列表下可以查看到该配置文件。