Configmap-K8s容器的配置文件

传递配置给容器化应用程序有几种方式：

嵌入应用本身；
通过命令行传递参数；
通过环境变量传递参数；

在k8s中无论你有没有使用configmap，以下方法均可以配置应用程序：

向容器传递命令行参数：command、args；
为每个容器设置自定义环境变量；
通过特殊类型的卷将配置文件挂载到容器中，如：gitrepo；

ConfigMap的主要作用:

就是为了让镜像和配置文件解耦，以便实现镜像的可移植性和可复用性，因为一个configMap其实就是一系列配置信息的集合，将来可直接注入到Pod中的容器使用；

ConfigMap本质上就是一个键值对，值可以是定义的具体值，也可以是完整的配置文件；

应用无需读取Configmap，映射的内容是通过env或者volume的形式传递给容器，而不是直接传递给容器；

创建Configmap

命令创建简单的configmap

kubectl create configmap my-config --from-literal=key1=config1

--from-literal是命令的参数，后面的才是配置的key-value；

多个参数：

kubectl create configmap my-config --from-literal=key1=config1 --from-literal=key2=config2

从字面量创建参数，也可以从文件，文件夹等创建configmap，可以通过命令：kubectl create configmap -h 查看；

yaml文件创建

configmap的yaml文件比较简单，data下面就是一个一个的条目；

关于|管道符的含义，点击此处

apiVersion: v1

kind: ConfigMap

metadata:

  name: test-cfg

  namespace: default

data:

  cache_host: memcached-gcxt

  cache_port: "11211"

  cache_prefix: gcxt

  my.cnf: |

    [mysqld]

    log-bin = mysql-bin

  app.properties: |

    property.1 = value-1

 property.2 = value-2

 property.3 = value-3

使用Configmap

将configmap中的值传递给容器有三种方式；

1. 容器的环境变量

环境变量命名不可以使用"-"

apiVersion: v1

kind: ConfigMap

metadata:

  name: fortune-config

data:

  sleep-interval: "25"

注入容器：

spec:

  containers:

  - image: luksa/fortune:env

    env:

    - name: INTERVAL

      valueFrom:

        configMapKeyRef:

          name: fortune-config

          key: sleep-interval

Pod运行后，容器内的INTERVAL环境变量值就是25；

2. 作为命令行参数

pod.spec.containers.args无法直接引用ConfigMap entries(条目)，可以利用configmap先初始化某个环境变量，再在参数字段中引用；

spec:

  containers:

  - image: luksa/fortune:env

    env:

    - name: INTERVAL

      valueFrom:

        configMapKeyRef:

          name: fortune-config

          key: sleep-interval

   # ！！！

   args: ["$(INTERVAL)"]

3. 将configmap条目暴露为文件

Env和命令行参数传值仅适用于变量值较短的场景，但configmap中可以包含完整的配置文件，如下所示，可以借助于configmap volume；

a.json

server {

    listen              80;

    server_name         www.kubia-example.com;

    gzip on;

    gzip_types text/plain application/xml;

    location / {

        root   /usr/share/nginx/html;

        index  index.html index.htm;

    }

}

用命令创建configmap：

kubectl create configmap fortune-config --from-file=a.json --from-literal=sleep-interval=25

configmap demo

apiVersion: v1

data:

  a.json: |

    server {

        listen              80;

        server_name         www.kubia-example.com;

        gzip on;

        gzip_types text/plain application/xml;

        location / {

            root   /usr/share/nginx/html;

            index  index.html index.htm;

        }

    }

  sleep-interval: "25"

kind: ConfigMap

关于此处|管道符的含义，点击这里

Usag：使用configMap volume挂载到容器的/etc/nginx/conf.d文件夹下，configmap里的每个条目会自动转换为该文件夹下的文件；

对于这个demo文件夹下有两个文件：a .json、sleep-interval

apiVersion: v1

kind: Pod

