Skip to main content
 首页 » DevOps

k8s中ConfigMap理解

2022年07月19日139artech

理解ConfigMap

什么是ConfigMap

首先来弄明白为什么需要ConfigMap。对于应用开发来讲,特别是后端开发。我们需要连接数据库,mysql,redis..。这些连接,我们在测试环境,生成环境用的是多套。这就意味着,我们的代码中有一些配置需要经常改动。所以ConfigMap就是解决这些问题的。

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

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

不过需要注意的是ConfigMap本身不提供加密功能。如果要存储的数据是机密的,使用Secret,或者使用其他第三方工具来保证你的数据的私密性,而不是用ConfigMap

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

ConfigMap的创建

可以使用kubectl create configmap从文件、目录或者key-value字符串创建等创建ConfigMap。也可以通过kubectl create -f file创建。

使用key-value 字符串创建

创建name和age

$ kubectl create configmap config-test-1 --from-literal=name=xiaoming  --from-literal=age=22  

查看结果

$ kubectl get configmap config-test-1 -o go-template='{{.data}}' 
map[age:22 name:xiaoming]#   

从env文件创建

创建env文件

$ echo -e "name=xiaobai\nage=25" | tee config.env 
name=xiaobai 
age=25 

写入config-test-1内容

$ kkubectl create configmap config-test-2 --from-env-file=config.env 
configmap/config-test-2 created 

查看内容

$ kubectl get configmap config-test-2 -o go-template='{{.data}}' 
map[age:25 name:xiaobai]#      

从目录创建

创建对应的目录

$ mkdir config 
$ echo 18>config/age   
$ echo xiaohua>config/name 

写入config-test-3内容

$ kubectl create configmap config-test-3 --from-file=config/ 
configmap/config-test-3 created 

查看写入的内容

$ kubectl get configmap config-test-3 -o go-template='{{.data}}' 
map[age:18 
 name:xiaohua 
]#        

通过Yaml/Json创建

apiVersion: v1 
kind: ConfigMap 
metadata: 
  name: config-test-4 
  namespace: default 
data: 
  name: xiaolong 
  age: 16year # 需要是string 

创建

$ kubectl create  -f config-test-4.yaml 
configmap/config-test-4 created 

ConfigMap使用

ConfigMap可以通过三种方式在Pod中使用,三种分别方式为:设置环境变量、设置容器命令行参数以及在Volume中直接挂载文件或目录。

需要注意的点

ConfigMap 必须在 Pod 引用它之前创建

使用 envFrom 时,将会自动忽略无效的键

Pod 只能使用同一个命名空间内的 ConfigMap

首先创建 ConfigMap:

$ kubectl create configmap special-config --from-literal=name=long --from-literal=realname=xiaolong 
$ kubectl create configmap env-config --from-literal=log_level=INFO 

用作环境变量

apiVersion: v1 
kind: Pod 
metadata: 
  name: test-pod 
spec: 
  containers: 
    - name: test-container 
      image: busybox 
      command: ["/bin/sh", "-c", "env"] 
      env: 
        - name: SPECIAL_NAME_KEY 
          valueFrom: 
            configMapKeyRef: 
              name: special-config 
              key: name 
        - name: SPECIAL_REALNAME_KEY 
          valueFrom: 
            configMapKeyRef: 
              name: special-config 
              key: realname 
      envFrom: 
        - configMapRef: 
            name: env-config 
  restartPolicy: Never 

运行之后查看日志

$ kubectl logs -f test-pod 
HOSTNAME=test-pod 
SPECIAL_NAME_KEY=long 
log_level=INFO 
SPECIAL_REALNAME_KEY=xiaolong 

发现上面的值已成功写入了

用作命令参数

ConfigMap用作命令行参数时,需要先把ConfigMap的数据保存在环境变量中,然后通过$(VAR_NAME)的方式引用环境变量。

apiVersion: v1 
kind: Pod 
metadata: 
  name: dapi-test-pod 
