登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

豆瓜网 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 业界 ›K8s新手系列之ConfigMap资源

K8s新手系列之ConfigMap资源

蓟晓彤 2025-6-3 10:39:39
概述

在 Kubernetes（K8s）中，ConfigMap 是一种 API 对象，用于将非机密性的数据保存到键值对中。Pod 可以将其用作环境变量、命令行参数或者存储卷中的配置文件。
ConfigMap 允许你将配置清单与镜像内容分离，以保持容器化的应用程序的可移植性。 例如，你可以下载并运行相同的容器镜像来启动容器， 用于本地开发、系统测试或运行实时终端用户工作负载。
ConfigMap 是一个让你可以存储其他对象所需要使用的配置的 API 对象。 和其他 Kubernetes 对象都有一个 spec 不同的是，ConfigMap 使用 data 和 binaryData 字段。这些字段能够接收键-值对作为其取值。data 和 binaryData 字段都是可选的。data 字段设计用来保存 UTF-8 字符串，而 binaryData 则被设计用来保存二进制数据作为 base64 编码的字串。
官方文档地址：https://kubernetes.io/zh-cn/docs/tasks/configure-pod-container/configure-pod-configmap/
ConfigMap的作用

集中存储配置信息：


  • ConfigMap可以将应用程序的配置信息（如数据库连接字符串、日志级别、服务端口等）集中存储在一个地方。这些配置信息以键值对的形式存在，方便管理和维护。例如，一个应用程序需要连接到数据库，其数据库的用户名、密码、地址等信息可以存储在ConfigMap中。
  • 通过ConfigMap，开发者可以将配置信息与应用程序代码分离，使得应用程序更加通用和可移植。当需要在不同环境中运行应用程序时（如开发环境、测试环境和生产环境），只需修改ConfigMap中的配置值，而无需修改应用程序代码。
    支持多种数据格式
  • ConfigMap支持多种数据格式，包括字符串、文件内容等。可以将配置文件（如properties文件、yaml文件等）的内容直接存储到ConfigMap中。例如，一个应用程序的配置文件config.properties中包含多个配置项，可以将其内容读取后存储到ConfigMap中，然后应用程序通过ConfigMap来读取这些配置项。
注入配置

ConfigMap可以将配置信息注入到容器中，容器可以通过环境变量、挂载卷等方式访问这些配置信息。

  • 环境变量方式：可以将ConfigMap中的配置项作为环境变量注入到容器中。例如，一个容器需要访问数据库，其数据库的用户名和密码可以通过ConfigMap以环境变量的形式注入到容器中，容器在运行时可以直接使用这些环境变量来获取配置信息。
  • 挂载卷方式：可以将ConfigMap中的配置文件挂载到容器的文件系统中。例如，一个应用程序需要读取一个配置文件config.yaml，可以将存储该配置文件内容的ConfigMap挂载到容器的某个目录下，容器在运行时可以通过文件路径来访问该配置文件。
动态更新配置

当ConfigMap中的配置信息发生变化时，容器可以感知到这些变化，并根据需要重新加载配置信息。这种动态更新配置的能力使得应用程序可以在不重启容器的情况下，快速响应配置的变化。例如，当数据库的连接地址发生变化时，更新ConfigMap中的相应配置项，容器可以自动获取新的配置并重新建立数据库连接。
提高代码的可维护性

将配置信息存储在ConfigMap中，使得应用程序代码更加简洁和清晰。开发者不需要在代码中硬编码配置信息，减少了代码的复杂性和耦合度。当需要修改配置时，只需修改ConfigMap，而无需修改代码，降低了维护成本。
增强代码的可移植性

由于配置信息与代码分离，应用程序可以在不同的环境中运行，而无需修改代码。通过调整ConfigMap中的配置值，可以轻松地将应用程序从开发环境迁移到测试环境或生产环境，提高了应用程序的可移植性。
多容器共享配置

在 Kubernetes 中，一个ConfigMap可以被多个容器共享。当多个容器需要使用相同的配置信息时，可以使用同一个ConfigMap，避免了重复配置的问题。例如，在一个微服务架构中，多个服务实例可能需要访问同一个数据库，可以将数据库的配置信息存储在一个ConfigMap中，所有服务实例都可以通过该ConfigMap来获取配置信息。
多应用共享配置

