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

添加组件级环境变量

组件级环境变量是在组件运行环境中设定,可以为应用提供极大的灵活性。组件下设置的环境变量属于局部环境变量,仅对该组件起作用。

如果您在该组件所在的应用下添加了应用级环境变量,且应用级环境变量的变量名称和该应用下的组件环境变量名称相同,则该应用级环境变量会被组件级环境变量屏蔽,不再对该组件起作用。添加应用级环境变量,请参考管理应用级环境变量

应用级环境变量、组件级环境变量和环境级环境变量相比,环境级环境变量的优先级小于应用级环境变量,应用级环境变量的优先级小于组件级环境变量。

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

添加组件级环境变量

  1. 选择“容器配置 > 环境变量”。
  2. 参考下表设置组件环境变量。

    类型

    设置方法

    手动添加

    手动填写环境变量名称及对应的参数值。

    1. 单击“添加环境变量”,选择“手动添加”
    2. 输入新增环境变量的“变量名称”“变量/变量引用”

      “变量名称”在同一个组件下必须唯一。长度1到64个字符,可以包含英文字母、数字、下划线(_)、中划线(-)或点(.),以英文字母、下划线(_)或中划线(-)开头。

    密钥导入

    将密钥中某个键的值导入作为环境变量的值。

    1. 创建密钥,请参考创建密钥
    2. 单击“添加环境变量”,选择“密钥导入”
    3. 输入“变量名称”

      “变量名称”在同一个组件下必须唯一。长度1到64个字符,可以包含英文字母、数字、下划线(_)、中划线(-)或点(.),以英文字母、下划线(_)或中划线(-)开头。

    4. 在“变量/变量引用”的下拉框中选择对应的密钥下的键。

      导入后将会存在一个以3输入的变量名称命名的组件环境变量,其值为选择的键对应的值。

    配置项导入

    将配置项中某个键的值导入作为环境变量的值。

    1. 创建配置项,请参考创建配置项
    2. 单击“添加环境变量”,选择“配置项导入”
    3. 输入“变量名称”

      “变量名称”在同一个组件下必须唯一。长度1到64个字符,可以包含英文字母、数字、下划线(_)、中划线(-)或点(.),以英文字母、下划线(_)或中划线(-)开头。

    4. 在“变量/变量引用”的下拉框中选择对应的配置项下的键。

      导入后将会存在一个以3输入的变量名称命名的组件环境变量,其值为选择的键对应的值。

    从文件导入

    单击“从文件导入”,选择导入本地配置文件。

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

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

    其中:

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

    资源引用

    1. 单击“添加环境变量”,选择“资源引用”
    2. 输入“变量名称”

      “变量名称”在同一个组件下必须唯一。长度1到64个字符,可以包含英文字母、数字、下划线(_)、中划线(-)或点(.),以英文字母、下划线(_)或中划线(-)开头。

    3. 在“变量/变量引用”下拉框选择容器定义的资源申请值或限制值作为环境变量的值。

    变量/变量引用

    用实例定义的字段作为环境变量的值。

    1. 单击“添加环境变量”,选择“变量/变量引用”
    2. 输入“变量名称”

      “变量名称”在同一个组件下必须唯一。长度1到64个字符,可以包含英文字母、数字、下划线(_)、中划线(-)或点(.),以英文字母、下划线(_)或中划线(-)开头。

    3. 在“变量/变量引用”下拉框选择用实例定义的字段作为环境变量的值。