metadata:

  name: fortune-configmap-volume

spec:

  containers:

  - image: nginx:alpine

    name: web-server

    volumeMounts:

    - name: config

      mountPath: /etc/nginx/conf.d

      readOnly: true

  volumes:

  - name: config

    configMap:

      name: fortune-config

这种方式的问题时：如果这个容器只需要条目1，但这样会所有条目都暴露出来，存在安全隐患；所以应该只暴露容器需要的条目；

还是针对上面的configmap fortune-config，使用volume的items属性：

apiVersion: v1

kind: Pod

metadata:

  name: fortune-configmap-volume

spec:

  containers:

  - image: nginx:alpine

    name: web-server

    volumeMounts:

    - name: config

      mountPath: /etc/nginx/conf.d

      readOnly: true

  volumes:

  - name: config

    configMap:

      name: fortune-config

      items:              # 使用iterms属性

      - key: a.json				# configmap条目的key

        path: gzip.conf   # 条目的value被存在gzip.conf文件中

此时/etc/nginx/conf.d文件夹下仅有gzip.conf这个文件，内容是a .json；对于没有加入到items的其他条目，你可以环境变量，或者命令行参数继续引入；

configmap独立条目作为文件被挂载且不覆盖容器内原有文件夹里的原内容：

spec:

    containers:

    - name: php

      image: php:7.0-apache

      volumeMounts:

      - mountPath: /var/www/html/index.php

        name: index

        subPath: indexaaa.php     #

    volumes:

    - name: index

      configMap:

        name: php-index

        items:                    # 不用items也可以用subpath

        - key: index.php

          path: indexaaa.php      # configmap中的目录index.php对应的值给了相对路径 indexaaa.php，所以上面的subpath要用 相对路径indexaaa.php

不用items也可以用subpath，只要是挂载文件或者文件夹到容器里的已经存在的目录下就可以用subpath不对原有的造成影响。

设置挂载的配置文件权限

apiVersion: v1

kind: Pod

metadata:

  name: fortune-configmap-volume

spec:

  containers:

  - image: luksa/fortune:env

    env:

    - name: INTERVAL

      valueFrom:

        configMapKeyRef:

          name: fortune-config

          key: sleep-interval

    name: html-generator

    volumeMounts:

    - name: html

      mountPath: /var/htdocs

  - image: nginx:alpine

    name: web-server

    volumeMounts:

    - name: html

      mountPath: /usr/share/nginx/html

      readOnly: true

    - name: config                    #

      mountPath: /etc/nginx/conf.d

      readOnly: true

    - name: config

      mountPath: /tmp/whole-fortune-config-volume

      readOnly: true

  volumes:

  - name: html

    emptyDir: {}

  - name: config                     #

    configMap:

      name: fortune-config

      defaultMode: 0660              # rw- rw- ---

四位权限，一般只考虑后三位；详细了解：https://blog.csdn.net/qq_33472414/article/details/92803165?utm_medium=distribute.pc_aggpage_search_result.none-task-blog-2_allsobaiduend~default-1-92803165.nonecase&utm_term=linux%E6%9D%83%E9%99%90%E6%95%B0%E5%AD%97%E8%A1%A8%E7%A4%BA4%E4%BD%8D&spm=1000.2123.3001.4430

在Pod中引用不存在的Configmap

创建Pod时，configmap不存在，引用了不存在的configmap的容器会启动失败，其他容器能正常启动；

可以标记Configmap引用是可选的：configMapKeyRef.optional: true；即便该configmap引用不存在也可以正常启动容器；

Configmap热更新

Configmap热更新效果是：更新configmap只用，注入到容器内部的配置变动；但热更新是有前提的：

注入环境变量，或者通过subPath挂载的文件都不能动态更新，只有通过目录挂载的configmap才具有热更新功能；

Configmap热更新原理 https://github.com/QingyaFan/container-cloud/issues/2

巴特西