命名空间的配置项是一种存储应用所需配置信息的资源类型，它可以作为容器运行环境中的环境变量，便于应用部署后灵活变更容器配置，也可以通过挂载配置文件的方式向容器中注入配置信息。本文介绍如何在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。
-
创建的配置项将显示在配置项页面，您可以对其进行编辑、复制和删除的操作。说明- 修改后的配置项新版本仅生效于应用新实例（如手动新扩容或自动弹性的新实例），对存量实例不生效。为保证应用所有实例配置项版本的最终一致性，您在修改配置项后必须手动重启或部署应用。
- 删除配置项将会影响这些应用的正常运行。请先在关联应用中解除使用该配置项再删除。
- 手工创建：在默认显示的手工创建页签，输入相关参数。
将配置项用作环境变量
配置项可以用作容器运行环境中的环境变量，便于部署后灵活变更容器配置。
- 在环境变量设置区域的类型下拉框中选择引用配置项，输入变量名称，并在最右侧的下拉框中选择已创建的配置项名称和该配置项中的键。
说明 除了在命名空间页面提前创建好配置项，您也可以在环境变量设置区域单击创建配置项（K8s configmap），在创建配置项面板进行创建。
在应用创建过程中注入配置信息
您可以使用在命名空间配置项页面创建的配置项来向容器中注入配置信息。
- 在应用部署配置页签，展开配置管理区域，选择已创建的配置项名称和该配置项中的键，并输入挂载配置项的挂载路径。
说明- 除了在命名空间页面提前创建好配置项，您也可以在环境变量设置区域单击创建配置项（K8s configmap），在创建配置项面板进行创建。
- 您也可以在键下拉列表中选择全部，将该配置项的所有键挂载到该路径。