ConfigMap 是一种 Kubernetes API 对象,用来将非机密性的数据保存到键值对中。
使用时, Pods 可以将其用作环境变量、命令行参数或者存储卷中的配置文件。

ConfigMap 可以将您的环境配置信息和 容器镜像 解耦,便于应用配置的修改。

Ps: ConfigMap 并不提供保密或者加密功能。 如果你想存储的数据是机密的,请使用 Secret, 或者使用其他第三方工具来保证你的数据的私密性。

为什么需要 ConfigMap ?

使用 ConfigMap 可以将你的配置数据和应用程序代码分开。

比如,假设你正在开发一个应用,它可以在你自己的电脑上(用于开发)和在云上 (用于实际流量)运行。
你的代码里有一段是用于查看环境变量 DATABASE_HOST,在本地运行时, 你将这个变量设置为 localhost;
在云上,你将其设置为引用 Kubernetes 集群中的公开数据库组件的服务名称。

这让你可以获取在云中运行的容器镜像,并且如果有需要的话,在本地调试完全相同的代码。

ConfigMap 在设计上不是用来保存大量数据的。
在 ConfigMap 中保存的数据不可超过 1 MiB。
如果你需要保存超出此尺寸限制的数据,你可能希望考虑挂载存储卷 或者使用独立的数据库或者文件服务。

ConfigMap 对象

ConfigMap 是一个 API 对象, 让你可以存储其他对象所需要使用的配置。
和其他 Kubernetes 对象都有一个 spec 不同的是,ConfigMap 使用 data 和 binaryData 字段。
这些字段能够接收键-值对作为其取值。

data 和 binaryData 字段都是可选的。
data 字段设计用来保存 UTF-8 字节序列,而 binaryData 则 被设计用来保存二进制数据作为 base64 编码的字串。

ConfigMap 的名字必须是一个合法的 DNS 子域名,即满足如下规则:

  • 最多63个字符
  • 只能包含小写字母、数字,以及’-‘
  • 须以字母数字开头
  • 须以字母数字结尾

data 或 binaryData 字段下面的每个键的名称都必须由字母数字字符或者 -、_ 或 . 组成。
data 下保存的键名不可以与 binaryData 下出现的键名有重叠。

ConfigMaps 和 Pods

你可以写一个引用 ConfigMap 的 Pod 的 spec,并根据 ConfigMap 中的数据在该 Pod 中配置容器。
其中,这个 Pod 和 ConfigMap 必须要在同一个名字空间中。

下面是一个 ConfigMap 的示例,它的一些键只对应一个值,其他键的值看起来像是对应一个配置文件。

  1. apiVersion: v1
  2. kind: ConfigMap
  3. metadata:
  4. name: game-demo
  5. data:
  6. # 类属性键;每一个键都映射到一个简单的值
  7. player_initial_lives: "3"
  8. ui_properties_file_name: "user-interface.properties"
  9. # 类文件键
  10. game.properties: |
  11. enemy.types=aliens,monsters
  12. player.maximum-lives=5
  13. user-interface.properties: |
  14. color.good=purple
  15. color.bad=yellow
  16. allow.textmode=true

你可以使用四种方式来使用 ConfigMap 配置 Pod 中的容器:

  • 在容器命令和参数内
  • 容器的环境变量
  • 在只读卷里面添加一个文件,让应用来读取
  • 编写代码在 Pod 中运行,使用 Kubernetes API 来读取 ConfigMap

这些不同的方法适用于不同的数据使用方式。
对前三个方法,kubelet 使用 ConfigMap 中的数据在 Pod 中启动容器。

第四种方法意味着你必须编写代码才能读取 ConfigMap 和它的数据。
然而, 由于你是直接使用 Kubernetes API,因此只要 ConfigMap 发生更改,你的应用就能够通过订阅来获取更新,并且在这样的情况发生的时候做出反应。
通过直接访问 Kubernetes API,这个技术也可以让你能够获取到不同的名字空间里的 ConfigMap。

