Kubernetes ConfigMap
ConfigMap 介绍
在Kubernetes 1.2中新添加了功能ConfigMap,主要功能是为了解决应用程序会从配置文件、环境变量中获取配置信息。但是默认情况下配置信息需要与docker images解耦,ConfigMap API为我们提供了向容器中注入配置信息的机制,ConfigMap可以被用来保存单个属性,也可以用来保存整个配置文件或者JSON二进制对象
ConfigMap API资源用来保存key-vlaue pair配置数据,这个数据可以在pods里使用,或者被用来为contaroller一样的系统组件存储配置数据。ConfigMap 是为了方便的处理不含铭感信息的字符串,你可以将它理解为Linux系统中的/etc目录,专门用来存储配置文件的目录
#注意: ConfigMap不是属性配置文件的代替品,ConfigMap只是作为多个properties文件的引用。
ConfigMap 项目演示
configmap主要还是方便处理非敏感的数据,比如注册中心地址、数据库地址、nginx地址等。像密码之类需要加密的还是需要使用secrets来进行管理
下方yaml文件中data一栏包括了配置数据,ConfigMap可以保存单个属性,也可以用来保存一个配置文件。配置数据可以通过很多种方式在Pods里被引用,ConfigMap可以用来:
[√] 设置环境变量的值
[√] 在容器里设置命令行参数
[√] 在数据卷里面创建config文件
用户和系统两者都可以在ConfigMap里存储
1. 使用Yaml文件创建ConfigMap
说明 configmap支持单个key-value键值,也支持config文件的方式
单个环境变量引用
apiVersion: v1
kind: ConfigMap
metadata:
name: configmap
data:
data1: hello
data2: test
#其中这里data1=hello,类似于环境变量 (如果是数字需要添加双引号)
[root@kubernetes-m mnt]# kubectl create -f cmp.yaml
configmap/configmap created
[root@kubernetes-m mnt]# kubectl get configmaps
NAME DATA AGE
configmap 2 5s
配置文件变量引用 比如我们需要创建多个环境变量,这里可以直接引用配置文件的方式
apiVersion: v1
kind: ConfigMap
metadata:
name: configmap
data:
config: | ###这里是文件名称
zuul_host=123456 #变量名称及值
zuul_port=123
mysql_url=456
[root@kubernetes-m mnt]# kubectl create -f cmp.yaml
configmap/configmap created
[root@kubernetes-m mnt]# kubectl get configmaps
NAME DATA AGE
configmap 1 5s
[root@kubernetes-m mnt]# kubectl describe configmaps configmap
Name: configmap
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
config:
----
zuul_host=123456
zuul_port=123
mysql_url=456
Events: <none>
下面进行创建文件演示
#这里可以看到DATA位1,说明只有一个文件
2.使用kubectl创建
#创建的帮助,下面有创建的方法以及例子
[root@kubernetes-m mnt]# kubectl create configmap -h
Examples:
# Create a new configmap named my-config based on folder bar
kubectl create configmap my-config --from-file=path/to/bar
# Create a new configmap named my-config with specified keys instead of file basenames on disk
kubectl create configmap my-config --from-file=key1=/path/to/bar/file1.txt --from-file=key2=/path/to/bar/file2.txt
# Create a new configmap named my-config with key1=config1 and key2=config2
kubectl create configmap my-config --from-literal=key1=config1 --from-literal=key2=config2
# Create a new configmap named my-config from the key=value pairs in the file
kubectl create configmap my-config --from-file=path/to/bar
# Create a new configmap named my-config from an env file
kubectl create configmap my-config --from-env-file=path/to/bar.env
这里我模拟挂载test目录下的2个文件
#当前目录结构
[root@kubernetes-m mnt]# ll test/
total 0
-rw-r--r-- 1 root root 0 Nov 9 21:06 mysql.conf
-rw-r--r-- 1 root root 0 Nov 9 21:06 nginx.conf
#创建configmap
[root@kubernetes-m mnt]# kubectl create configmap cm --from-file=test
configmap/cm created
#后面--from-file接的是目录,也可以是文件
#创建完毕后我们进行查看
[root@kubernetes-m mnt]# kubectl get configmaps
NAME DATA AGE
cm 2 18s
[root@kubernetes-m mnt]# kubectl describe configmaps cm
Name: cm
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
mysql.conf:
----
nginx.conf:
----
Events: <none>
#也可以使用命令行创建单个
kubectl create configmap cm-name --from-literal=abc.host=localhost --from-literal=aaa.port=80
#--from-literal支持引用多个
温馨提示:使用describe的时候,配置文件如果过大,不会完全显示,如果要查看详细信息需要使用kubectl get configmap [cm-name] -o yaml使用yaml展示(输出格式也可以修改为json)
3.使用环境变量引用configmap
引用单个环境变量
首先创建configmap 然后 创建Pod进行引用
apiVersion: v1
kind: ConfigMap
metadata:
name: configmap
data:
db.host: localhost
db.port: "3306"
---
apiVersion: v1
kind: Pod
metadata:
name: test-demo-configmap
spec:
containers:
- name: busybox
image: busybox
command: [ "/bin/sh","-c","env" ]
env: #引用环境变量
- name: ZUUL_HOST #环境变量值 (这个值可以与下面configmap key中不相同)
valueFrom: #环境变量值来源
configMapKeyRef: #使用configmap值
name: configmap #configmap 名称
key: db.host #configmap中的值
检查结果
[root@kubernetes-m mnt]# kubectl create -f cmp.yaml
configmap/configmap created
pod/busybox created
[root@kubernetes-m mnt]# kubectl get pod
NAME READY STATUS RESTARTS AGE
busybox 0/1 ContainerCreating 0 22s
[root@kubernetes-m mnt]# kubectl logs busybox
---
ZUUL_HOST=localhost
---
#这里我将原来是db.host变量修改为ZUUL_HOST变量等于
引用文件,不定义key
另外的一种写法,直接引用变量,不自定义Key,主要是用于引用文件,可以使用这种方式
apiVersion: v1
kind: Pod
metadata:
name: busybox
spec:
containers:
- name: busybox
image: busybox
command: [ "/bin/sh","-c","env" ]
envFrom: #引用文件作为环境变量
- configMapRef: #configmap来源
name: configmap #configmap名称
####直接创建就可以,这里就是将configmap里面的值全部引用进来
[root@kubernetes-m mnt]# kubectl create -f cmp.yaml
configmap/configmap created
pod/busybox created
[root@kubernetes-m mnt]# kubectl get pod
NAME READY STATUS RESTARTS AGE
busybox 0/1 ContainerCreating 0 5s
[root@kubernetes-m mnt]# kubectl get pod --watch
NAME READY STATUS RESTARTS AGE
busybox 0/1 ContainerCreating 0 10s
busybox 0/1 Completed 0 17s
## 查看日志
[root@kubernetes-m mnt]# kubectl logs busybox
---
db.host=localhost
db.port=3306
4.通过命令引用configmap
在configmap里面支持命令引用变量的方式
#这里还是拿之前的configmap举例
apiVersion: v1
kind: Pod
metadata:
name: bosybox
spec:
containers:
- name: busybox
image: busybox
command: [ "/bin/sh","-c","echo $(DB_HOST) $(DB_PORT)" ]
env:
- name: DB_HOST
valueFrom:
configMapKeyRef:
name: configmap
key: db.host
- name: DB_PORT
valueFrom:
configMapKeyRef:
name: configmap
key: db.port
#这里还是使用Key的方式,命令行直接echo下面的环境变量就可以
[root@kubernetes-m mnt]# kubectl create -f cmp.yaml
configmap/configmap created
pod/bosybox created
[root@kubernetes-m mnt]# kubectl get pod --watch
NAME READY STATUS RESTARTS AGE
bosybox 0/1 ContainerCreating 0 13s
bosybox 0/1 Completed 0 17s
[root@kubernetes-m mnt]# kubectl logs bosybox
localhost 3306
由于使用的busybox镜像,没有后台执行命令,所以会出现CrashLoopBackOff状态,是属于正常状态
4.通过数据卷挂载引用configmap
配置文件如下,包含configmap文件
apiVersion: v1
kind: ConfigMap
metadata:
name: configmap
namespace: default
data:
nginx.conf: |
nginx.host: localhost
nginx.port: "3306"
---
apiVersion: v1
kind: Pod
metadata:
name: busybox
spec:
containers:
- name: busybox
image: busybox
command: [ "/bin/sh","-c","cat /etc/config/nginx.conf" ]
volumeMounts: #挂载声明
- name: config-volume #volume名称
mountPath: /etc/config #挂载点
volumes:
- name: config-volume #和volumeMounts的名称要一致
configMap:
name: configmap-demo-volume #configmap名称
将上面的yaml保存到文件进行执行,然后我们直接看pod日志就可以了,从pod日志可以看出我们挂载已经完成,因为默认的busybox镜像中没有nginx.conf,通过挂载才获取到的
[root@kubernetes-m mnt]# kubectl create -f cmp.yaml
configmap/configmap created
pod/busybox created
[root@kubernetes-m mnt]# kubectl get pod
NAME READY STATUS RESTARTS AGE
busybox 0/1 Completed 0 19s
[root@kubernetes-m mnt]# kubectl logs busybox
nginx.host: localhost
nginx.port: "3306"
如果/etc/没有config目录也是可以挂载的,并不影响
如果我们有2个pod都需要挂载configmap,其中一个是在/etc/config/nginx.conf,还有一个是在/etc/config/path/to目录下,这时候就可以使用下面的案例
apiVersion: v1
kind: ConfigMap
metadata:
name: configmap
namespace: default
data:
nginx.conf: |
nginx.host: localhost
nginx.port: "3306"
---
apiVersion: v1
kind: Pod
metadata:
name: busybox
spec:
containers:
- name: busybox
image: busybox
command: [ "/bin/sh","-c","cat /etc/config/path/go/nginx.conf" ]
volumeMounts: #挂载声明
- name: config-volume #volume名称
mountPath: /etc/config #挂载点
volumes:
- name: config-volume #和volumeMounts的名称要一致
configMap:
name: configmap #configmap名称
items:
- key: nginx.conf #configmap中的key
path: path/go/nginx.conf #挂载路径
[root@kubernetes-m mnt]# kubectl create -f cmp.yaml
configmap/configmap created
pod/busybox created
[root@kubernetes-m mnt]# kubectl get pod
NAME READY STATUS RESTARTS AGE
busybox 0/1 ContainerCreating 0 3s
[root@kubernetes-m mnt]# kubectl get pod --watch
NAME READY STATUS RESTARTS AGE
busybox 0/1 ContainerCreating 0 9s
busybox 0/1 Completed 0 21s
日志如下
[root@kubernetes-m mnt]# kubectl logs busybox
nginx.host: localhost
nginx.port: "3306"