ConfigMap 功能在 Kubernetes1.2 版本的时候就有了,许多应用程序会从配置文件、命令行参数或环境变量中读取配置信息。这些配置信息需要与 docker image 解耦,ConfigMap API 给我们提供了向容器中注入配置信息的机制,ConfigMap 可以被用来保存单个属性,也可以用来保存整个配置文件或者 JSON 二进制大对象。
本篇先从环境变量开始。
[root@test-64626 ~]# kubectl create configmap myconfigmap --from-literal=user.name=itybku --from-literal=user.id=1001
# 也可以直接使用yaml文件,可以通过如下命令生成myconfigmap的yaml文件
[root@test-64626 ~]# kubectl create configmap myconfigmap --from-literal=user.name=itybku --from-literal=user.id=1001 -o
yaml --dry-run=client
apiVersion: v1
data:
user.id: "1001"
user.name: itybku
kind: ConfigMap
metadata:
creationTimestamp: null
name: myconfigmap
[root@test-64626 ~]# kubectl describe configmaps myconfigmap
Name: myconfigmap
Namespace: default
Labels:
Annotations:
Data
====
user.id:
----
1001
user.name:
----
itybku
Events:
环境变量方式引用方式1:key引用
这里我们定一个pod,然后将上述保存在user-configmap的用户名和ID保存在环境变量中
说明 | 环境变量 | 获取数据来源 |
---|---|---|
用户名的环境变量 | ENV_VAR_USERNAME | user.name |
用户ID的环境变量 | ENV_VAR__ID | user.id |
[root@test-64626 ~]# cat create-pod.yaml
apiVersion: v1
kind: Pod
metadata:
name: configmap-test-pod
spec:
containers:
- name: nginx-container
image: nginx:latest
env:
- name: ENV_VAR_USERNAME
valueFrom:
configMapKeyRef:
name: myconfigmap
key: user.name
- name: ENV_VAR_ID
valueFrom:
configMapKeyRef:
name: myconfigmap
key: user.id
restartPolicy: Never
[root@test-64626 ~]# kubectl create -f create-pod.yaml
pod/configmap-test-pod created
[root@test-64626 ~]# kubectl get pods
NAME READY STATUS RESTARTS AGE
configmap-test-pod 1/1 Running 0 4s
[root@test-64626 ~]# kubectl exec configmap-test-pod -- env|grep ENV
ENV_VAR_USERNAME=itybku
ENV_VAR_ID=1001
环境变量方式引用方式2:configmap名称映射
在方式1中将ConfigMap中的Key与环境变量一一映射进行使用,还可以不指定环境变量名称一次性全部引用,只需要将相应的yml文件设定为如下方式即可
变量说明 | 标识符 | 设定值 |
---|---|---|
用户名 | user.name | itybku |
用户ID | user.id | 1001 |
[root@test-64626 ~]# cat create-pod2.yaml
apiVersion: v1
kind: Pod
metadata:
name: configmap-test-all
spec:
containers:
- name: nginx-container
image: nginx:latest
envFrom:
- configMapRef:
name: myconfigmap
restartPolicy: Never
[root@test-64626 ~]#
[root@test-64626 ~]# kubectl create -f create-pod2.yaml
pod/configmap-test-all created
[root@test-64626 ~]# kubectl exec configmap-test-all -- env|grep ENV
[root@test-64626 ~]# kubectl exec configmap-test-all -- env|grep user
user.id=1001
user.name=itybku
注意,在使用configmap名映射方式,不建议以user.id、user.name这样的方式命名变量,因为这样的变量无法正常通过echo $变量名
的方式进行输出,因为这不符合shell规范,里面包含了特殊符号点。
[root@test-64626 ~]# kubectl exec -it configmap-test-pod -- /bin/bash
root@configmap-test-all:/# echo ${user.id}
bash: ${user.id}: bad substitution
root@configmap-test-all:/# echo $user
root@configmap-test-all:/# echo $user.id
.id
这里也给下shell变量的要求:
- 命名只能使用英文字母,数字和下划线,首个字符不能以数字开头。
- 中间不能有空格,可以使用下划线 _。
- 不能使用标点符号。
- 不能使用bash里的关键字(可用help命令查看保留关键字)
所以可以改用下面的方式命名变量:
[root@test-64626 ~]# kubectl create configmap myconfigmap --from-literal=Name=itybku --from-literal=Id=1001