下面是一个 Pod 的示例,它通过使用 game-demo 中的值来配置一个 Pod:

  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: configmap-demo-pod
  5. spec:
  6. containers:
  7. - name: demo
  8. image: alpine
  9. command: ["sleep", "3600"]
  10. env:
  11. # 定义环境变量
  12. - name: PLAYER_INITIAL_LIVES # 请注意这里和 ConfigMap 中的键名是不一样的
  13. valueFrom:
  14. configMapKeyRef:
  15. name: game-demo # 这个值来自 ConfigMap
  16. key: player_initial_lives # 需要取值的键
  17. - name: UI_PROPERTIES_FILE_NAME
  18. valueFrom:
  19. configMapKeyRef:
  20. name: game-demo
  21. key: ui_properties_file_name
  22. volumeMounts:
  23. - name: config
  24. mountPath: "/config"
  25. readOnly: true
  26. volumes:
  27. # 你可以在 Pod 级别设置卷,然后将其挂载到 Pod 内的容器中
  28. - name: config
  29. configMap:
  30. # 提供你想要挂载的 ConfigMap 的名字
  31. name: game-demo
  32. # 来自 ConfigMap 的一组键,将被创建为文件
  33. items:
  34. - key: "game.properties"
  35. path: "game.properties"
  36. - key: "user-interface.properties"
  37. path: "user-interface.properties"

ConfigMap 不会区分单行属性值和多行类似文件的值,重要的是 Pods 和其他对象如何使用这些值。

上面的例子定义了一个卷并将它作为 /config 文件夹挂载到 demo 容器内。
创建两个文件,/config/game.properties/config/user-interface.properties

因为 Pod 定义中在 volumes 节指定了一个 items 数组。
如果你完全省略 items 数组,则 ConfigMap 中的每个键都会变成一个与该键同名的文件,因此你会得到四个文件。

使用 ConfigMap

ConfigMap 可以作为数据卷挂载。
ConfigMap 也可被系统的其他组件使用,而不一定直接暴露给 Pod。
例如,ConfigMap 可以保存系统中其他组件要使用的配置数据。

ConfigMap 最常见的用法是为同一命名空间里某 Pod 中运行的容器执行配置。你也可以单独使用 ConfigMap。

比如,你可能会遇到基于 ConfigMap 来调整其行为的插件或者 operator。

下面,我们来看一下如何在 Pod 中将 ConfigMap 访问文件来使用:

  1. 创建一个 ConfigMap 对象或者使用现有的 ConfigMap 对象,多个 Pod 可以引用同一个 ConfigMap。
  2. 修改 Pod 定义,在 spec.volumes[] 下添加一个卷。 为该卷设置任意名称,之后将 spec.volumes[].configMap.name 字段设置为对 你的 ConfigMap 对象的引用。
  3. 为每个需要该 ConfigMap 的容器添加一个 .spec.containers[].volumeMounts[]。 设置 .spec.containers[].volumeMounts[].readOnly=true 并将 .spec.containers[].volumeMounts[].mountPath 设置为一个未使用的目录名,ConfigMap 的内容将出现在该目录中。
  4. 更改你的镜像或者命令行,以便程序能够从该目录中查找文件,ConfigMap 中的每个 data 键会变成 mountPath 下面的一个文件名。

下面是一个将 ConfigMap 以卷的形式进行挂载的 Pod 示例:

  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: mypod
  5. spec:
  6. containers:
  7. - name: mypod
  8. image: redis
  9. volumeMounts:
  10. - name: foo
  11. mountPath: "/etc/foo"
  12. readOnly: true
  13. volumes:
  14. - name: foo
  15. configMap:
  16. name: myconfigmap

其中,你希望使用的每个 ConfigMap 都需要在 spec.volumes 中被引用到。

如果 Pod 中有多个容器,则每个容器都需要自己的 volumeMounts 块,
但针对每个 ConfigMap,你只需要设置一个 spec.volumes 块。

当卷中使用的 ConfigMap 被更新时,所投射的键最终也会被更新。
kubelet 组件会在每次周期性同步时检查所挂载的 ConfigMap 是否为最新。
kubelet 使用的是其本地的高速缓存来获得 ConfigMap 的当前值。
高速缓存的类型可以通过 KubeletConfiguration 结构 的 ConfigMapAndSecretChangeDetectionStrategy 字段来配置。

ConfigMap 既可以通过 watch 操作实现内容传播(默认形式),也可实现基于 TTL 的缓存,还可以直接经过所有请求重定向到 API 服务器。
因此,从 ConfigMap 被更新的那一刻算起,到新的主键被投射到 Pod 中去,这一时间跨度可能与 kubelet 的同步周期加上高速缓存的传播延迟相等。
这里的传播延迟取决于所选的高速缓存类型 (分别对应 watch 操作的传播延迟、高速缓存的 TTL 时长或者 0)。

Ps: 以环境变量方式使用的 ConfigMap 数据不会被自动更新。 更新这些数据需要重新启动 Pod。