K8S之Configmap的介绍和使用

Configmap概述

Configmap的简介

configmap是K8S中的资源对象，用于保存非机密性的配置信息，可以使用 “键-值对” （Key-Value Pair）的形式保存，也可通过文件的形式保存。

Configmap能解决的问题

在部署服务的时候，每个服务都有自己的配置文件，如果一台服务器上部署多个服务，那么这些配置都存在这个节点上，假如需要对服务器扩容，扩容之后还是需要部署多个服务并且还是要管理这些服务的配置；或者有一个服务出现问题，需要修改配置文件，每台物理节点上的配置都需要修改。
这种方式肯定满足不了线上大批量的配置变更要求。 所以，k8s中引入了Configmap资源对象，可以当成volume挂载到pod中，实现统一的配置管理。

使用Configmap：

1. 它是k8s中的资源， 相当于配置文件，可以有一个或者多个Configmap；
2. 当做成Volume，k8s pod启动之后，通过 volume 形式映射到容器内部指定目录上，容器中应用程序按照原有方式读取容器内特定目录上的配置文件。
3. 在容器看来，配置文件就像是打包在容器内部特定目录，整个过程对应用没有任何侵入。

Configmap应用场景

• K8S中引入了Configmap资源对象，可以当成volume挂载到pod中，实现统一的配置管理；
• 存在多个服务共用配置的情况，使用configmap可以友好的进行配置共享
• 使配置信息和Docker镜像解耦，实现镜像的可移植性和可复用性；

局限性

ConfigMap在设计上不适用于保存大量数据的。在ConfigMap中保存的数据不可超过1 MiB。如果需要保存超出此限制的数据，可以考虑挂载其他的存储卷或者使用独立的数据库、文件服务。

Configmap创建方法

通过命令行直接创建

直接在命令行中指定configmap参数创建，通过 –from-literal 指定参数

例如：创建一个configmap，名叫：tomcat-config。
包含2个配置信息：tomcat_port=8080，server_name=myapp.tomcat.com
命令如下：

kubectl create configmap tomcat-config --from-literal=tomcat_port=8080 --from-literal=server_name=myapp.tomcat.com
1

查看已创建的configmap（ps. configmap 可简写为 cm）

kubectl describe cm tomcat-config
1

kubectl get cm
1

2：表示里面有2个配置

通过文件创建

通过指定文件创建一个configmap，通过 –from-file=<文件> 指定文件

例如：创建一个 nginx.conf 文件，与名叫 “www-nginx” 的configmap绑定。

vim nginx.conf
1

server {
  server_name www.nginx.com;
  listen 80;
  root /home/nginx/www/
}
1
2
3
4
5

www-nginx中，定义一个key是www，值是nginx.conf中的配置内容

kubectl create configmap www-nginx1 --from-file=www=./nginx.conf
1

查看configmap

kubectl describe configmap www-nginx1
1

或者，直接已文件名“ nginx.conf ” 作为key，值是nginx.conf中的内容

kubectl create configmap www-nginx2 --from-file=./nginx.conf
1

查看configmap

kubectl describe configmap www-nginx2
1

指定目录创建

将目录下的文件分别作为配置信息
例如：
1、创建配置目录

mkdir test-mysql-config
1

cd test-mysql-config/
1

2、模拟写入第一个配置文件

vim my-server.cnf 
1

写入：server-id=1

3、模拟写入第二个配置文件

vim my-slave.cnf 
1

写入：server-id=2

4、指定目录创建configmap

kubectl create configmap mysql-config --from-file=/root/test-mysql-config/
1

查看configmap详细信息

kubectl describe cm mysql-config
1

编写Configmap资源清单Yaml文件

vim mysql-configmap.yaml 
1

apiVersion: v1
kind: ConfigMap
metadata:
  name: mysql
  labels:
    app: mysql
data:
  master.cnf: | # 文件名，用| 表示下面的配置是有多行
    [mysqld]
    log-bin
    log_bin_trust_function_creators=1
    lower_case_table_names=1
  slave.cnf: |
    [mysqld]
    super-read-only
    log_bin_trust_function_creators=1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

kubectl apply -f mysql-configmap.yaml
1

kubectl describe cm mysql
1

Configmap的使用案例

通过环境变量引入：使用configMapKeyRef

创建一个存储mysql配置的configmap

vim mysql-configmap.yaml
1

apiVersion: v1
kind: ConfigMap
metadata:
  name: mysql
  labels:
    app: mysql
data:
    log: "1"
1
2
3
4
5
6
7
8

kubectl apply -f mysql-configmap.yaml
1

kubectl get cm
1

创建pod，引用Configmap中的配置

vim mysql-pod.yaml
1

apiVersion: v1
kind: Pod
metadata:
  name: mysql-pod
spec:
  containers:
  - name: mysql
    image: busybox
    imagePullPolicy: IfNotPresent
    command: [ "/bin/sh", "-c", "sleep 3600" ]
    env:
    - name: log_bin   #定义环境变量log_bin
      valueFrom: 
        configMapKeyRef:
          name: mysql     #指定configmap的名字
          key: log # 指定configmap中的key, 将它的value赋值给环境变量log_bin
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

更新资源清单文件

kubectl apply -f mysql-pod.yaml
1

kubectl exec -it mysql-pod -c mysql -- /bin/sh
1

printenv 
1

通过环境变量引入：使用envfrom

vim mysql-pod-envfrom.yaml
1

apiVersion: v1
kind: Pod
metadata:
  name: mysql-pod-envfrom
spec:
  containers:
  - name: mysql
    image: busybox
    imagePullPolicy: IfNotPresent
    command: [ "/bin/sh", "-c", "sleep 3600" ]
    envFrom: 
    - configMapRef:
       name: mysql     #指定configmap的名字
1
2
3
4
5
6
7
8
9
10
11
12
13

更新资源清单文件

kubectl apply -f mysql-pod-envfrom.yaml
1

kubectl exec -it mysql-pod-envfrom -- /bin/sh
1

printenv
1

把configmap做成volume，挂载到pod (最常用)

vim mysql-configmap.yaml 
1

apiVersion: v1
kind: ConfigMap
metadata:
  name: mysql
  labels:
    app: mysql
data:
    log: "1"
    lower: "1"
    my.cnf: |
      [mysqld]
      Welcome=sissie
1
2
3
4
5
6
7
8
9
10
11
12

更新资源清单文件

kubectl apply -f mysql-configmap.yaml
1

kubectl get cm mysql
1

vim mysql-pod-volume.yaml
1

apiVersion: v1
kind: Pod
metadata:
  name: mysql-pod-volume
spec:
  containers:
  - name: mysql
    image: busybox
    imagePullPolicy: IfNotPresent
    command: [ "/bin/sh","-c","sleep 3600" ]
    volumeMounts:
    - name: mysql-config
      mountPath: /tmp/config
  volumes:
  - name: mysql-config
    configMap:
      name: mysql
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

更新资源清单文件

kubectl apply -f mysql-pod-volume.yaml
1

kubectl exec -it mysql-pod-volume -c mysql -- /bin/sh
1

cd /tmp/config/
1

ls
1

printenv
1

看不到以上的配置

Configmap热更新——使用挂载的 Volume

kubectl edit configmap mysql
1

把logs: “1”变成log: “2”

保存退出

kubectl exec -it mysql-pod-volume -c mysql -- /bin/sh
1

cat /tmp/config/log 
1

发现log值变成了2，更新生效了

注意：
更新 ConfigMap 后：通过环境变量注入的，使用该 ConfigMap 挂载的 Env 不会同步更新

使用该 ConfigMap 挂载的 Volume 中的数据需要一段时间（实测大概10秒）才能同步更新