目录
Secret 是用来保存密码、token、密钥等敏感数据的 k8s 资源,这类数据虽然也可以存放在 Pod 或者镜像中,但是放在 Secret 中是为了更方便的控制如何使用数据,并减少暴露的风险。
Secret 有四种类型
●kubernetes.io/service-account-token:由 Kubernetes 自动创建,用来访问 APIServer 的 Secret,Pod 会默认使用这个 Secret 与 APIServer 通信, 并且会自动挂载到 Pod 的 /run/secrets/kubernetes.io/serviceaccount 目录中;
●Opaque :base64 编码格式的 Secret,用来存储用户自定义的密码、密钥等,默认的 Secret 类型;
●kubernetes.io/dockerconfigjson :用来存储私有 docker registry 的认证信息。
●kubernetes.io/tls :用来存储 TLS 证书和私钥信息。
创建Secret资源
kubectl create secret generic <资源名称> --from-file=文件|目录 --from-literal=<键名>=<键值>
kubectl create secret docker-registry <资源名称> --docker-server=<私有仓库URL路径> --docker-username=<仓库用户名> --docker-password=<用户密码> --docker-email=<邮箱地址>
kubectl create secret tls <资源名称> --cert=证书文件 --key=私钥文件
查看Secret资源(键值会以base64编码格式加密显示)
kubectl get -n <命名空间> secret
-o yaml
kubectl describe -n <命名空间> secret
使用Secret资源(三种)
作为存储卷挂载的方式:
在Pod资源配置中用spec.volumes字段设置secret类型的卷
在容器配置中用volumeMounts将卷挂载到容器的指定的目录,Secret资源数据的键名会作为文件名,Secret资源数据的键值会作为文件内容作为容器环境变量的方式:
在容器配置中用env.name字段自定义容器的环境变量名,用env.valueFrom.secretKeyRef.key/name字段指定环境变量的值从哪个Secret资源的键获取
在容器配置中用envFrom.secretRef.name字段指定Secret资源的名称,使得Secret资源数据的键名和键值直接作为容器的环境变量名和值Pod配置从私有仓库拉取镜像:
在Pod资源配置中用spec.imagePullSecrets.name字段指定kubernetes.io/dockerconfigjson类型的Secret资源名称
用kubectl create secret命令创建Secret
- echo -n 'zhangsan' > username.txt
- echo -n 'abc1234' > password.txt
-
- kubectl create secret generic mysecret --from-file=username.txt --from-file=password.txt
-
- kubectl get secrets
- kubectl describe secret mysecret
- #get或describe指令都不会展示secret的实际内容,这是出于对数据的保护的考虑
内容用 base64 编码,创建Secret
- echo -n zhangsan | base64
- emhhbmdzYW4K=
-
- echo -n abc1234 | base64
- YWJjMTIzNAo==
-
- vim secret.yaml
- apiVersion: v1
- kind: Secret
- metadata:
- name: mysecret1
- type: Opaque
- data:
- username: emhhbmdzYW4K=
- password: YWJjMTIzNAo==
-
- kubectl create -f secret.yaml
-
- kubectl get secrets
- kubectl get secret mysecret1 -o yaml

将 Secret 挂载到 Volume 中,以 Volume 的形式挂载到 Pod 的某个目录下
- vim secret-test.yaml
- apiVersion: v1
- kind: Pod
- metadata:
- name: mypod
- spec:
- containers:
- - name: nginx
- image: nginx
- volumeMounts:
- - name: secrets
- mountPath: "/etc/secrets"
- readOnly: true
- volumes:
- - name: secrets
- secret:
- secretName: mysecret
-
- kubectl create -f secret-test.yaml
-
- kubectl get pods
- kubectl exec -it mypod bash

