ConfigMap描述
ConfigMap功能在k8s1.2版本中引入,许多应用程序会从配置文件、命令行参数或环境变量中读取配置信息。ConfigMap API给我们提供了向容器中注入配置信息的机制,ConfigMap可以被用来保存单个属性,也可以用来保存整个配置文件或JSON二进制大对象
ConfigMap的创建
1 使用目录创建
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
| $ mkdir configmap
$cat configmap/game.properties enemies=aliens lives=3 enemies.cheat=true enemies.cheat.level=noGoodRotten secret.code.passphrase=UUDDLRLRBABAS secret.code.allowed=true secret.code.lives=30
$ cat config/ui.properties color.good=purple color.bad=yellow allow.textmode=true how.nice.to.look=fairlyNice
$ kubectl create configmap game-config --from-file=configmap/
# 查看ConfigMap kubectl get cm # 查看具体信息 kubectl get cm game-config -o yaml kubecctl describe cm game-config
|
--from-file
指定在目录下的所有文件都会被用在ConfigMap里面创建一个键值对,其中:
2 使用文件创建
只要指定为一个文件就可以从单个文件中创建ConfigMap
1 2 3
| $ kubectl create configmap game-config-2 --from-file=configmap/game.properties
$ kubectl get configmaps game-config-2 -o yaml
|
--from-file
这个参数可以使用多次,可以使用两次分别指定上个实例中的那两个配置文件,效果就跟指定整个目录是一样的
3 使用字面值创建
使用文字值创建,利用--from-literal
参数传递配置信息,该参数可以使用多次,格式如下
1 2 3
| $ kubectl create configmap special-config --from-literal=special.how=very --from-literal=special.type=charm
$ kubectl get configmaps special-config -o yaml
|
Pod中使用ConfigMap
1 使用ConfigMap来替代环境变量
1 2 3 4 5 6 7 8
| apiVersion: v1 kind: ConfigMap metadta: name: special-config namespace: default data: special.how: very special.type: charm
|
1 2 3 4 5 6 7
| apiVersion: v1 kind: ConfigMap metadata: name: env-config namespace: default data: log_level: INFO
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
| apiVersion: v1 kind: Pod metadata: name: dapi-test-pod spec: containers: - name: test-container image: hub.test.com/library/myapp:v1 comman: ["/bin/sh", "-c", "env"] env: - name: SPECIAL_LEVEL_KEY valueFrom: configMapKeyRef: name: special-config key: special.how - name: SPECIAL_TYPE_KEY valueFrom: configMapKeyRef: name: special-config key: special.type envFrom: - configMapRef: name:env-config restartPolicy: Never
|
2 用ConfigMap设置命令行参数
1 2 3 4 5 6 7 8
| apiVersion: v1 kind: ConfigMap metadata: name: special-config namespace: default data: special.how: very special.type: charm
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
| apiVersion: v1 kind: Pod metadata: name: dapi-test-pod2 spec: containers: - name: test-container image: hub.test.com/library/myapp:v1 command: ['/bin/sh', '-c', 'echo $(SPECIAL_LEVEL_KEY) $(SPECIAL_TYPE_KEY)'] env: - name: SPECIAL_LEVEL_KEY valueFrom: configMapKeyRef: name: special-config key: special.how - name: SPECIAL_TYPE_KEY valueFrom: configMapKeyRef: name: special-config key: special.type restartPolicy: Never
|
3 通过数据卷插件使用ConfigMap
1 2 3 4 5 6 7 8
| apiVersion: v1 kind: ConfigMap metadata: name: special-config namespace: default data: special.how: very special.type: charm
|
在数据卷里面使用个ConfigMap,有不同的选项。最基本的就是将文件填入数据卷,在这个文件中,键就是文件名,键值就是文件内容
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
| apiVersion: v1 kind: Pod metadata: name: dapi-test-pod3 spec: containers: - name: test-container image: hub.test.com/library/myapp:v1 command: ['/bin/sh', '-c', 'cat /etc/config/special.how'] volumeMounts: - name: config-volume mountPath: /etc/config volumes: - name: config-volume configMap: name: special-config restartPolicy: Never
|
ConfigMap的热更新
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
| apiVersion: v1 kind: ConfigMap metadata: name: log-config namespace: default data: log_level: INFO --- apiVersion: extensions/v1beta1 kind: Deployment metadata: name: my-nginx spec: replicas: 1 template: metadata: labels: app: my-nginx spec: containers: - name: my-nginx image: hub.test.com/library/myapp:v1 ports: - name: http containerPort: 80 volumeMounts: - name: config-volume mountPath: /etc/config volumes: - name: config-volume configMap: name: log-config
|
1 2
| $ kubectl exec my-nginx-74f99c7fd8-knsl9 cat /etc/config/log_level INFO
|
接下来进行热更新,修改ConfigMap,将INFO改成DEBUG
1
| $ kubectl edit configmaps log-config
|
查看修改是否成功
1 2
| $ kubectl exec my-nginx-74f99c7fd8-knsl9 cat /etc/config/log_level DEBUG
|
ConfigMap更新后滚动更新Pod
更新ConfigMap目前并不会触发相关Pod的滚动更新,可以通过修改pod annotations的方式强制触发滚动更新
1
| $ kubectl patch deployment my-nginx --patch '{"spec": {"template": {"metadata": {"annotations": {"version/config": "20190411"}}}}}'
|
这个例子里我们在.spec.template.metadata.annotations
中添加version/config
,每次通过修改version/config
来触发滚动更新
!!!更新ConfigMap后:
使用该ConfigMap挂载的Env不会同步更新
使用该ConfigMap挂载的Volume中的数据需要一段时间(10s左右)才能同步更新