Kubernetes ConfigMap 可以将配置信息和容器镜像解耦，以使得容器化的应用程序可移植。本文提供了一系列的实例，解释如何通过 Kuboard 创建 ConfigMap 以及如何使用 ConfigMap 中的数据配置 Pod（容器组）。

前提条件

您已经安装了 Kubernetes 集群，并且已经在集群中安装了 Kuboard，如果尚未安装，请参考：

提示 Kubernetes 描述了多种 ConfigMap 的创建方法，本文不再复述，请自行参考文档 Configure a Pod to Use a ConfigMap(opens new window)

  • 打开 Kuboard 界面，并点击进入您想要创建 ConfigMap 的 名称空间，切换到 配置中心 / 配置字典 菜单，如下图所示：image.png
  • 点击 配置 —> 创建 ConfigMap 按钮并填写表单，如下图所示：image.png
  • 点击 保存ConfigMap 创建成功

    ConfigMap —> 容器的环境变量

  • 在名称空间页面点击 创建工作负载填写表单如下：如下图所示：image.png | 字段名称 | 填写内容 | 备注 | | —- | —- | —- | | 服务类型 | Deployment | | | 服务分层 | 中间件 | | | 服务名称 | busybox | | | 副本数量 | 1 | | | 容器名称 | busybox | | | 镜像 | busybox:1.29 | | | 抓取策略 | Always | | | Command | sleep
    3600 | sleep 和 3600 是两个元素 |

    • 勾选 环境变量
    • 点击 名值对 可以添加一个环境变量
    • 填写表单：
      • 环境名： ENV_KEY_1
      • 值类型：ConfigMap
      • ConfigMap名：my-config
      • ConfigMap Key：KEY_1

  • 点击 保存


  • 点击 应用


  • 点击 完成


  • 在 busybox 的工作负载查看界面，进入容器 busybox 的终端切换到 /bin/sh 终端执行命令： echo $ENV_KEY_1可查看到输出结果为 value-1执行命令：export可查看到 ENV_KEY_1=value-1 已经注入到该容器的环境变量中，如下图所示：image.png

    ConfigMap —> 容器的环境变量（ConfigMap的所有名值对）

  • 在名称空间页面点击 创建工作负载填写表单如下：如下图所示：image.png | 字段名称 | 填写内容 | 备注 | | —- | —- | —- | | 服务类型 | Deployment | | | 服务分层 | 中间件 | | | 服务名称 | busybox | | | 服务描述 | busybox | | | 副本数量 | 1 | | | 容器名称 | busybox | | | 镜像 | busybox:1.29 | | | 抓取策略 | Always | | | Command | sleep
    3600 | sleep 和 3600 是两个元素 | | 环境变量 | my-config | 通过 + 配 置 按钮添加 |
  • 点击 保存


  • 点击 应用


  • 点击 完成


  • 在 busybox 的工作负载查看界面，进入容器 busybox 的终端切换到 /bin/sh 终端执行命令： echo $KEY_1可查看到输出结果为 value-1执行命令： echo $KEY_2可查看到输出结果为 value-2执行命令： echo $KEY_3可查看到输出结果为 3600执行命令：export可查看到 KEY_1 KEY_2 KEY_3 已经注入到该容器的环境变量中，如下图所示：image.png

    ConfigMap —> Command 参数

  • 在名称空间页面点击 创建工作负载填写表单如下：如下图所示：image.png | 字段名称 | 填写内容 | 备注 | | —- | —- | —- | | 服务类型 | Deployment | | | 服务分层 | 中间件 | | | 服务名称 | busybox | | | 服务描述 | busybox | | | 副本数量 | 1 | | | 容器名称 | busybox | | | 镜像 | busybox:1.29 | | | 抓取策略 | Always | | | Command | /bin/sh -c ‘echo ${ENVKEY_1} ${ENV_KEY_3} ; sleep ${ENV_KEY_3}’ | | | 环境变量 | ENV_KEY_1 / ENV_KEY_3 | 选择 ConfigMap
    ConfigMap 填写     my-nginx-config
    Key 填写     KEY_1_

