环境变量

本文将指导您完成应用运行所需环境变量的添加、修改及删除操作。环境变量用于为应用运行提供动态配置参数，无需修改应用代码即可调整运行属性，适配不同部署环境需求。操作以无状态应用为例，其他类型负载（有状态应用、守护进程集等）流程可参考。

一、前提条件

• 已获取MCE容器引擎系统登录权限，且具备目标应用所在命名空间的编辑权限；
• 明确环境变量的配置需求，提前梳理需添加/修改的变量名称、值及来源（直接输入/引用ConfigMap/引用Secret）；
• 若应用处于运行状态，修改环境变量后会触发容器重启，建议在业务低峰期操作。

二、进入环境变量配置页面

请按以下明确路径进入目标应用的环境变量配置页面：

• 登录系统后，在系统主界面选择【MCE容器引擎】模块，点击进入；
• 进入MCE容器引擎后，在左侧导航菜单中依次点击【容器云服务】→对应应用类型（如无状态应用/有状态应用），进入应用列表页面；
• 在应用列表中，找到需要配置环境变量的目标应用，点击其名称进入应用详情页面；
• 在详情页面的选项卡区域，找到并点击【更新升级】中更多设置，在展开的配置模块中定位到【环境变量】配置项，即可进入环境变量配置界面，界面参考如下：

三、核心操作流程

环境变量支持三种配置来源：直接输入（自定义固定值）、引用ConfigMap（非敏感配置）、引用Secret（敏感配置，如密码、密钥），核心操作包括添加、修改、删除，具体流程如下：

（一）添加环境变量

根据变量类型选择对应配置方式，步骤如下：

1. 直接输入（自定义固定值）

• 在环境变量配置界面，点击【+ 添加环境变量】按钮，弹出配置弹窗；
• 选择“类型”为【直接输入】；
• 填写“变量名”：需符合环境变量命名规范（通常为大写字母+下划线，如APP_PORT、LOG_LEVEL）；
• 填写“变量值”：根据业务需求输入具体值（如8080、INFO）；
• 点击弹窗内的【确认】按钮，完成单个变量添加，新增变量会显示在环境变量列表中。

2. 引用ConfigMap

适用于引用已存在的ConfigMap中的非敏感配置项，避免重复配置：

• 点击【+ 添加环境变量】，选择“类型”为【引用ConfigMap】；
• 选择“命名空间”：与目标ConfigMap所在命名空间一致；
• 选择“ConfigMap名称”：从下拉列表中选择需引用的ConfigMap；
• 选择“键”：从选中的ConfigMap中选择对应的配置项键名；
• 填写“变量名”：自定义环境变量名称（可与ConfigMap键名一致，也可自定义）；
• 点击【确认】，完成引用配置。

可能通过YAML编辑的方式进行引用

3. 引用Secret

适用于引用已存在的Secret中的敏感配置项（如数据库密码、API密钥），保障数据安全：

• 点击【+ 添加环境变量】，选择“类型”为【引用Secret】；
• 选择“命名空间”：与目标Secret所在命名空间一致；
• 选择“Secret名称”：从下拉列表中选择需引用的Secret；
• 选择“键”：从选中的Secret中选择对应的敏感配置项键名；
• 填写“变量名”：自定义环境变量名称；
• 点击【确认】，完成引用配置（页面会对敏感值进行脱敏显示）。

可能通过YAML编辑的方式进行引用

（二）修改环境变量

对已存在的环境变量进行参数调整，步骤如下：

• 在环境变量列表中，找到需要修改的变量条目，点击其右侧的【编辑】按钮；
• 在弹出的编辑弹窗中，根据变量类型调整对应参数：
  • 直接输入类型：修改“变量值”（变量名可按需修改）；
  • 引用ConfigMap/Secret类型：可调整“变量名”，或重新选择“ConfigMap/Secret名称”“键”；
• 修改完成后，点击弹窗内的【确认】按钮，暂存修改；
• 若需批量修改多个变量，重复上述步骤即可。

（三）删除环境变量

移除不需要的环境变量，步骤如下：

• 在环境变量列表中，找到需要删除的变量条目，点击其右侧的【删除】按钮；
• 系统弹出确认弹窗，提示“删除后将无法恢复，是否确认删除？”，点击【确认】按钮；
• 删除完成后，环境变量列表中不再显示该条目。

四、完成配置提交

• 所有环境变量的添加、修改、删除操作完成后，返回上级配置界面，仔细核对变量列表：确认变量名、类型、值（或引用资源）准确无误，无重复变量名；
• 核对无误后，点击页面底部的【提交】或【确认修改】按钮，提交环境变量配置变更；
• 系统将校验配置的合法性（如变量名格式、引用资源是否存在），若校验通过，将触发应用容器重启以加载新的环境变量配置；若校验失败（如引用的ConfigMap不存在、变量名重复），需根据提示修正后重新提交；
• 提交完成后，返回应用详情页面，查看应用状态，确保容器重启后正常运行；可通过容器终端执行env命令，验证环境变量是否生效。

五、注意事项

• 环境变量修改后容器会自动重启，需提前评估对业务的影响，建议在业务低峰期操作；
• 敏感配置（如密码、密钥、证书）必须通过“引用Secret”方式配置，禁止使用“直接输入”方式，避免敏感信息泄露；
• 变量名需符合规范，避免使用特殊字符，建议与应用代码中定义的环境变量名严格一致，否则会导致应用无法读取配置；
• 引用ConfigMap/Secret时，需确保目标资源已存在且与当前应用处于同一命名空间，否则会导致配置失效；
• 若应用启动失败，可检查环境变量是否存在配置错误（如变量值格式错误、引用资源不存在），修正后重新提交；
• 环境变量的优先级：直接输入的变量值优先级高于引用资源的变量值，若同时配置同一变量名，以直接输入的值为准。