ConfigMap

    ConfigMap 用于保存配置数据的键值对,可以用来保存单个属性,也可以用来保存配置文件。ConfigMap 跟 Secret 很类似,但它可以更方便地处理不包含敏感信息的字符串。

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

    从 env 文件创建

    1. $ echo -e "a=b\nc=d" | tee config.env
    2. a=b
    3. c=d
    4. $ kubectl create configmap special-config --from-env-file=config.env
    5. configmap "special-config" created
    6. $ kubectl get configmap special-config -o go-template='{{.data}}'
    7. map[a:b c:d]
    1. $ mkdir config
    2. $ echo a>config/a
    3. $ echo b>config/b
    4. $ kubectl create configmap special-config --from-file=config/
    5. configmap "special-config" created
    6. $ kubectl get configmap special-config -o go-template='{{.data}}'
    7. map[a:a
    8. b:b
    9. ]

    从文件 Yaml/Json 文件创建

    1. apiVersion: v1
    2. kind: ConfigMap
    3. metadata:
    4. name: special-config
    5. namespace: default
    6. data:
    7. special.how: very
    8. special.type: charm
    1. $ kubectl create -f config.yaml
    2. configmap "special-config" created

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

    1. $ kubectl create configmap special-config --from-literal=special.how=very --from-literal=special.type=charm
    2. $ kubectl create configmap env-config --from-literal=log_level=INFO

    当 Pod 结束后会输出

    1. SPECIAL_LEVEL_KEY=very
    2. SPECIAL_TYPE_KEY=charm
    3. log_level=INFO

    用作命令行参数

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

    1. apiVersion: v1
    2. kind: Pod
    3. metadata:
    4. name: dapi-test-pod
    5. containers:
    6. - name: test-container
    7. image: gcr.io/google_containers/busybox
    8. command: ["/bin/sh", "-c", "echo $(SPECIAL_LEVEL_KEY) $(SPECIAL_TYPE_KEY)" ]
    9. env:
    10. - name: SPECIAL_LEVEL_KEY
    11. configMapKeyRef:
    12. name: special-config
    13. key: special.how
    14. - name: SPECIAL_TYPE_KEY
    15. valueFrom:
    16. configMapKeyRef:
    17. name: special-config
    18. key: special.type
    19. restartPolicy: Never

    当 Pod 结束后会输出

    1. very charm

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

    1. apiVersion: v1
    2. kind: Pod
    3. metadata:
    4. name: vol-test-pod
    5. spec:
    6. containers:
    7. - name: test-container
    8. image: gcr.io/google_containers/busybox
    9. command: ["/bin/sh", "-c", "cat /etc/config/special.how"]
    10. volumeMounts:
    11. - name: config-volume
    12. mountPath: /etc/config
    13. volumes:
    14. - name: config-volume
    15. configMap:
    16. name: special-config
    17. restartPolicy: Never
    1. very

    将创建的 ConfigMap 中 special.how 这个 key 挂载到 / etc/config 目录下的一个相对路径 / keys/special.level。如果存在同名文件,直接覆盖。其他的 key 不挂载

    当 Pod 结束后会输出

    1. very

    ConfigMap 支持同一个目录下挂载多个 key 和多个目录。例如下面将 special.how 和 special.type 通过挂载到 / etc/config 下。并且还将 special.how 同时挂载到 / etc/config2 下。

    1. apiVersion: v1
    2. kind: Pod
    3. metadata:
    4. name: dapi-test-pod
    5. spec:
    6. containers:
    7. - name: test-container
    8. image: gcr.io/google_containers/busybox
    9. command: ["/bin/sh","-c","sleep 36000"]
    10. volumeMounts:
    11. - name: config-volume
    12. mountPath: /etc/config
    13. - name: config-volume2
    14. volumes:
    15. - name: config-volume
    16. name: special-config
    17. items:
    18. - key: special.how
    19. path: keys/special.level
    20. - key: special.type
    21. path: keys/special.type
    22. - name: config-volume2
    23. configMap:
    24. name: special-config
    25. items:
    26. - key: special.how
    27. path: keys/special.level
    28. restartPolicy: Never
    1. # ls /etc/config/keys/
    2. special.level special.type
    3. # ls /etc/config2/keys/
    4. special.level
    5. # cat /etc/config/keys/special.level
    6. very
    7. # cat /etc/config/keys/special.type
    8. charm

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

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

    1. apiVersion: v1
    2. kind: Pod
    3. metadata:
    4. name: dapi-test-pod
    5. spec:
    6. containers:
    7. - name: test-container
    8. image: nginx
    9. command: ["/bin/sh","-c","sleep 36000"]
    10. volumeMounts:
    11. - name: config-volume
    12. mountPath: /etc/nginx/special.how
    13. subPath: special.how
    14. volumes:
    15. - name: config-volume
    16. configMap:
    17. name: special-config
    18. items:
    19. - key: special.how
    20. path: special.how
    21. restartPolicy: Never
    1. root@dapi-test-pod:/# ls /etc/nginx/
    2. conf.d fastcgi_params koi-utf koi-win mime.types modules nginx.conf scgi_params special.how uwsgi_params win-utf
    3. root@dapi-test-pod:/# cat /etc/nginx/special.how