Configmap

Configmap

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

  1. 嵌入应用本身;
  2. 通过命令行传递参数;
  3. 通过环境变量传递参数;

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

  1. 向容器传递命令行参数:command、args;
  2. 为每个容器设置自定义环境变量;
  3. 通过特殊类型的卷将配置文件挂载到容器中,如: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-2allsobaiduend~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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值