将 Secret 导出到环境变量中
- vim secret-test1.yaml
- apiVersion: v1
- kind: Pod
- metadata:
- name: mypod1
- spec:
- containers:
- - name: nginx
- image: nginx
- env:
- - name: TEST_USER
- valueFrom:
- secretKeyRef:
- name: mysecret1
- key: username
- - name: TEST_PASSWORD
- valueFrom:
- secretKeyRef:
- name: mysecret1
- key: password
- envFrom:
- - secretRef:
- name: mysecret1
-
- kubectl apply -f secret-test1.yaml
-
- kubectl get pods
-
- kubectl exec -it mypod bash

与Secret类似,区别在于ConfigMap保存的是不需要加密配置的信息。
ConfigMap 功能在 Kubernetes1.2 版本中引入,许多应用程序会从配置文件、命令行参数或环境变量中读取配置信息。ConfigMap API 给我们提供了向容器中注入配置信息的机制,ConfigMap 可以被用来保存单个属性,也可以用来保存整个配置文件或者JSON二进制大对象。
应用场景:应用配置
创建cm资源
kubectl create cm <资源名称> --from-file=文件|目录 --from-literal=<键名>=<键值>
查看cm资源数据
- kubectl get -n <命名空间> cm
-o yaml - kubectl describe -n <命名空间> cm
使用cm资源
作为存储卷挂载的方式:
在Pod资源配置中用spec.volumes字段设置configMap类型的卷
在容器配置中用volumeMounts将卷挂载到容器的指定的目录,cm资源数据的键名会作为文件名,cm资源数据的键值会作为文件内容(支持热更新)
在容器配置中用volumeMounts.subPath字段指定文件名,实现将卷挂载到容器中指定的文件上(不支持热更新)作为容器环境变量的方式:(不支持热更新)
在容器配置中用env.name字段自定义容器的环境变量名,用env.valueFrom.configMapKeyRef.key/name字段指定环境变量的值从哪个cm资源的键获取
在容器配置中用envFrom.configMapRef.name字段指定cm资源的名称,使得cm资源数据的键名和键值直接作为容器的环境变量名和值
使用目录创建
- mkdir /opt/configmap/
-
- vim /opt/configmap/game.config
- enemy.types=aliens,monsters
- player.maximum-lives=5
-
- vim /opt/configmap/ui.config
- color.good=purple
- color.bad=yellow
- allow.textmode=true
-
- ls /opt/configmap/
- game.config
- ui.config
-
- kubectl create configmap game-config --from-file=/opt/configmap/
- #--from-file 指定在目录下的所有文件都会被用在 ConfigMap 里面创建一个键值对,键的名字就是文件名,值就是文件的内容
-
- kubectl get cm
- kubectl get cm game-config -o yaml

使用文件创建
只要指定为一个文件就可以从单个文件中创建 ConfigMap
--from-file 这个参数可以使用多次,即可以使用两次分别指定上个实例中的那两个配置文件,效果就跟指定整个目录是一样的
- kubectl create configmap game-config-2 --from-file=/opt/configmap/game.config --from-file=/opt/configmap/ui.config
- kubectl get configmaps game-config-2 -o yaml
-
- kubectl describe cm game-config-2

使用字面值创建
使用文字值创建,利用 --from-literal 参数传递配置信息,该参数可以使用多次,格式如下
- kubectl create configmap special-config --from-literal=special.how=very --from-literal=special.type=good
-
- kubectl get configmaps special-config -o yaml
使用 ConfigMap 来替代环境变量
- vim env.yaml
- apiVersion: v1
- kind: ConfigMap
- metadata:
- name: special-config
- namespace: default
- data:
- special.how: very
- special.type: good
- ---
- apiVersion: v1
- kind: ConfigMap
- metadata:
- name: env-config
- namespace: default
- data:
- log_level: INFO
-
-
- kubectl create -f env.yaml
-
- kubectl get cm

Pod的创建
- vim test-pod.yaml
- apiVersion: v1
- kind: Pod
- metadata:
- name: test-pod
- spec:
- containers:
- - name: busybox
- image: busybox:1.28.4
- command: [ "/bin/sh", "-c", "env" ]
- env:
- - name: SPECIAL_HOW_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
-
-
- kubectl create -f test-pod.yaml
-
- kubectl get pods
- kubectl logs test-pod