不同的应用程序也可以共享同一个ConfigMap。例如，多个应用程序可能需要访问同一个外部服务，可以将该外部服务的配置信息存储在一个ConfigMap中，所有应用程序都可以通过该ConfigMap来获取配置信息。
简化部署流程

在部署应用程序时，通过ConfigMap可以快速地将配置信息传递给容器。开发者只需定义好ConfigMap，然后在部署时将ConfigMap与容器关联起来，即可完成配置的注入，简化了部署流程。
方便运维管理

运维人员可以通过ConfigMap集中管理配置信息，方便对配置进行修改、备份和恢复。当出现问题时，可以通过查看ConfigMap中的配置信息来快速定位问题原因，提高了运维效率。
创建ConfigMap

通过文件来创建ComfigMap

语法：
  1. kubectl create configmap [config的名称] --from-file=[file] ... --from-file=[file]
  3. # 或者通过
  4. kubectl create configmap [config的名称] --from-env-file=[file] ... --from-env-file=[file]
  6. 解析：
  7. --from-env-file：可以通过env的方式来创建ConfigMap，例如name=zhangsan，使用--from-file创建时，其配置项不会变化。
  8. 但是通过--from-env-file创建时，会自动解析成name: zhangsan的形式
复制代码
哪些文件可以用来创建ConfigMap呢？


  • .properties文件：这是 Java 应用常用的配置文件类型，采用键值对的格式存储配置信息，例如：
  1. database.host=localhost
  2. database.port=3306
复制代码

  • .yaml/.yml文件：是一种可读性高的数据序列化格式，在 Kubernetes 自身配置和许多应用配置中广泛使用，例如：
  1. database:
  2.   host: localhost
  3.   port: 3306
  4. server:
  5.   port: 8080
复制代码

  • .ini 文件：常用于存储配置数据，其结构包含多个节（section），每个节下面有多个键值对，示例如下：
  1. [database]
  2. host=localhost
  3. port=3306
  5. [server]
  6. port=8080
复制代码

  • .json 文件：一种轻量级的数据交换格式，常用于存储结构化数据，示例如下：
  1. {
  2.   "database": {
  3.     "host": "localhost",
  4.     "port": 3306
  5.   },
  6.   "server": {
  7.     "port": 8080
  8.   }
  9. }
复制代码

  • .conf 文件：通常是各种服务的配置文件，像 Nginx、Apache 等服务的配置文件就常以 .conf 为扩展名。
  1. worker_processes auto;
  2. error_log /var/log/nginx/error.log warn;
  3. pid /var/run/nginx.pid;
  4. events {
  5.     worker_connections 1024;
  6. }
  7. http {
  8.     server {
  9.     }
  10. }
复制代码

  • .txt文件：普通文本文件，可存储任意文本信息，例如存储日志级别、应用描述等内容。
  1. asdsxfaseqwesd
复制代码
通过properties文件创建ConfigMap

示例：
  1. # 创建properties文件
  2. [root@master01 ~/configmap]# cat db.properties
  3. database.url=jdbc:mysql://localhost:3306/mydb
  4. database.username=root
  5. database.password=password
  7. # 创建ComfigMap
  8. [root@master01 ~/configmap]# kubectl create configmap db-config --from-file=db.properties
  9. configmap/db-config created
  11. # 查看ConfigMap
  12. [root@master01 ~/configmap]# kubectl get configmap
  13. NAME               DATA   AGE
  14. db-config          1      53s
  16. # 查看ConfigMap生成的yaml文件
  17. [root@master01 ~/configmap]# kubectl get configmap db-config -o yaml
  18. apiVersion: v1
  19. metadata:
  20.   creationTimestamp: "2025-05-02T06:02:42Z"
  21.   name: db-config
  22.   namespace: default
  23.   resourceVersion: "59760"
  24.   uid: dc9de3eb-5e19-47fd-854d-2c4fcddbf8ba
  25. data:
  26.   db.properties: |
  27.     database.url=jdbc:mysql://localhost:3306/mydb
  28.     database.username=root
  29.     database.password=password
  30. kind: ConfigMap
  32. # 查看ConfigMap的详细信息
  33. [root@master01 ~/configmap]# kubectl describe configmap db-config
  34. Name:         db-config
  35. Namespace:    default
  36. Labels:       <none>
  37. Annotations:  <none>
  39. Data #这里就是对应的数据信息
  40. ====
  41. db.properties:
  42. ----
  43. database.url=jdbc:mysql://localhost:3306/mydb
  44. database.username=root
  45. database.password=password
  48. BinaryData #这里是二进制数据
  49. ====
  51. Events:  <none>
