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

管理应用级环境变量

应用级环境变量是指在系统或用户应用程序中设置的一些参数,在代码里调用接口去获取环境变量的值。在部署时通过环境变量去指定参数配置,而不用在代码中指定,使部署具有灵活性。应用下添加的环境变量,属于全局环境变量,对此应用下的所有组件都起作用。

如果您需要对应用下特定的组件添加环境变量:

关于环境级环境变量,请参考管理环境级环境变量

使用应用级环境变量前,您需要先为应用添加应用级环境变量。您可以使用手动添加应用级环境变量或者导入应用级环境变量为应用添加应用级环境变量,也可以根据实际业务需要编辑应用级环境变量删除应用级环境变量

手动添加应用级环境变量

  1. 登录ServiceStage控制台
  2. 选择“应用管理”
  3. 单击待操作的应用名称,进入“应用概览”页面。
  1. 在左侧导航栏,单击“环境变量”。
  2. 在下拉列表选择已经创建的环境。

  3. 设置应用环境变量生效策略。

    • 首次生效:环境变量只在组件首次创建时生效,后续环境变量的修改不会同步到应用下已存在的组件中。

    • 持续生效:后续环境变量的修改会通过组件升级同步到应用下已存在的组件中。

  4. 单击“添加环境变量”,输入“变量名称”及“变量/变量引用”的值。

    请您在配置环境变量时慎用敏感信息或者加密敏感信息,以免造成信息泄露。

    • 变量名称:应用环境变量的名称,在同一个应用环境下必须唯一。长度1到64个字符,可以包含英文字母、数字、下划线(_)、中划线(-)或点(.),以英文字母、下划线(_)或中划线(-)开头。
    • 变量/变量引用:应用环境变量的值。

    例如,设置“变量名称”为“User”,“变量/变量引用”为“admin”。即当程序代码读取“User”环境变量时,获取值为“admin”。例如可以使用admin用户启动子进程,可以用admin用户去读取文件等。实际执行效果视代码而定。

  5. 单击“提交”,完成应用环境变量手动添加。

    选择了“持续生效”环境变量生效策略的应用环境变量发生变化后,您可以:

导入应用级环境变量

导入的文件必须为JSON或YAML格式、字符串形式的键值对映射,一次性最多支持导入200个环境变量。文件内容及格式示例如下:

{"key1": "value1", "key2": "value2"}

其中:

  • “key1”、"key2"是应用环境变量的名称,在同一个应用环境下必须唯一。长度1到64个字符,可以包含英文字母、数字、下划线(_)、中划线(-)或点(.),以英文字母、下划线(_)或中划线(-)开头。
  • “value1”、"value2"是对应应用环境变量的值。

请您在配置环境变量时慎用敏感信息或者加密敏感信息,以免造成信息泄露。

  1. 登录ServiceStage控制台
  2. 选择“应用管理”
  3. 单击待操作的应用名称,进入“应用概览”页面。
  1. 在左侧导航栏,单击“环境变量”。
  2. “环境”下拉列表选择已经创建的环境。
  3. 设置应用环境变量生效策略。

    • 首次生效:环境变量只在组件首次创建时生效,后续环境变量的修改不会同步到应用下已存在的组件中。

    • 持续生效:后续环境变量的修改会通过组件升级同步到应用下已存在的组件中。

  4. 单击“导入”,选择本地已创建好的环境变量文件。
  5. 单击“提交”,完成应用环境变量文件导入。

    选择了“持续生效”环境变量生效策略的应用环境变量发生变化后,您可以:

编辑应用级环境变量

  1. 登录ServiceStage控制台
  2. 选择“应用管理”
  3. 单击待操作的应用名称,进入应用概览页面。
  1. 在左侧导航栏,单击“环境变量”。
  2. “环境”下拉列表选择已经创建的环境。
  3. 设置应用环境变量生效策略。

    • 首次生效:环境变量只在组件首次创建时生效,后续环境变量的修改不会同步到应用下已存在的组件中。

    • 持续生效:后续环境变量的修改会通过组件升级同步到应用下已存在的组件中。

  4. 选择待编辑的变量名称,在“操作”列单击“编辑”
  5. 重新输入“变量名称”及“变量/变量引用”的值。

    请您在配置环境变量时慎用敏感信息或者加密敏感信息,以免造成信息泄露。

    • 变量名称:应用环境变量的名称,在同一个环境下必须唯一。长度1到64个字符,可以包含英文字母、数字、下划线(_)、中划线(-)或点(.),以英文字母、下划线(_)或中划线(-)开头。
    • 变量/变量引用:应用环境变量的值。

  6. 单击“提交”,完成应用环境变量编辑。

    选择了“持续生效”环境变量生效策略的应用环境变量发生变化后,您可以:

删除应用级环境变量

  1. 登录ServiceStage控制台
  2. 选择“应用管理”
  3. 单击待操作的应用名称,进入应用概览页面。
  1. 在左侧导航栏,单击“环境变量”。
  2. “环境”下拉列表选择已经创建的环境。

    • 删除单个应用环境变量:选择待删除的变量名称,在“操作”列单击“删除”
      图1 删除单个应用环境变量
    • 批量删除应用环境变量:勾选待删除的变量名称,单击“批量删除”
      图2 批量删除应用环境变量

  3. 在弹出对话框,单击“确定”

    选择了“持续生效”环境变量生效策略的应用环境变量发生变化后,您可以: