文章目录

  • 一、什么是ConfigMap?
  • 二、应用场景定义
  • 三、如何创建一个ConfigMap
  • 四、如何使用一个ConfigMap
  • 五、实战-from-literal
  • 六、实战-from-file


一、什么是ConfigMap?

ConfigMap(简称CM)允许你把配置文件从image镜像本地中解耦出来,来保持集装箱化应用的便携性。
ConfigMap可以通过监听在配置文件、命令行参数、环境变量等其他配置的架构中,然后在你的pod容器和系统组件运行时,达到配置的加载功能。
同时ConfigMap也建议将那些,可以使得你更好的进行变更和管理配置文件的配置,从pod和系统组件中剥离出来。

ConfigMap存储配置信息是很有用的,由于它是非加密性的配置,我强烈建议大家只保存非敏感的配置信息。

二、应用场景定义

正如上面所说,ConfigMap是非加密性的配置保存,你应该牢记,切勿在ConfigMap中保存敏感信息;
如果你需要保存敏感信息,建议使用Secret。

三、如何创建一个ConfigMap

和其他基础对象、控制器类似,你也可以通过两种方式来申明一个ConfigMap:

1、命令行方式:

kubectl create configmap [NAME] [DATA]:

例如:kubectl create cm filebeat-cfg -n config --from-literal=redis_host="redis.test.com" --from-literal=log_level=“info”

你需要注意的是,通过命令行申明的方式,内部也细分了两种:

从字面读取(–from-literal)和从目录(–from-file)读取,下面我将给你讲解他们是如何使用的。

  1. –from-literal

从字面读取的好处就是快速和便捷,你可以通过关键字参数的形式(**kargs),将配置信息直接传递至configmap,然后在pod启动的时候进行加载;
同时这个方式的弊端就是,变量的更新是做不到的,毕竟环境变量的加载只有在容器运行时才起作用。

kubectl create cm filebeat-cfg -n config --from-literal=redis_host="redis.test.com" --from-literal=log_level=“info”

其中,redis_host是变量名,redis.test.com就是我们定义的变量值了,是不是一目了然了呢?
  1. –from-file

从目录读取的好处就是,允许你更好的进行配置文件的管理。
你可以想象成传统架构下,我们是如何管理nginx的vhost的,又比如,在prometheus中,对于File SD(基于文件的服务发现)的使用,其实和此处都是一个道理。

kubectl create configmap nginx-cfg -n config --from-file=/root/mainfasts/conf.d/

--from-file指明需要从那个目录下面读取,目录下的文件只要按照一定格式就可以成功被加载到了。

你需要注意的是:

通过目录加载ConfigMap,其变量名是文件名,变量值是文件内容!!!

2、yaml配置文件方式:

当然,你也可以通过yaml的方式,像申明其他资源一样,去申明一个ConfigMap,这并没有什么不同,只要注意它的配置字段就好了。
你可以通过下面命令找到ConfigMap的配置字段信息:

kubectl explain configmap

我这里给了一个ingress的ConfigMap的参考配置文件:configmap-demo.yaml

apiVersion: v1
kind: ConfigMap
metadata:
  annotations:
    kubectl.kubernetes.io/last-applied-configuration: |
      {"apiVersion":"v1","kind":"ConfigMap","metadata":{"annotations":{},"labels":{"app.kubernetes.io/name":"ingress-nginx","app.kubernetes.io/part-of":"ingress-nginx"},"name":"nginx-configuration","namespace":"ingress-nginx"}}
  creationTimestamp: "2019-12-05T07:10:54Z"
  labels:
    app.kubernetes.io/name: ingress-nginx
    app.kubernetes.io/part-of: ingress-nginx
  name: nginx-configuration
  namespace: ingress-nginx
  resourceVersion: "7097"
  selfLink: /api/v1/namespaces/ingress-nginx/configmaps/nginx-configuration
  uid: d9646c79-7c33-4afd-b3cc-03da176f6b53

四、如何使用一个ConfigMap

前面,我讲了很多都是如何去创建、申明一个ConfigMap,那创建好的配置,我们如何去使用呢?
接下来,我将为大家简单讲解,如何使用!最后会有更详细的实战环节。
1、–from-literal

如果你使用此方法进行申明,那你就得使用环境变量的方式,让容器读取到配置:

apiVersion: v1
kind: Pod
spec:
 containers:
 - name: nginx
   image: nginx
   env:
   -  name: nginx_host                
      valueFrom:
        configMapKeyRef:                 #从configmap中读取
          key: redis_host                #上面我们定义的变量名

具体字段配置,请查阅:

kubectl explain pod.spec.containers.env.name.valueFrom.configMapKeyRef

2、–from-file

通过目录的方式进行配置加载,你还需要配合使用volume进行配置的读取,具体如下所示

apiVersion: v1
kind: Pod
spec:
  containers:
  - name: nginx
    image: nginx
    volumeMounts:
    - name: nginx-conf                 #自定义volumes的名字,这里是引用
      mountPath: /etc/nginx/conf.d/    #挂载到Pod中的路径
  volumes:
  - name: nginx-conf                 #自定义volumes的名字,这里是定义
    configMap:
      defaultMode: 0644
      name: nginx-cfg                 #configMap名
      items:
      - key: server1.conf                   #configMap中的变量名
        path: server1_new.conf                #期望以什么名字保存在Pod目录中

具体字段配置,请查阅:

kubectl explain pod.spec.volumes.configMap

五、实战-from-literal

再次提醒:此方式的环境变量,Pod生命周期内的配置变更是不会热加载的。

1、首先我们在config的namespace中,创建一个名为filebeat-cfg的configmap用于测试,具体如下

kubectl create cm filebeat-cfg -n config --from-literal=redis_host="redis.test.com" --from-literal=log_level=“info”

2、然后,检查CM(configmap简称)配置情况,是否被成功读取

[root@centos-1 dingqishi]# kubectl get cm filebeat-cfg -n config -o yaml
apiVersion: v1
data:
  log_level: info
  redis_host: redis.test.com
kind: ConfigMap
metadata:
  creationTimestamp: "2019-12-04T08:17:32Z"
  name: filebeat-cfg
  namespace: config
  resourceVersion: "70462"
  selfLink: /api/v1/namespaces/config/configmaps/filebeat-cfg
  uid: 2cc00197-60b6-4850-9c24-ef4f385ae058

3、编辑nginx-cmcmd.yaml,并使用valueFrom的方式来加载我们的配置变量

apiVersion: v1
kind: Pod
metadata:
 name: nginx
 namespace: config
spec:
 containers:
 - name: nginx
   image: nginx
   env:
   -  name: nginx_host
      valueFrom:
        configMapKeyRef:                 #从configmap中读取
          key: redis_host
          name: filebeat-cfg
   -  name: nginx_log_level
      valueFrom:
        configMapKeyRef:
          key: log_level
          name: filebeat-cfg
   -  name: nginx_static_value            #静态配置
      value: "123123"

4、最后apply -f启动Pod,并检查变量加载情况,发现已经能成功加载到变量了(nginx_host、nginx_log_level和nginx_static_value)

[root@centos-1 mainfasts]# kubectl exec -it nginx -n config -- /bin/sh
# printenv
KUBERNETES_PORT=tcp://10.96.0.1:443
KUBERNETES_SERVICE_PORT=443
nginx_host=redis.test.com
nginx_log_level=info
HOSTNAME=nginx
HOME=/root
PKG_RELEASE=1~buster
TERM=xterm
KUBERNETES_PORT_443_TCP_ADDR=10.96.0.1
NGINX_VERSION=1.17.6
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
nginx_static_value=123123
KUBERNETES_PORT_443_TCP_PORT=443
NJS_VERSION=0.3.7
KUBERNETES_PORT_443_TCP_PROTO=tcp
KUBERNETES_PORT_443_TCP=tcp://10.96.0.1:443
KUBERNETES_SERVICE_PORT_HTTPS=443
KUBERNETES_SERVICE_HOST=10.96.0.1
PWD=/

5、接着,我们尝试修改变量值,看一下pod生命周期内,是否真的不会被读取到呢?
编辑(edit)配置文件,修改对应变量(redis_host: www.baidu.com)。

[root@centos-1 dingqishi]# kubectl edit cm filebeat-cfg -n config -o yaml
[root@centos-1 dingqishi]# kubectl get cm filebeat-cfg -n config -o yaml
apiVersion: v1
data:
  log_level: warning
  redis_host: www.baidu.com
kind: ConfigMap
metadata:
  creationTimestamp: "2019-12-04T08:17:32Z"
  name: filebeat-cfg
  namespace: config
  resourceVersion: "76435"
  selfLink: /api/v1/namespaces/config/configmaps/filebeat-cfg
  uid: 2cc00197-60b6-4850-9c24-ef4f385ae058

6、继续观察Pod内变量,发现真的没有改变,和我们预期一致,测试成功!

# printenv
KUBERNETES_PORT=tcp://10.96.0.1:443
KUBERNETES_SERVICE_PORT=443
nginx_host=redis.test.com
nginx_log_level=info
HOSTNAME=nginx
HOME=/root
PKG_RELEASE=1~buster
TERM=xterm
KUBERNETES_PORT_443_TCP_ADDR=10.96.0.1
NGINX_VERSION=1.17.6
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
nginx_static_value=123123
KUBERNETES_PORT_443_TCP_PORT=443
NJS_VERSION=0.3.7
KUBERNETES_PORT_443_TCP_PROTO=tcp
KUBERNETES_PORT_443_TCP=tcp://10.96.0.1:443
KUBERNETES_SERVICE_PORT_HTTPS=443
KUBERNETES_SERVICE_HOST=10.96.0.1
PWD=/

7、删除Pod,重新apply,发现配置才会更新!

[root@centos-1 mainfasts]# kubectl delete -f pod-cfg.yaml 
pod "nginx" deleted
[root@centos-1 mainfasts]# kubectl apply -f pod-cfg.yaml 
pod/nginx created

[root@centos-1 mainfasts]# kubectl exec -it nginx -n config -- /bin/sh
# printenv
KUBERNETES_SERVICE_PORT=443
KUBERNETES_PORT=tcp://10.96.0.1:443
nginx_host=www.baidu.com
nginx_log_level=warning
HOSTNAME=nginx
HOME=/root
PKG_RELEASE=1~buster
TERM=xterm
KUBERNETES_PORT_443_TCP_ADDR=10.96.0.1
NGINX_VERSION=1.17.6
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
nginx_static_value=123123

8、结论:

环境变量只会在Pod生成时加载,修改configMap,并不会被热加载到Pod中,需要重新生成Pod才行

9、如何解决Pod中配置热加载的问题呢?请看下面的例子,这时候就需要用–from-file了!

六、实战-from-file

1、首先我们先准备好所需的文件和目录:创建nginx所需目录和虚拟主机配置

[root@centos-1 conf.d]# pwd
/root/mainfasts/conf.d

