配置项

场景说明

应用经常有从配置文件、命令行参数或者环境变量中读取一些配置信息的需求，例如您的应用连接一个redis服务，在不同运行环境需要不同的配置，如果配置信息直接硬编码到应用程序中，那么就需要修改代码中的配置并重新制作镜像。而ConfigMap提供了向容器中注入配置信息的能力，可以用ConfigMap来保存整个redis的配置文件，更换配置或环境时，不需要重新制作镜像，直接修改ConfigMap的配置数据即可。

操作步骤

1. 访问IoT边缘，单击“管理控制台”进入IoT边缘控制台。
2. 选择左侧导航栏“边缘集群 > 集群管理”进入页面，选择“状态”为“运行中”的集群，单击“边缘集群名称”进入集群概览页。
3. 在左侧导航栏选择“应用配置”进入配置项页。
4. 单击页面左上角“创建配置项”，在弹窗中按照表1填写配置项参数。
   

   配置项会明文展示所输入信息，请不要填入敏感信息，如涉及敏感信息，请先加密，防止信息泄露。

   图1 创建配置项
   

   表1 参数说明

   参数名称	参数说明
   配置项名称	新建的配置项名称，同一个命名空间里命名必须唯一。
   命名空间	新建配置项所在的命名空间，默认为default。
   描述	配置项描述，可选填。
   配置数据	配置项的数据，key-value形式的键值对。这些数据可以在 Pod 里面使用。

5. 配置完成后，单击“确认”即可创建配置项，配置项列表中会出现新创建的配置项。

使用配置项

1. 按照上述操作步骤创建配置项，以表2为例，将在边缘集群中创建下面这个ConfigMap。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: iot-configmap
   data:
     SPECIAL_LEVEL: Hello
     SPECIAL_TYPE: IoT

   表2 参数说明

   参数名称	参数值
   配置项名称	iot-configmap
   命名空间	default
   描述	无
   配置数据（“键”=“值”）	SPECIAL_LEVEL: Hello SPECIAL_TYPE: IoT

2. 创建自己的模板应用，将ConfigMap以数据卷的形式挂载到容器，然后就可以在应用中使用配置项了。如下面的示例所示，配置项挂载完成后，最终会在容器中的/etc/config目录下生成以配置项中的key为文件名， value为文件内容的配置文件。下面会在应用运行正常后，生成“SPECIAL_LEVEL”和“SPECIAL_TYPE”两个文件，且文件的内容分别为“Hello”和“IoT”。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-demo
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: nginx-demo
     template:
       metadata:
         labels:
           app: nginx-demo
       spec:
         containers:
         - name: container-1
           image: nginx:latest
           volumeMounts:
           - name: config-volume
             mountPath: /etc/config            # 挂载到/etc/config目录下
       volumes:
       - name: config-volume
         configMap:
           name: iot-configmap                 # 引用的配置项名称

3. 按照操作步骤创建应用模板。
4. 按照操作步骤添加应用版本。
5. 按照操作步骤部署应用到边缘集群。
6. 也可以为应用增加一些监测配置文件变更的功能或脚本，然后更新配置项，可以实现配置信息的热更新。

相关操作

配置项创建完成后，您还可以执行表3中的操作。