configmap
1.作用
对于应用的可变配置在 Kubernetes 中是通过一个 ConfigMap 资源对象来实现的,我们知道许多应用经常会有从配置文件、命令行参数或者环境变量中读取一些配置信息的需求,这些配置信息我们肯定不会直接写死到应用程序中去的,比如你一个应用连接一个 redis 服务,下一次想更换一个了的,还得重新去修改代码,重新制作一个镜像,这肯定是不可取的,而ConfigMap 就给我们提供了向容器中注入配置信息的能力,不仅可以用来保存单个属性,还可以用来保存整个配置文件,比如我们可以用来配置一个 redis 服务的访问地址,也可以用来保存整个 redis 的配置文件。接下来我们就来了解下 ConfigMap 这种资源对象的使用方法。
2.创建一个configmap
[root@k8s-master01 configmap]# cat cm-demo1.yaml
kind: ConfigMap
apiVersion: v1
metadata:
name: cm-demo
namespace: default
data:
data.1: hello
data.2: world
config: |
property.1=value-1
property.2=value-2
property.3=value-3
[root@k8s-master01 configmap]# kubectl get configmaps
NAME DATA AGE
cm-demo 3 7m26s
[root@k8s-master01 configmap]# kubectl describe configmaps cm-demo
Name: cm-demo
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
config:
----
property.1=value-1
property.2=value-2
property.3=value-3
data.1:
----
hello
data.2:
----
world
Events: <none>
3.我们可以可以从一个给定的目录来创建一个 ConfigMap 对象,比如我们有一个 testcm 的目录,该目录下面包含一些配置文件,redis 和 mysql 的连接信息
[root@k8s-master01 testcm]# cat redis.conf
host=127.0.0.1
port=6379
[root@k8s-master01 testcm]# cat mysql.conf
host=127.0.0.1
port=3306
[root@k8s-master01 configmap]# kubectl create configmap cm-demo2 --from-file=testcm/
configmap/cm-demo2 created
[root@k8s-master01 configmap]# kubectl get configmaps
NAME DATA AGE
cm-demo 3 13m
cm-demo2 2 25s
game-config 2 22d
kube-root-ca.crt 1 71d
[root@k8s-master01 configmap]# kubectl describe configmaps cm-demo2
Name: cm-demo2
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
redis.conf:
----
host=127.0.0.1
port=6379
mysql.conf:
----
host=127.0.0.1
port=3306
Events: <none>
[root@k8s-master01 configmap]# kubectl get configmaps cm-demo2 -oyaml
apiVersion: v1
data:
mysql.conf: |
host=127.0.0.1
port=3306
redis.conf: |
host=127.0.0.1
port=6379
kind: ConfigMap
metadata:
creationTimestamp: "2021-04-11T05:30:28Z"
managedFields:
- apiVersion: v1
fieldsType: FieldsV1
fieldsV1:
f:data:
.: {}
f:mysql.conf: {}
f:redis.conf: {}
manager: kubectl-create
operation: Update
time: "2021-04-11T05:30:28Z"
name: cm-demo2
namespace: default
resourceVersion: "2856094"
uid: 93937b91-6488-4a6f-8277-7e15a486b0ef
4.指定文件来创建
[root@k8s-master01 configmap]# kubectl create configmap cm-demo3 --from-file=testcm/redis.conf
configmap/cm-demo3 created
[root@k8s-master01 configmap]# kubectl get configmaps cm-demo3 -oyaml
apiVersion: v1
data:
redis.conf: |
host=127.0.0.1
port=6379
kind: ConfigMap
metadata:
creationTimestamp: "2021-04-11T05:33:09Z"
managedFields:
- apiVersion: v1
fieldsType: FieldsV1
fieldsV1:
f:data:
.: {}
f:redis.conf: {}
manager: kubectl-create
operation: Update
time: "2021-04-11T05:33:09Z"
name: cm-demo3
namespace: default
resourceVersion: "2856476"
uid: 26b0b246-606c-4077-aea5-494954787e1c
5.通过帮助文档我们可以看到我们还可以直接使用字符串进行创建,通过 --from-literal 参数传递配置信息,同样的,这个参数可以使用多次,格式如下:
[root@k8s-master01 configmap]# kubectl create configmap cm-demo4 --from-literal=db.host=localhost --from-literal=db.port=3306
configmap/cm-demo4 created
[root@k8s-master01 configmap]# kubectl get configmaps cm-demo4 -oyaml
apiVersion: v1
data:
db.host: localhost
db.port: "3306"
kind: ConfigMap
metadata:
creationTimestamp: "2021-04-11T05:35:39Z"
managedFields:
- apiVersion: v1
fieldsType: FieldsV1
fieldsV1:
f:data:
.: {}
f:db.host: {}
f:db.port: {}
manager: kubectl-create
operation: Update
time: "2021-04-11T05:35:39Z"
name: cm-demo4
namespace: default
resourceVersion: "2856827"
uid: 43285a9c-d1ea-48b1-a311-1f630ea764d3
6.使用
ConfigMap 创建成功了,那么我们应该怎么在 Pod 中来使用呢?我们说 ConfigMap 这些配置数据可以通过很多种方式在 Pod 里使用,主要有以下几种方式:
设置环境变量的值
在容器里设置命令行参数
在数据卷里面挂载配置文件
非常常见的使用 ConfigMap 的方式:通过数据卷使用,在数据卷里面使用 ConfigMap,就是将文件填入数据卷,在这个文件中,键就是文件名,键值就是文件内容,如下资源对象所示:
apiVersion: v1
kind: Pod
metadata:
name: testcm3-pod
spec:
volumes:
- name: config-volume
configMap:
name: cm-demo2
containers:
- name: testcm3
image: busybox
command: [ "/bin/sh", "-c", "cat /etc/config/redis.conf" ]
volumeMounts:
- name: config-volume
mountPath: /etc/config
[root@k8s-master01 configmap]# kubectl apply -f cmtest3-pod.yaml
pod/testcm3-pod created
[root@k8s-master01 configmap]# kubectl logs testcm3-pod
host=127.0.0.1
port=6379
当然我们也可以在 ConfigMap 值被映射的数据卷里去控制路径,如下 Pod 定义:
apiVersion: v1
kind: Pod
metadata:
name: testcm4-pod
spec:
volumes:
- name: config-volume
configMap:
name: cm-demo1
items:
- key: mysql.conf
path: path/to/msyql.conf
containers:
- name: testcm4
image: busybox
command: [ "/bin/sh","-c","cat /etc/config/path/to/msyql.conf" ]
volumeMounts:
- name: config-volume
mountPath: /etc/config
[root@k8s-master01 configmap]# kubectl create -f cmtest4-pod.yaml
pod/testcm4-pod created
[root@k8s-master01 configmap]# kubectl logs cmtest4
host=127.0.0.1
port=3306