复制代码
通过目录创建ConfigMap

语法：
  1. kubectl create configmap [config的名称] --from-file=[filepath] ... --from-file=[filepath]
  3. # 或者通过
  4. kubectl create configmap [config的名称] --from-env-file=[filepath] ... --from-env-file=[filepath]
  6. 解析：
  7. --from-env-file：可以通过env的方式来创建ConfigMap，例如name=zhangsan，使用--from-file创建时，其配置项不会变化。
  8. 但是通过--from-env-file创建时，会自动解析成name: zhangsan的形式
复制代码
这种方式其实和通过文件来创建ConfigMap是一样的原理。
示例：
  1. # 创建目录
  2. [root@master01 ~]# mkdir -p /root/configmap/app
  4. # 造数据
  5. [root@master01 ~]# wget https://kubernetes.io/examples/configmap/game.properties -O /root/configmap/app/game.properties
  6. #...省略部分信息
  7. /root/configmap/app/game.properties                 100%[==================================================================================================================>]     157  --.-KB/s    in 0s
  9. 2025-05-02 14:09:46 (178 MB/s) - ‘/root/configmap/app/game.properties’ saved [157/157]
  10. [root@master01 ~]# wget https://kubernetes.io/examples/configmap/ui.properties -O /root/configmap/app/ui.properties
  11. #...省略部分信息
  12. /root/configmap/app/ui.properties                   100%[==================================================================================================================>]      83  --.-KB/s    in 0s
  14. 2025-05-02 14:10:03 (156 MB/s) - ‘/root/configmap/app/ui.properties’ saved [83/83]
  16. # 创建ConfigMap
  17. [root@master01 ~]# kubectl create configmap app-config  --from-file=/root/configmap/app
  18. configmap/app-config created
  20. # 查看ConfigMap，两个文件变成了一个configMap
  21. [root@master01 ~]# kubectl get configmap app-config -o yaml
  22. apiVersion: v1
  23. kind: ConfigMap
  24. metadata:
  25.   creationTimestamp: "2025-05-02T06:13:01Z"
  26.   name: app-config
  27.   namespace: default
  28.   resourceVersion: "61185"
  29.   uid: 2cce2598-db6f-41a2-89fe-f144fac4159c
  30. data:
  31.   game.properties: |-
  32.     enemies=aliens
  33.     lives=3
  34.     enemies.cheat=true
  35.     enemies.cheat.level=noGoodRotten
  36.     secret.code.passphrase=UUDDLRLRBABAS
  37.     secret.code.allowed=true
  38.     secret.code.lives=30
  39.   ui.properties: |
  40.     color.good=purple
  41.     color.bad=yellow
  42.     allow.textmode=true
  43.     how.nice.to.look=fairlyNice
复制代码
通过字面量创建ConfigMap

ConfigMap还支持直接输入字面量来创建
语法：
  1. kubectl create configmap [configName] [--from-literal="key=value"] ... [--from-literal="key=value"]
复制代码
示例：
  1. # 创建ConfigMap
  2. [root@master01 ~]# kubectl create configmap user-config --from-literal="user.name=zhangsan" \
  3.                                       --from-literal="user.age=18" \
  4.                                       --from-literal="user.addr=beijing"
  5. configmap/user-config created
  7. # 查看ConfigMap的yaml文件
  8. [root@master01 ~]# kubectl get configmap user-config -o yaml
  9. apiVersion: v1
  10. kind: ConfigMap
  11. metadata:
  12.   creationTimestamp: "2025-05-02T06:35:22Z"
  13.   name: user-config
  14.   namespace: default
  15.   resourceVersion: "64263"
  16.   uid: 9ffe4dc3-31ee-4cde-bbfe-24041aa824bd
  17. data:
  18.   user.addr: beijing
  19.   user.age: "18"
  20.   user.name: zhangsan
  22. # 查看详细信息
  23. [root@master01 ~]# kubectl describe configmap user-config
  24. Name:         user-config
  25. Namespace:    default
  26. Labels:       <none>
  27. Annotations:  <none>
  29. Data
  30. ====
  31. user.age:
  32. ----
  33. 18
  34. user.name:
  35. ----
  36. zhangsan
  37. user.addr:
  38. ----
  39. beijing
  41. BinaryData
  42. ====
  44. Events:  <none>