[root@centos-1 conf.d]# cat server1.conf 
server {
    listen       80;
    server_name  www.baidu.com;

    location / {
        root   /server1.html;
        index  index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

[root@centos-1 conf.d]# cat server2.conf 
server {
    listen       80;
    server_name  www.nginx.com;

    location / {
        root   /server2.html;
        index  index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

2、然后,以–from-file的形式导入至configmap

kubectl create configmap nginx-cfg -n config --from-file=/root/mainfasts/conf.d/

3、为了养成一个好习惯,检查configmap配置载入情况还是很有必要的。

你有没有发现:

文件名成了变量名,文件内容成了变量值,他们以|进行分割
[root@centos-1 conf.d]# kubectl get cm -n config -o yaml
apiVersion: v1
items:
- apiVersion: v1
  data:
    log_level: warning
    redis_host: www.baidu.com
  kind: ConfigMap
  metadata:
    creationTimestamp: "2019-12-04T08:17:32Z"
    name: filebeat-cfg
    namespace: config
    resourceVersion: "76435"
    selfLink: /api/v1/namespaces/config/configmaps/filebeat-cfg
    uid: 2cc00197-60b6-4850-9c24-ef4f385ae058
- apiVersion: v1
  data:
    server1.conf: |
      server {
          listen       80;
          server_name  www.baidu.com;

          location / {
              root   /server1.html;
              index  index.html index.htm;
          }

          error_page   500 502 503 504  /50x.html;
          location = /50x.html {
              root   /usr/share/nginx/html;
          }
      }
    server2.conf: |
      server {
          listen       80;
          server_name  www.nginx.com;

          location / {
              root   /server2.html;
              index  index.html index.htm;
          }

          error_page   500 502 503 504  /50x.html;
          location = /50x.html {
              root   /usr/share/nginx/html;
          }
      }
  kind: ConfigMap
  metadata:
    creationTimestamp: "2019-12-04T10:11:23Z"
    name: nginx-cfg
    namespace: config
    resourceVersion: "81456"
    selfLink: /api/v1/namespaces/config/configmaps/nginx-cfg
    uid: 86374cc1-605c-4b4a-abfa-769df0a4a94d
kind: List
metadata:
  resourceVersion: ""
  selfLink: ""

4、这里使用volumeMounts的方式,将configMap的资源挂载到pod内,编辑nginx-cmfiles-volumes.yaml

apiVersion: v1
kind: Pod
metadata:
  name: nginx
  namespace: config
spec:
  containers:
  - name: nginx
    image: nginx
    volumeMounts:
    - name: nginx-conf               #自定义volumes的名字
      mountPath: /etc/nginx/conf.d/    #挂载到Pod中的路径
  volumes:
  - name: nginx-conf                 #自定义volumes的名字
    configMap:
      defaultMode: 0644
      name: nginx-cfg                 #configMap名
      items:
      - key: server1.conf                   #configMap中的变量名
        path: server1_new.conf                #期望以什么名字保存在Pod目录中
      - key: server2.conf
        path: server2_new.conf

5、apply -f配置文件,并进入Pod查看配置读取和挂载情况,是不是很神奇!
配置文件已经通过configmap的方式形成了。

[root@centos-1 mainfasts]# kubectl exec -it  nginx -n config -- /bin/sh
# cd /etc/nginx/conf.d
# ls
server1_new.conf  server2_new.conf
# cat server1_new.conf
server {
    listen       80;
    server_name  www.baidu.com;

    location / {
        root   /server1.html;
        index  index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}
# cat server2_new.conf
server {
    listen       80;
    server_name  www.nginx.com;

    location / {
        root   /server2.html;
        index  index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

6、这里我们还是要来测试一下热更新的问题。
修改configmap参数(分别将server_name修改成taobao和jingdong)

[root@centos-1 conf.d]# kubectl get cm nginx-cfg -n config -o yaml
apiVersion: v1
data:
  server1.conf: |
    server {
        listen       80;
        server_name  www.taobao.com;

        location / {
            root   /server1.html;
            index  index.html index.htm;
        }

        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   /usr/share/nginx/html;
        }
    }
  server2.conf: |
    server {
        listen       80;
        server_name  www.jingdong.com;

        location / {
            root   /server2.html;
            index  index.html index.htm;
        }

        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   /usr/share/nginx/html;
        }
    }
kind: ConfigMap
metadata:
  creationTimestamp: "2019-12-04T10:11:23Z"
  name: nginx-cfg
  namespace: config
  resourceVersion: "87316"
  selfLink: /api/v1/namespaces/config/configmaps/nginx-cfg
  uid: 86374cc1-605c-4b4a-abfa-769df0a4a94d

7、几秒后Pod的配置文件也自动的进行了热更新

# cat server1_new.conf
server {
    listen       80;
    server_name  www.taobao.com;

    location / {
        root   /server1.html;
        index  index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}
# cat server2_new.conf
server {
    listen       80;
    server_name  www.jingdong.com;

    location / {
        root   /server2.html;
        index  index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}