同样的方法添加 ENV_KEY_3 |

  • 点击 保存


  • 点击 应用


  • 点击 完成


  • 在 busybox 的工作负载查看界面，进入容器 busybox 的日志界面，可查看到该命令输出的结果为 ```bash value-1 3600
  1. <br />如下图所示![image.png](https://cdn.nlark.com/yuque/0/2021/png/22177128/1637081120287-33fbbcbd-b391-43e3-a91a-40fce0dc4d9c.png#clientId=ua497e302-7949-4&from=paste&id=uf9388398&margin=%5Bobject%20Object%5D&name=image.png&originHeight=396&originWidth=1280&originalType=url&ratio=1&size=38168&status=done&style=none&taskId=ud4ff0697-c62c-4e48-b0a2-8d9f82a569a)
  2. <a name="pCAJa"></a>
  3. ## ConfigMap --> 数据卷
  5. ---
  7. - 创建 ConfigMap 如下图所示：填写表单：default_conf 的内容如下：
  8. ```bash
  9. server {
  10.     listen       80;
  11.     server_name  localhost;
  12.     location / {
  13.         root   /usr/share/nginx/html;
  14.         index  index.html index.htm;
  15.     }
  16.     error_page   500 502 503 504  /50x.html;
  17.     location = /50x.html {
  18.         root   /usr/share/nginx/html;
  19.     }
  20. }


  • image.png | 字段名称 | 填写内容 | 备注 | | —- | —- | —- | | 名称 | my-config | | | KEY_1 | value-1 | | | KEY_2 | value-2 | | | KEY_3 | 3600 | | | default_conf | 请参考下面的代码块 | 用来替换 nginx 容器中 /etc/nginx/conf.d/default.conf |

  • 创建 nginx Deployment 如下图所示：

    • 填写 基本信息image.png填写表单： | 字段名称 | 填写内容 | 备注 | | —- | —- | —- | | 服务类型 | Deployment | | | 服务分层 | 展现层 | | | 服务名称 | nginx | | | 服务描述 | Nginx部署 | | | 副本数量 | 1 | |

    • 填写 容器信息如下图所示：image.png填写表单： | 字段名称 | 填写内容 | 备注 | | —- | —- | —- | | 容器名称 | nginx | | | 镜像 | nginx:1.7.9 | | | 抓取策略 | Always | |

    • 填写 存储挂载如下图所示：image.png填写表单： | 字段名称 | 填写内容 | 备注 | | —- | —- | —- | | 数据卷名称 | 任意 | 可以使用默认生成的名称 | | 数据卷类型 | 配置字典 | | | ConfigMap | my-config | | | KeyToPath : Key | default_conf | | | KeyToPath : 子路径 | default.conf | | | 挂载到容器 nginx | 只读 | | | 挂载到容器 nginx : 挂载到容器内路径 | /etc/nginx/conf.d/default.conf | | | 挂载到容器 nginx : 子路径 | default.conf | |

  • 点击 保存


  • 点击 应用


  • 点击 完成


  • 进入 sh

终端界面执行命令

  1. # 切换当前目录
  2. cd /etc/nginx/conf.d
  3. # 查看当前目录下的文件 
  4. ls
  5. # 查看 default.conf 的内容（该文件原本的内容已被 configMap 中的内容替换）
  6. cat /default.conf

  • image.png

TIP

  • 在这个例子中，我们使用 ConfigMap my-nginx-config 中的 KEY default_conf 中的内容挂载到容器的 /etc/nginx/conf.d/default.conf 路径，以此替换了容器镜像中该路径原来的文件内容；
  • 也可以将 ConfigMap 作为一个数据卷（在挂载时不指定数据卷内子路径）挂载到容器，此时 ConfigMap 将映射成一个文件夹，每一个 KEY 是文件夹下的文件名，KEY 对应的 VALUE 是文件当中的内容。

注意事项

ConfigMap 作为 Kubernetes API 对象，以 key-value 名值对的形式存储配置信息。如前所述，这些信息可以被 Pod（容器组）以不同的方式使用：

  • 将 ConfigMap 中某个 KEY 的 VALUE 作为容器组的环境变量
  • 将 ConfigMap 中所有的名值对作为容器组的环境变量
  • 在定义容器组的 Command 时，使用 ConfigMap 中 KEY 对应的 VALUE
  • 将 ConfigMap 中的信息挂载到数据卷

限制：

  • 必须先创建 ConfigMap，才能在容器组中引用 ConfigMap。如果您引用了一个不存在的 ConfigMap，容器组将不能启动；同样的，如果您引用了 ConfigMap 中不存在的 KEY，容器组也将不能启动
  • ConfigMap 存在于名称空间当中，只有同一个名称空间下的容器组才能引用