复制代码
通过资源清单创建ConfigMap

ConfigMap也可以通过K8s的Yaml文件进行创建，通过资源清单创建ConfigMap有两种方式，一种是类属性键，一种是类文件键
示例：
  1. # 定义资源清单
  2. [root@master01 ~/configmap]# cat game-configmap.yaml
  3. apiVersion: v1
  4. kind: ConfigMap
  5. metadata:
  6.   name: game-demo
  7. data:
  8.   # 类属性键；每一个键都映射到一个简单的值
  9.   player_initial_lives: "3"
  10.   ui_properties_file_name: "user-interface.properties"
  12.   # 类文件键
  13.   game.properties: |
  14.     enemy.types=aliens,monsters
  15.     player.maximum-lives=5
  16.   nginx.conf: |
  17.         server {
  18.             listen:80;
  19.             server_name:xxx;
  20.             root:/root;
  21.             location:{
  22.                 xxx
  23.             }
  24.         }
  26. # 创建configMap
  27. [root@master01 ~/configmap]# kubectl apply -f game-configmap.yaml
  28. configmap/game-demo created
  30. # 查看yaml文件
  31. [root@master01 ~/configmap]# kubectl get configmap game-demo -o yaml
  32. apiVersion: v1
  33. kind: ConfigMap
  34. metadata:
  35.   annotations:
  36.     kubectl.kubernetes.io/last-applied-configuration: |
  37.       {"apiVersion":"v1","data":{"game.properties":"enemy.types=aliens,monsters\nplayer.maximum-lives=5\n","nginx.conf":"server {\n    listen:80;\n    server_name:xxx;\n    root:/root;\n    location:{\n        xxx\n    }\n}\n","player_initial_lives":"3","ui_properties_file_name":"user-interface.properties"},"kind":"ConfigMap","metadata":{"annotations":{},"name":"game-demo","namespace":"default"}}
  38.   creationTimestamp: "2025-05-02T06:48:39Z"
  39.   name: game-demo
  40.   namespace: default
  41.   resourceVersion: "66094"
  42.   uid: d2f71bfb-5a8d-4cd4-b9fc-b490aef77f67
  43. data:
  44.   game.properties: |
  45.     enemy.types=aliens,monsters
  46.     player.maximum-lives=5
  47.   nginx.conf: |
  48.     server {
  49.         listen:80;
  50.         server_name:xxx;
  51.         root:/root;
  52.         location:{
  53.             xxx
  54.         }
  55.     }
  56.   player_initial_lives: "3"
  57.   ui_properties_file_name: user-interface.properties
  59. # 查看详细信息
  60. [root@master01 ~/configmap]# kubectl describe cm game-demo
  61. Name:         game-demo
  62. Namespace:    default
  63. Labels:       <none>
  64. Annotations:  <none>
  66. Data
  67. ====
  68. nginx.conf:
  69. ----
  70. server {
  71.     listen:80;
  72.     server_name:xxx;
  73.     root:/root;
  74.     location:{
  75.         xxx
  76.     }
  77. }
  79. player_initial_lives:
  80. ----
  81. 3
  82. ui_properties_file_name:
  83. ----
  84. user-interface.properties
  85. game.properties:
  86. ----
  87. enemy.types=aliens,monsters
  88. player.maximum-lives=5
  91. BinaryData
  92. ====
  94. Events:  <none>
复制代码
修改ConfigMap的值

ConfigMap无法修改名称，但是可以修改其值
通过kubectl方式修改

可以通过kubectl edit configmap configmapname来进行修改其值，使用kubectl命令之后，会打开一个类似vim的编辑界面，修改之后使用:wq保存之后即可
通过文件修改

