命名空间的配置项是一种存储应用所需配置信息的资源类型,它可以作为容器运行环境中的环境变量,便于应用部署后灵活变更容器配置,也可以通过挂载配置文件的方式向容器中注入配置信息。本文介绍如何创建和使用命名空间的配置项。
背景信息
命名空间的配置项仅用于容器运行环境的存储及配置,如果您需要创建应用代码的配置文件,请参见管理配置。
创建配置项
- 登录SAE控制台。
- 在左侧导航栏单击命名空间,在顶部菜单栏选择地域,单击具体命名空间名称。
- 在左侧导航栏单击配置项,在配置项页面单击创建。
- 在创建配置项面板,选择以下任一方法来创建配置项,并单击确定。
- 手工创建:在默认显示的手工创建页签,输入相关参数。

参数说明如下:
参数 |
说明 |
配置项名称 |
自定义。 |
配置项描述 |
描述信息不超过255个字符。 |
配置映射 |
- 键的长度不超过250个字符,值的长度不超过10,000个字符。
- 一个键可对应多个值,最多可添加20个键值对。
- 如需添加更多键值对,请单击添加。
|
- 文件录入:单击文件录入页签,输入相关参数。

参数说明如下:
参数 |
说明 |
配置项名称 |
自定义。 |
配置格式 |
选择JSON或YAML。
|
配置内容 |
-
JSON文件格式示例: {
"env.home": "/root",
"env.shell": "/bin/sh",
"nginx.conf": "daemon off;\nworker_processes 2;\nuser www-data;\n\nevents {\n use epoll;\n worker_connections 128;\n}\n\nerror_log logs/error.log info;\n\nhttp {\n server_tokens off;\n include mime.types;\n charset utf-8;\n\n access_log logs/access.log combined;\n\n server {\n server_name localhost;\n listen 127.0.0.1:80;\n\n error_page 500 502 503 504 /50x.html;\n\n location / {\n root html;\n }\n\n }\n\n}"
}
-
YAML文件格式示例: env.home: /root
env.shell: /bin/sh
nginx.conf: |
daemon off;
worker_processes 2;
user www-data;
events {
use epoll;
worker_connections 128;
}
error_log logs/error.log info;
http {
server_tokens off;
include mime.types;
charset utf-8;
access_log logs/access.log combined;
server {
server_name localhost;
listen 127.0.0.1:80;
error_page 500 502 503 504 /50x.html;
location / {
root html;
}
}
}
说明
- 输入Kubernetes ConfigMap Manifest文件内容,支持JSON、YAML格式。
- 中文字符仅支持UTF-8编码格式。
- 文件内容的数据值大小不超过512K。
|
创建的配置项将显示在配置项页面。
编辑和删除配置项
- 登录SAE控制台。
- 在左侧导航栏单击命名空间,在顶部菜单栏选择地域,单击具体命名空间名称。
- 在左侧导航栏单击配置项,在配置项页面编辑或删除配置项。
- 编辑:单击操作列的编辑,在编辑配置项页签输入相关参数并单击确定。
- 删除:单击操作列的删除,在删除配置项对话框单击确定。
说明
如果已有应用正在使用目标配置项:
- 修改后的配置项新版本仅生效于应用新实例(如手动新扩容或自动弹性的新实例),对存量实例不生效。为保证应用所有实例配置项版本的最终一致性,您在修改配置项后必须手动重启或部署应用。
- 删除配置项将会影响这些应用的正常运行。请先在关联应用中解除使用该配置项再删除。
将配置项用作环境变量
配置项可以用作容器运行环境中的环境变量,便于部署后灵活变更容器配置。
- 登录SAE控制台。
- 在左侧导航栏单击应用列表,在顶部菜单栏选择地域,单击创建应用。
- 在应用基本信息页签输入所有必填信息,并单击下一步:应用部署配置。
- 在应用部署配置页签输入所有必填信息,并在页面下方展开环境变量设置。
- 在环境变量设置区域的类型下拉框中选择引用配置项,输入变量名称,并在最右侧的下拉框中选择已创建的配置项名称和该配置项中的键。
- 可选:如需引用其他配置项,单击添加,并重复上一步。
- 单击下一步:确认规格。
- 在确认规格页签,查看您所创建应用的详细信息以及配置费用情况,并单击确认创建。
利用配置项向容器中注入配置信息
您可以使用在命名空间配置项页面创建的配置项来向容器中注入配置信息。
- 登录SAE控制台。
- 在左侧导航栏单击应用列表,在顶部菜单栏选择地域,单击创建应用。
- 在应用基本信息配置向导页面设置应用相关信息,并单击下一步:应用部署配置。
- 在应用部署配置配置向导页面,选择技术栈语言和应用部署方式,设置部署参数。
- 在应用部署配置页签,展开配置管理区域,选择已创建的配置项名称和该配置项中的键,并输入挂载配置项的挂载路径。

说明 您也可以在键下拉列表中选择全部,将该配置项的所有键挂载到该路径。
- 可选:如需引用其他配置项,单击添加,并重复上一步。
- 单击下一步:确认规格。
- 在确认规格页签,查看您所创建应用的详细信息以及配置费用情况,并单击确认创建。