spec: 
  containers: 
    - name: test-container 
      image: gcr.io/google_containers/busybox 
      command: ["/bin/sh", "-c", "echo $(SPECIAL_NAME_KEY) $(SPECIAL_REALNAME_KEY)" ] 
      env: 
        - name: SPECIAL_NAME_KEY 
          valueFrom: 
            configMapKeyRef: 
              name: special-config 
              key: name 
        - name: SPECIAL_REALNAME_KEY 
          valueFrom: 
            configMapKeyRef: 
              name: special-config 
              key: realname 
  restartPolicy: Never 

运行之后打印日志

$ kubectl logs -f dapi-test-pod 
long xiaolong 

输出我们之前的写入的配置信息

使用volume将ConfigMap作为文件或目录直接挂载

将创建的ConfigMap直接挂载至 Pod 的/etc/config目录下,其中每一个key-value键值对都会生成一个文件,key为文件名,value为内容

apiVersion: v1 
kind: Pod 
metadata: 
  name: vol-test-pod 
spec: 
  containers: 
    - name: test-container 
      image: busybox 
      command: ["/bin/sh", "-c", "cat /etc/config/name"] 
      volumeMounts: 
      - name: config-volume 
        mountPath: /etc/config 
  volumes: 
    - name: config-volume 
      configMap: 
        name: special-config 
  restartPolicy: Never 

启动之后打印输出

$ kubectl logs -f vol-test-pod 
long#        

使用subpath将ConfigMap作为单独的文件挂载到目录

在一般情况下configmap挂载文件时,会先覆盖掉挂载目录,然后再将congfigmap中的内容作为文件挂载进行。如果想不对原来的文件夹下的文件造成覆盖,只是将configmap中的每个 key,按照文件的方式挂载到目录下,可以使用subpath参数。

apiVersion: v1 
kind: Pod 
metadata: 
  name: dapi-test-pod 
spec: 
  containers: 
    - name: test-container 
      image: nginx 
      command: ["/bin/sh","-c","sleep 36000"] 
      volumeMounts: 
      - name: config-volume 
        mountPath: /etc/nginx/name 
        subPath: name 
  volumes: 
    - name: config-volume 
      configMap: 
        name: special-config 
        items: 
        - key: name 
          path: name 
  restartPolicy: Never 

进入到pod中查看

root@dapi-test-pod:/etc/nginx# ls 
conf.d		mime.types  name	scgi_params 
fastcgi_params	modules     nginx.conf	uwsgi_params 

被挂载的ConfigMap内容会被自动更新

当卷中使用的ConfigMap被更新时,所投射的键最终也会被更新。kubelet组件会在每次周期性同步时检查所挂载的ConfigMap是否为最新。 不过,kubelet使用的是其本地的高速缓存来获得ConfigMap的当前值。

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

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

不可变更的ConfigMap

Kubernetes特性 不可变更的SecretConfigMap提供了一种将各个SecretConfigMap设置为不可变更的选项。对于大量使用 ConfigMap 的 集群(至少有数万个各不相同的ConfigMapPod 挂载)而言,禁止更改ConfigMap的数据有以下好处:

  • 保护应用,使之免受意外(不想要的)更新所带来的负面影响。

  • 通过大幅降低对 kube-apiserver 的压力提升集群性能,这是因为系统会关闭 对已标记为不可变更的ConfigMap的监视操作。

可以通过将immutable字段设置为true创建不可变更的ConfigMap。 例如:

apiVersion: v1 
kind: ConfigMap 
metadata: 
  ... 
data: 
  ... 
immutable: true 

一旦某ConfigMap被标记为不可变更,则 无法 逆转这一变化,,也无法更改databinaryData字段的内容。你只能删除并重建ConfigMap。 因为现有的Pod会维护一个对已删除的ConfigMap的挂载点,建议重新创建这些Pods

参考

【ConfigMap】https://kubernetes.io/zh/docs/concepts/configuration/configmap/
【ConfigMap】https://feisky.gitbooks.io/kubernetes/content/concepts/configmap.html


本文参考链接:https://www.cnblogs.com/ricklz/p/14930801.html
阅读延展