修改了资源文件之后，configmap相同的key会进行覆盖，不同的key会进行添加，并不会进行删除多余的key
查看ConfigMap
  1. # 查看所有的ConfigMap
  2. [root@master01 ~]# kubectl get configmap -A
  3. NAMESPACE          NAME                                 DATA   AGE
  4. calico-apiserver   kube-root-ca.crt                     1      6d6h
  5. calico-system      active-operator                      1      6d6h
  6. calico-system      cni-config                           1      6d6h
  7. calico-system      kube-root-ca.crt                     1      6d6h
  8. calico-system      tigera-ca-bundle                     2      6d6h
  9. default            app-config                           2      4h39m
  10. default            db-config                            1      6h13m
  11. default            env-config                           3      5h17m
  13. # 查看指定命名空间下的ConfigMap
  14. [root@master01 ~]# kubectl get configmap -n calico-system
  15. NAME               DATA   AGE
  16. active-operator    1      6d6h
  17. cni-config         1      6d6h
  18. kube-root-ca.crt   1      6d6h
  19. tigera-ca-bundle   2      6d6h
  21. # 以yaml文件查看
  22. [root@master01 ~]# kubectl get configmap db-config -o yaml
  23. apiVersion: v1
  24. kind: ConfigMap
  25. metadata:
  26.   creationTimestamp: "2025-05-02T06:02:42Z"
  27.   name: db-config
  28.   namespace: default
  29.   resourceVersion: "59760"
  30.   uid: dc9de3eb-5e19-47fd-854d-2c4fcddbf8ba
  31. data:
  32.   db.properties: |
  33.     database.url=jdbc:mysql://localhost:3306/mydb
  34.     database.username=root
  35.     database.password=password
复制代码
删除ConfigMap

使用kubectl delete configmap [name1 name2 ... nameN]的方式删除即可
示例：
  1. [root@master01 ~]# kubectl delete configmap db-config
  2. configmap "db-config" deleted
  3. # 验证是否删除成功
  4. [root@master01 ~]# kubectl get configmap db-config
  5. Error from server (NotFound): configmaps "db-config" not found
复制代码
配置Pod使用ConfigMap

Pod使用ConfigMap资源，有两种方式，一种是通过环境变量的方式使用，另一种方式通过数据卷挂载的方式使用
注意：

  • 静态Pod不能使用ConfigMap
  • Pod 和 ConfigMap 必须要在同一个namespace中。
Pod通过环境变量使用ConfigMap

示例：
先创建ConfigMap
  1. # 创建ConfigMap
  2. [root@master01 ~]# echo 'apiVersion: v1
  3. kind: ConfigMap
  4. metadata:
  5.   name: special-config
  6. data:
  7.   USER_NAME: huangsir
  8.   APP: haha
  9.   COLOR: red
  10. ---
  11. apiVersion: v1
  12. kind: ConfigMap
  13. metadata:
  14.   name: env-config
  15.   namespace: default
  16. data:
  17.   USER_AGE: "18"
  18.   USER_NAME: zhangsan
  19.   USER_ADDR: beijing' | kubectl apply -f -
复制代码
将 ConfigMap 的内容用作Pod的环境变量：
  1. # 创建Pod
  2. [root@master01 ~/configmap]# echo 'apiVersion: v1
  3. kind: Pod
  4. metadata:
  5.   name: env-configmap-pod
  6. spec:
  7.   containers:
  8.     - name: app
  9.       # 打印环境变量
  10.       command: ["/bin/sh", "-c", "printenv"]
  11.       image: busybox:latest
  12.       # 指定env来自哪里
  13.       envFrom:
  14.         # 配置ConfigMap的引用
  15.         - configMapRef:
  16.             # 指定要引用的ConfigMap的名称
  17.             name: env-config' | kubectl apply -f -
  19. # 查看Pod的日志是否打印出配置的环境变量
  20. [root@master01 ~/configmap]# kubectl logs env-configmap-pod | grep USER
  21. USER_ADDR=beijing
  22. USER_AGE=18
  23. USER_NAME=zhangsan
复制代码
指定Pod的环境变量为ConfigMap中的Key