- vim test-pod2.yaml
- apiVersion: v1
- kind: Pod
- metadata:
- name: test-pod2
- spec:
- containers:
- - name: busybox
- image: busybox:1.28.4
- command:
- - /bin/sh
- - -c
- - echo "$(SPECIAL_HOW_KEY) $(SPECIAL_TYPE_KEY)"
- env:
- - name: SPECIAL_HOW_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
-
-
- kubectl create -f test-pod2.yaml
-
- kubectl get pods
- kubectl logs test-pod2

在数据卷里面使用 ConfigMap,就是将文件填入数据卷,在这个文件中,键就是文件名,键值就是文件内容
- vim test-pod3.yaml
- apiVersion: v1
- kind: Pod
- metadata:
- name: test-pod3
- spec:
- containers:
- - name: busybox
- image: busybox:1.28.4
- command: [ "/bin/sh", "-c", "sleep 36000" ]
- volumeMounts:
- - name: config-volume
- mountPath: /etc/config
- volumes:
- - name: config-volume
- configMap:
- name: special-config
- restartPolicy: Never
-
-
- kubectl create -f test-pod3.yaml
-
- kubectl get pods
- kubectl exec -it test-pod3 sh
- # cd /etc/config/
- # ls
- special.how special.type
- # cat special.how
- # cat special.type

- vim test-pod4.yaml
- apiVersion: v1
- kind: ConfigMap
- metadata:
- name: log-config
- namespace: default
- data:
- log_level: INFO
- ---
- apiVersion: apps/v1
- kind: Deployment
- metadata:
- name: my-nginx
- spec:
- selector:
- matchLabels:
- app: nginx
- replicas: 1
- template:
- metadata:
- labels:
- app: nginx
- spec:
- containers:
- - name: my-nginx
- image: nginx
- ports:
- - containerPort: 80
- volumeMounts:
- - name: config-volume
- mountPath: /etc/config
- volumes:
- - name: config-volume
- configMap:
- name: log-config
-
- kubectl apply -f test-pod4.yaml
-
- kubectl get pods
- kubectl exec -it my-nginx-c4d7b87df-fm7tr -- cat /etc/config/log_level
- INFO
-
- kubectl edit configmap log-config
- apiVersion: v1
- data:
- log_level: DEBUG #INFO 修改成 DEBUG
- kind: ConfigMap
- metadata:
- annotations:
- kubectl.kubernetes.io/last-applied-configuration: |
- {"apiVersion":"v1","data":{"log_level":"DEBUG"},"kind":"ConfigMap","metadata":{"annotations":{},"name":"log-config","namespace":"default"}}
- creationTimestamp: "2024-03-07T07:41:49Z"
- name: log-config
- namespace: default
- resourceVersion: "253476"
- selfLink: /api/v1/namespaces/default/configmaps/log-config
- uid: f972c8ca-1228-4eb1-b4ac-a44a40c6c488
-

- //等大概10秒左右,使用该 ConfigMap 挂载的 Volume 中的数据同步更新
- kubectl exec -it my-nginx-c4d7b87df-fm7tr -- cat /etc/config/log_level
- DEBUG
-
- //ConfigMap 更新后滚动更新 Pod
- 更新 ConfigMap 目前并不会触发相关 Pod 的滚动更新,可以通过在 .spec.template.metadata.annotations 中添加 version/config ,每次通过修改 version/config 来触发滚动更新
-
- kubectl patch deployment my-nginx --patch '{"spec": {"template": {"metadata": {"annotations": {"version/config": "20210525" }}}}}'
-
- kubectl get pods



PS:
更新 ConfigMap 后
●使用该 ConfigMap 挂载的 Env 不会同步更新。
●使用该 ConfigMap 挂载的 Volume 中的数据需要一段时间(实测大概10秒)才能同步更新。