示例：
  1. # 创建Pod
  2. echo 'apiVersion: v1
  3. kind: Pod
  4. metadata:
  5.   name: env-configmap-pod-1
  6. spec:
  7.   containers:
  8.     - name: app
  9.       # 打印环境变量
  10.       command: ["/bin/sh", "-c", "printenv"]
  11.       image: busybox:latest
  12.       env:
  13.       # 指定Pod中环境变量的key
  14.       - name: POD-NAME
  15.         # 指定环境变量的value从哪里获取
  16.         valueFrom:
  17.           # 指定从ConfigMap中获取
  18.           configMapKeyRef:
  19.             # 指定ConfigMap的名称
  20.             name: special-config
  21.             # 指定ConfigMap中存在key
  22.             key: USER_NAME
  23.       # 可以定义多个值
  24.       - name: POD-ADDR
  25.         valueFrom:
  26.           configMapKeyRef:
  27.             name: env-config
  28.             key: USER_ADDR' | kubectl apply -f -
  30. # 查看日志中打印的环境变量
  31. [root@master01 ~/configmap]# kubectl logs env-configmap-pod-1 | grep POD
  32. POD-ADDR=beijing
  33. POD-NAME=huangsir
复制代码
Pod通过存储卷挂载使用ConfigMap的方式

创建ConfigMap
  1. [root@master01 ~/configmap]# echo 'apiVersion: v1
  2. kind: ConfigMap
  3. metadata:
  4.   name: app-config
  5. data:
  6.   config.properties: |
  7.     database.url=jdbc:mysql://localhost:3306/mydb
  8.     database.username=root
  9.     database.password=password
  10.   log.properties: |
  11.     log.level=INFO
  12.     log.file=/var/log/app.log' | kubectl apply -f -
复制代码
创建Pod挂载ConfigMap

方式一：将ConfigMap中所有的Key挂载到Pod指定的路径下，这种方式有以下几个地方需要注意：

  • 如果Pod挂载所在的目录中有其它的文件或目录，会将其删除
  • 如果指定Pod挂载的目录不存在，会自动创建
  • 挂载时会自动创建对应ConfigMap中的文件
示例：
  1. # 创建Pod
  2. echo 'apiVersion: v1
  3. kind: Pod
  4. metadata:
  5.   name: volume-pod-1
  6. spec:
  7.   containers:
  8.     - name: app
  9.       image: nginx:latest
  10.       # 存储卷挂载到本地
  11.       volumeMounts:
  12.       # Pod存储卷挂载的名称
  13.       - name: config-volume
  14.         mountPath: /etc/config
  15.   volumes:
  16.   - name: config-volume
  17.     # 存储卷挂载的类型
  18.     configMap:
  19.       name: app-config' | kubectl apply -f -
  20.           
  21. # 验证挂载路径
  22. [root@master01 ~/configmap]# kubectl exec -it volume-pod-1 -- ls -l /etc/config
  23. total 0
  24. lrwxrwxrwx 1 root root 24 May  2 07:50 config.properties -> ..data/config.properties
  25. lrwxrwxrwx 1 root root 21 May  2 07:50 log.properties -> ..data/log.properties
复制代码
如果只想挂载ConfigMap中的部分键，并且指定挂载到Pod中的文件名，可以使用items和subPath字段来实现
示例：
  1. # 创建Pod
  2. [root@master01 ~/configmap]# echo 'apiVersion: v1
  3. kind: Pod
  4. metadata:
  5.   name: volume-pod-2
  6. spec:
  7.   containers:
  8.     - name: app
  9.       image: nginx:latest
  10.       # 存储卷挂载到本地
  11.       volumeMounts:
  12.       # Pod存储卷挂载的名称
  13.       - name: config-volume
  14.         mountPath: /etc/config/log-custom.properties
  15.         # 当使用subPath属性时，则mountPath执行的不是目录，而是文件
  16.         # 必要条件：一定要让subPath的值和items列表中的path值相同
  17.         subPath: log-custom.properties
  18.   volumes:
  19.   - name: config-volume
  20.     # 存储卷挂载的类型
  21.     configMap:
  22.       name: app-config
  23.       items:
  24.       - key: log.properties
  25.         path: log-custom.properties' | kubectl apply -f -
  27. # 验证
  28. [root@master01 ~/configmap]# kubectl exec -it volume-pod-2 -- cat /etc/config/log-custom.properties
  29. log.level=INFO
  30. log.file=/var/log/app.log
复制代码
配置不可变更的 ConfigMap

Kubernetes v1.21的版本中提供了一种将各个 Secret 和 ConfigMap 设置为不可变更的选项。
对于大量使用 ConfigMap 的集群 （至少有数万个各不相同的 ConfigMap 给 Pod 挂载）而言，禁止更改 ConfigMap 的数据有以下好处：

  • 保护应用，使之免受意外（不想要的）更新所带来的负面影响。
  • 通过大幅降低对 kube-apiserver 的压力提升集群性能， 这是因为系统会关闭对已标记为不可变更的 ConfigMap 的监视操作。
实现方式：
  1. # 通过将 immutable 字段设置为 true 创建不可变更的 ConfigMap
  2. apiVersion: v1
  3. kind: ConfigMap
  4. metadata:
  5.   ...
  6. data:
  7.   ...
  8. immutable: true
复制代码
一旦某 ConfigMap 被标记为不可变更，则 无法 逆转这一变化，也无法更改 data 或 binaryData 字段的内容。你只能删除并重建 ConfigMap。 因为现有的 Pod 会维护一个已被删除的 ConfigMap 的挂载点，建议重新创建这些 Pods。
挂载的 ConfigMap 内容会被自动更新

当Pod中使用的 ConfigMap 被更新时，所对应的Pod中对应Key也会被更新。
kubelet 组件会在每次周期性同步时检查所挂载的 ConfigMap 是否为最新。不过，kubelet 使用的是其本地的高速缓存来获得 ConfigMap 的当前值。 高速缓存的类型可以通过 KubeletConfiguration.configMapAndSecretChangeDetectionStrategy 字段来配置。
注意以下两种方式不会被更新，需要重启Pod：

  • 以环境变量方式使用的 ConfigMap 数据不会被自动更新。
  • 使用 ConfigMap 作为 subPath 卷挂载的容器将不会收到 ConfigMap 的更新。
示例：以上述Pod通过存储卷挂载使用ConfigMap的方式来验证
  1. # 修改ConfigMap前的挂载内容
  2. # pod1的内容，以普通数据卷的挂载方式
  3. [root@master01 ~]# kubectl exec -it volume-pod-1 -- cat /etc/config/log.properties
  4. log.level=INFO
  5. log.file=/var/log/app.log
  6. # pod2的内容，以subPath的挂载方式
  7. [root@master01 ~]# kubectl exec -it volume-pod-2 -- cat /etc/config/log-custom.properties
  8. log.level=INFO
  9. log.file=/var/log/app.log
  11. # 修改ConfigMap
  12. [root@master01 ~]# echo 'apiVersion: v1
  13. kind: ConfigMap
  14. metadata:
  15.   name: app-config
  16. data:
  17.   config.properties: |
  18.     database.url=jdbc:mysql://localhost:3306/mydb
  19.     database.username=root
  20.     database.password=password
  21.   log.properties: |
  22.     log.level=error
  23.     log.file=/var/log/error.log' | kubectl apply -f -
  25. # 验证是否修改成功
  26. [root@master01 ~]# kubectl describe cm app-config
  27. Name:         app-config
  28. Namespace:    default
  29. Labels:       <none>
  30. Annotations:  <none>
  32. Data
  33. ====
  34. config.properties:
  35. ----
  36. database.url=jdbc:mysql://localhost:3306/mydb
  37. database.username=root
  38. database.password=password
  40. log.properties:
  41. ----
  42. log.level=error
  43. log.file=/var/log/error.log
  46. BinaryData
  47. ====
  49. Events:  <none>
  51. # 验证Pod内部是否自动更新
  52. # pod1更新成功，
  53. [root@master01 ~]# kubectl exec -it volume-pod-1 -- cat /etc/config/log.properties
  54. log.level=error
  55. log.file=/var/log/error.log
  56. # pod2未更新
  57. [root@master01 ~]# kubectl exec -it volume-pod-2 -- cat /etc/config/log-custom.properties
  58. log.level=INFO
  59. log.file=/var/log/app.log
复制代码
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
K8s新手系列ConfigMap资源

使用道具 举报

相关推荐
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
蓟晓彤
2025-6-3 10:39:39

0

粉丝关注

16

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