通过 ConfigMap 更新配置

本页提供了通过 ConfigMap 更新 Pod 中配置信息的分步示例, 本教程的前置任务是配置 Pod 以使用 ConfigMap
在本教程结束时,你将了解如何变更运行中应用的配置。 本教程以 alpinenginx 镜像为例。

准备开始

你必须拥有一个 Kubernetes 的集群,且必须配置 kubectl 命令行工具让其与你的集群通信。 建议运行本教程的集群至少有两个节点,且这两个节点不能作为控制平面主机。 如果你还没有集群,你可以通过 Minikube 构建一个你自己的集群,或者你可以使用下面的 Kubernetes 练习环境之一:

你需要有 curl 命令行工具,用于从终端或命令行界面发出 HTTP 请求。 如果你没有 curl,可以安装此工具。请查阅你本地操作系统的文档。

教程目标

  • 通过作为卷挂载的 ConfigMap 更新配置
  • 通过 ConfigMap 更新 Pod 的环境变量
  • 在多容器 Pod 中通过 ConfigMap 更新配置
  • 在包含边车容器的 Pod 中通过 ConfigMap 更新配置

通过作为卷挂载的 ConfigMap 更新配置

使用 kubectl create configmap 命令基于字面值创建一个 ConfigMap:

  1. kubectl create configmap sport --from-literal=sport=football

下面是一个 Deployment 清单示例,其中 ConfigMap sport 作为挂载到 Pod 的唯一容器中。

  1. deployments/deployment-with-configmap-as-volume.yaml
  1. apiVersion: apps/v1
  2. kind: Deployment
  3. metadata:
  4. name: configmap-volume
  5. labels:
  6. app.kubernetes.io/name: configmap-volume
  7. spec:
  8. replicas: 3
  9. selector:
  10. matchLabels:
  11. app.kubernetes.io/name: configmap-volume
  12. template:
  13. metadata:
  14. labels:
  15. app.kubernetes.io/name: configmap-volume
  16. spec:
  17. containers:
  18. - name: alpine
  19. image: alpine:3
  20. command:
  21. - /bin/sh
  22. - -c
  23. - while true; do echo "$(date) My preferred sport is $(cat /etc/config/sport)";
  24. sleep 10; done;
  25. ports:
  26. - containerPort: 80
  27. volumeMounts:
  28. - name: config-volume
  29. mountPath: /etc/config
  30. volumes:
  31. - name: config-volume
  32. configMap:
  33. name: sport

创建此 Deployment:

  1. kubectl apply -f https://k8s.io/examples/deployments/deployment-with-configmap-as-volume.yaml

检查此 Deployment 的 Pod 以确保它们已就绪(通过选择算符进行匹配):

  1. kubectl get pods --selector=app.kubernetes.io/name=configmap-volume

你应该会看到类似以下的输出:

  1. NAME READY STATUS RESTARTS AGE
  2. configmap-volume-6b976dfdcf-qxvbm 1/1 Running 0 72s
  3. configmap-volume-6b976dfdcf-skpvm 1/1 Running 0 72s
  4. configmap-volume-6b976dfdcf-tbc6r 1/1 Running 0 72s

在运行这些 Pod 之一的每个节点上,kubelet 获取该 ConfigMap 的数据,并将其转换为本地卷中的文件。 然后,kubelet 按照 Pod 模板中指定的方式将该卷挂载到容器中。 在该容器中运行的代码从文件中加载信息,并使用它将报告打印到标准输出。 你可以通过查看该 Deployment 中其中一个 Pod 的日志来检查此报告:

  1. # 选择一个属于该 Deployment 的 Pod,并查看其日志
  2. kubectl logs deployments/configmap-volume

你应该会看到类似以下的输出:

  1. Found 3 pods, using pod/configmap-volume-76d9c5678f-x5rgj
  2. Thu Jan 4 14:06:46 UTC 2024 My preferred sport is football
  3. Thu Jan 4 14:06:56 UTC 2024 My preferred sport is football
  4. Thu Jan 4 14:07:06 UTC 2024 My preferred sport is football
  5. Thu Jan 4 14:07:16 UTC 2024 My preferred sport is football
  6. Thu Jan 4 14:07:26 UTC 2024 My preferred sport is football

编辑 ConfigMap:

  1. kubectl edit configmap sport

在出现的编辑器中,将键 sport 的值从 football 变更为 cricket。 保存你的变更。kubectl 工具会相应地更新 ConfigMap(如果报错,请重试)。

以下是你编辑后该清单可能的样子:

  1. apiVersion: v1
  2. data:
  3. sport: cricket
  4. kind: ConfigMap
  5. # 你可以保留现有的 metadata 不变。
  6. # 你将看到的值与本例的值不会完全一样。
  7. metadata:
  8. creationTimestamp: "2024-01-04T14:05:06Z"
  9. name: sport
  10. namespace: default
  11. resourceVersion: "1743935"
  12. uid: 024ee001-fe72-487e-872e-34d6464a8a23

你应该会看到以下输出:

  1. configmap/sport edited

查看属于此 Deployment 的 Pod 之一的日志(并跟踪最新写入的条目):

  1. kubectl logs deployments/configmap-volume --follow

几秒钟后,你应该会看到日志输出中的如下变化:

  1. Thu Jan 4 14:11:36 UTC 2024 My preferred sport is football
  2. Thu Jan 4 14:11:46 UTC 2024 My preferred sport is football
  3. Thu Jan 4 14:11:56 UTC 2024 My preferred sport is football
  4. Thu Jan 4 14:12:06 UTC 2024 My preferred sport is cricket
  5. Thu Jan 4 14:12:16 UTC 2024 My preferred sport is cricket

当你有一个 ConfigMap 通过 configMap 卷或 projected 卷映射到运行中的 Pod, 并且你更新了该 ConfigMap 时,运行中的 Pod 几乎会立即更新。
但是,你的应用只有在编写为轮询变更或监视文件更新时才能看到变更。
启动时一次性加载其配置的应用将不会注意到变更。

说明:

从更新 ConfigMap 的那一刻到将新的键投射到 Pod 的那一刻,整个延迟可能与 kubelet 同步周期相同。 另请参阅挂载的 ConfigMap 会被自动更新

通过 ConfigMap 更新 Pod 的环境变量

使用 kubectl create configmap 命令基于字面值创建一个 ConfigMap:

  1. kubectl create configmap fruits --from-literal=fruits=apples

下面是一个 Deployment 清单的示例,包含一个通过 ConfigMap fruits 配置的环境变量。

  1. deployments/deployment-with-configmap-as-envvar.yaml
  1. apiVersion: apps/v1
  2. kind: Deployment
  3. metadata:
  4. name: configmap-env-var
  5. labels:
  6. app.kubernetes.io/name: configmap-env-var
  7. spec:
  8. replicas: 3
  9. selector:
  10. matchLabels:
  11. app.kubernetes.io/name: configmap-env-var
  12. template:
  13. metadata:
  14. labels:
  15. app.kubernetes.io/name: configmap-env-var
  16. spec:
  17. containers:
  18. - name: alpine
  19. image: alpine:3
  20. env:
  21. - name: FRUITS
  22. valueFrom:
  23. configMapKeyRef:
  24. key: fruits
  25. name: fruits
  26. command:
  27. - /bin/sh
  28. - -c
  29. - while true; do echo "$(date) The basket is full of $FRUITS";
  30. sleep 10; done;
  31. ports:
  32. - containerPort: 80

创建此 Deployment:

  1. kubectl apply -f https://k8s.io/examples/deployments/deployment-with-configmap-as-envvar.yaml

检查此 Deployment 的 Pod 以确保它们已就绪(通过选择算符进行匹配):

  1. kubectl get pods --selector=app.kubernetes.io/name=configmap-env-var

你应该会看到类似以下的输出:

  1. NAME READY STATUS RESTARTS AGE
  2. configmap-env-var-59cfc64f7d-74d7z 1/1 Running 0 46s
  3. configmap-env-var-59cfc64f7d-c4wmj 1/1 Running 0 46s
  4. configmap-env-var-59cfc64f7d-dpr98 1/1 Running 0 46s

ConfigMap 中的键值对被配置为 Pod 容器中的环境变量。 通过查看属于该 Deployment 的某个 Pod 的日志来检查这一点。

  1. kubectl logs deployment/configmap-env-var

你应该会看到类似以下的输出:

  1. Found 3 pods, using pod/configmap-env-var-7c994f7769-l74nq
  2. Thu Jan 4 16:07:06 UTC 2024 The basket is full of apples
  3. Thu Jan 4 16:07:16 UTC 2024 The basket is full of apples
  4. Thu Jan 4 16:07:26 UTC 2024 The basket is full of apples

编辑 ConfigMap:

  1. kubectl edit configmap fruits

在出现的编辑器中,将键 fruits 的值从 apples 变更为 mangoes。 保存你的变更。kubectl 工具会相应地更新 ConfigMap(如果报错,请重试)。

以下是你编辑后该清单可能的样子:

  1. apiVersion: v1
  2. data:
  3. fruits: mangoes
  4. kind: ConfigMap
  5. # 你可以保留现有的 metadata 不变。
  6. # 你将看到的值与本例的值不会完全一样。
  7. metadata:
  8. creationTimestamp: "2024-01-04T16:04:19Z"
  9. name: fruits
  10. namespace: default
  11. resourceVersion: "1749472"

你应该看到以下输出:

  1. configmap/fruits edited

查看此 Deployment 的日志,并观察几秒钟的输出:

  1. # 如上所述,输出不会有变化
  2. kubectl logs deployments/configmap-env-var --follow

请注意,即使你编辑了 ConfigMap,输出仍然没有变化

  1. Thu Jan 4 16:12:56 UTC 2024 The basket is full of apples
  2. Thu Jan 4 16:13:06 UTC 2024 The basket is full of apples
  3. Thu Jan 4 16:13:16 UTC 2024 The basket is full of apples
  4. Thu Jan 4 16:13:26 UTC 2024 The basket is full of apples

说明:

尽管 ConfigMap 中的键的取值已经变更,Pod 中的环境变量仍然显示先前的值。 这是因为当源数据变更时,在 Pod 内运行的进程的环境变量不会被更新; 如果你想强制更新,需要让 Kubernetes 替换现有的 Pod。新 Pod 将使用更新的信息来运行。

你可以触发该替换。使用 kubectl rollout 为 Deployment 执行上线操作:

  1. # 触发上线操作
  2. kubectl rollout restart deployment configmap-env-var
  3. # 等待上线操作完成
  4. kubectl rollout status deployment configmap-env-var --watch=true

接下来,检查 Deployment:

  1. kubectl get deployment configmap-env-var

你应该会看到类似以下的输出:

  1. NAME READY UP-TO-DATE AVAILABLE AGE
  2. configmap-env-var 3/3 3 3 12m

检查 Pod:

  1. kubectl get pods --selector=app.kubernetes.io/name=configmap-env-var

上线操作会导致 Kubernetes 为 Deployment 新建一个 ReplicaSet; 这意味着现有的 Pod 最终会终止,并创建新的 Pod。几秒钟后,你应该会看到类似以下的输出:

  1. NAME READY STATUS RESTARTS AGE
  2. configmap-env-var-6d94d89bf5-2ph2l 1/1 Running 0 13s
  3. configmap-env-var-6d94d89bf5-74twx 1/1 Running 0 8s
  4. configmap-env-var-6d94d89bf5-d5vx8 1/1 Running 0 11s

说明:

请等待旧的 Pod 完全终止后再进行下一步。

查看此 Deployment 中某个 Pod 的日志:

  1. # 选择属于 Deployment 的一个 Pod,并查看其日志
  2. kubectl logs deployment/configmap-env-var

你应该会看到类似以下的输出:

  1. Found 3 pods, using pod/configmap-env-var-6d9ff89fb6-bzcf6
  2. Thu Jan 4 16:30:35 UTC 2024 The basket is full of mangoes
  3. Thu Jan 4 16:30:45 UTC 2024 The basket is full of mangoes
  4. Thu Jan 4 16:30:55 UTC 2024 The basket is full of mangoes

这个场景演示了在 Pod 中如何更新从 ConfigMap 派生的环境变量。ConfigMap 值的变更在随后的上线操作期间被应用到 Pod。如果 Pod 由于其他原因(例如 Deployment 扩容)被创建, 那么新 Pod 也会使用最新的配置值; 如果你不触发上线操作,你可能会发现你的应用在运行过程中混用了新旧环境变量值。

在多容器 Pod 中通过 ConfigMap 更新配置

使用 kubectl create configmap 命令基于字面值创建一个 ConfigMap:

  1. kubectl create configmap color --from-literal=color=red

下面是一个 Deployment 清单的示例,该 Deployment 管理一组 Pod,每个 Pod 有两个容器。 这两个容器共享一个 emptyDir 卷并使用此卷进行通信。第一个容器运行 Web 服务器(nginx)。 在 Web 服务器容器中共享卷的挂载路径是 /usr/share/nginx/html。 第二个辅助容器基于 alpine,对于这个容器,emptyDir 卷被挂载在 /pod-data。 辅助容器生成一个 HTML 文件,其内容基于 ConfigMap。Web 服务器容器通过 HTTP 提供此 HTML 文件。

  1. deployments/deployment-with-configmap-two-containers.yaml
  1. apiVersion: apps/v1
  2. kind: Deployment
  3. metadata:
  4. name: configmap-two-containers
  5. labels:
  6. app.kubernetes.io/name: configmap-two-containers
  7. spec:
  8. replicas: 3
  9. selector:
  10. matchLabels:
  11. app.kubernetes.io/name: configmap-two-containers
  12. template:
  13. metadata:
  14. labels:
  15. app.kubernetes.io/name: configmap-two-containers
  16. spec:
  17. volumes:
  18. - name: shared-data
  19. emptyDir: {}
  20. - name: config-volume
  21. configMap:
  22. name: color
  23. containers:
  24. - name: nginx
  25. image: nginx
  26. volumeMounts:
  27. - name: shared-data
  28. mountPath: /usr/share/nginx/html
  29. - name: alpine
  30. image: alpine:3
  31. volumeMounts:
  32. - name: shared-data
  33. mountPath: /pod-data
  34. - name: config-volume
  35. mountPath: /etc/config
  36. command:
  37. - /bin/sh
  38. - -c
  39. - while true; do echo "$(date) My preferred color is $(cat /etc/config/color)" > /pod-data/index.html;
  40. sleep 10; done;

创建此 Deployment:

  1. kubectl apply -f https://k8s.io/examples/deployments/deployment-with-configmap-two-containers.yaml

检查此 Deployment 的 Pod 以确保它们已就绪(通过选择算符进行匹配):

  1. kubectl get pods --selector=app.kubernetes.io/name=configmap-two-containers

你应该会看到类似以下的输出:

  1. NAME READY STATUS RESTARTS AGE
  2. configmap-two-containers-565fb6d4f4-2xhxf 2/2 Running 0 20s
  3. configmap-two-containers-565fb6d4f4-g5v4j 2/2 Running 0 20s
  4. configmap-two-containers-565fb6d4f4-mzsmf 2/2 Running 0 20s

公开 Deployment(kubectl 工具会为你创建 Service):

  1. kubectl expose deployment configmap-two-containers --name=configmap-service --port=8080 --target-port=80

使用 kubectl 转发端口:

  1. # 此命令将在后台运行
  2. kubectl port-forward service/configmap-service 8080:8080 &

访问服务:

  1. curl http://localhost:8080

你应该会看到类似以下的输出:

  1. Fri Jan 5 08:08:22 UTC 2024 My preferred color is red

编辑 ConfigMap:

  1. kubectl edit configmap color

在出现的编辑器中,将键 color 的值从 red 变更为 blue。 保存你的变更。kubectl 工具会相应地更新 ConfigMap(如果报错,请重试)。

以下是你编辑后该清单可能的样子:

  1. apiVersion: v1
  2. data:
  3. color: blue
  4. kind: ConfigMap
  5. # 你可以保留现有的 metadata 不变。
  6. # 你将看到的值与本例的值不会完全一样。
  7. metadata:
  8. creationTimestamp: "2024-01-05T08:12:05Z"
  9. name: color
  10. namespace: configmap
  11. resourceVersion: "1801272"
  12. uid: 80d33e4a-cbb4-4bc9-ba8c-544c68e425d6

循环访问服务 URL 几秒钟。

  1. # 当你满意时可以取消此操作 (Ctrl-C)
  2. while true; do curl --connect-timeout 7.5 http://localhost:8080; sleep 10; done

你应该会看到如下的输出变化:

  1. Fri Jan 5 08:14:00 UTC 2024 My preferred color is red
  2. Fri Jan 5 08:14:02 UTC 2024 My preferred color is red
  3. Fri Jan 5 08:14:20 UTC 2024 My preferred color is red
  4. Fri Jan 5 08:14:22 UTC 2024 My preferred color is red
  5. Fri Jan 5 08:14:32 UTC 2024 My preferred color is blue
  6. Fri Jan 5 08:14:43 UTC 2024 My preferred color is blue
  7. Fri Jan 5 08:15:00 UTC 2024 My preferred color is blue

在包含边车容器的 Pod 中通过 ConfigMap 更新配置

要重现上述场景,可以使用边车容器作为辅助容器来写入 HTML 文件。
由于边车容器在概念上是一个 Init 容器,因此保证会在主要 Web 服务器容器启动之前启动。
这确保了当 Web 服务器准备好提供服务时,HTML 文件始终可用。
请参阅启用边车容器以使用此特性。

如果你从前一个场景继续操作,你可以在此场景中重用名为 color 的 ConfigMap。
如果你是独立执行此场景,请使用 kubectl create configmap 命令基于字面值创建一个 ConfigMap:

  1. kubectl create configmap color --from-literal=color=blue

以下是一个 Deployment 清单示例,该 Deployment 管理一组 Pod,每个 Pod 有一个主容器和一个边车容器。 这两个容器共享一个 emptyDir 卷并使用此卷来通信。主容器运行 Web 服务器(NGINX)。 在 Web 服务器容器中共享卷的挂载路径是 /usr/share/nginx/html。 第二个容器是基于 Alpine Linux 作为辅助容器的边车容器。对于这个辅助容器,emptyDir 卷被挂载在 /pod-data。 边车容器写入一个 HTML 文件,其内容基于 ConfigMap。Web 服务器容器通过 HTTP 提供此 HTML 文件。

  1. deployments/deployment-with-configmap-and-sidecar-container.yaml
  1. apiVersion: apps/v1
  2. kind: Deployment
  3. metadata:
  4. name: configmap-sidecar-container
  5. labels:
  6. app.kubernetes.io/name: configmap-sidecar-container
  7. spec:
  8. replicas: 3
  9. selector:
  10. matchLabels:
  11. app.kubernetes.io/name: configmap-sidecar-container
  12. template:
  13. metadata:
  14. labels:
  15. app.kubernetes.io/name: configmap-sidecar-container
  16. spec:
  17. volumes:
  18. - name: shared-data
  19. emptyDir: {}
  20. - name: config-volume
  21. configMap:
  22. name: color
  23. containers:
  24. - name: nginx
  25. image: nginx
  26. volumeMounts:
  27. - name: shared-data
  28. mountPath: /usr/share/nginx/html
  29. initContainers:
  30. - name: alpine
  31. image: alpine:3
  32. restartPolicy: Always
  33. volumeMounts:
  34. - name: shared-data
  35. mountPath: /pod-data
  36. - name: config-volume
  37. mountPath: /etc/config
  38. command:
  39. - /bin/sh
  40. - -c
  41. - while true; do echo "$(date) My preferred color is $(cat /etc/config/color)" > /pod-data/index.html;
  42. sleep 10; done;

创建此 Deployment:

  1. kubectl apply -f https://k8s.io/examples/deployments/deployment-with-configmap-and-sidecar-container.yaml

检查此 Deployment 的 Pod 以确保它们已就绪(通过选择算符进行匹配):

  1. kubectl get pods --selector=app.kubernetes.io/name=configmap-sidecar-container

你应该会看到类似以下的输出:

  1. NAME READY STATUS RESTARTS AGE
  2. configmap-sidecar-container-5fb59f558b-87rp7 2/2 Running 0 94s
  3. configmap-sidecar-container-5fb59f558b-ccs7s 2/2 Running 0 94s
  4. configmap-sidecar-container-5fb59f558b-wnmgk 2/2 Running 0 94s

公开 Deployment(kubectl 工具会为你创建一个 Service):

  1. kubectl expose deployment configmap-sidecar-container --name=configmap-sidecar-service --port=8081 --target-port=80

使用 kubectl 转发端口:

  1. # 此命令将在后台运行
  2. kubectl port-forward service/configmap-sidecar-service 8081:80 &

访问服务:

  1. curl http://localhost:8081

你应该看到类似以下的输出:

  1. Sat Feb 17 13:09:05 UTC 2024 My preferred color is blue

编辑 ConfigMap:

  1. kubectl edit configmap color

在出现的编辑器中,将键 color 的值从 blue 变更为 green。 保存你的变更。kubectl 工具会相应地更新 ConfigMap(如果报错,请重试)。

以下是你编辑后该清单可能的样子:

  1. apiVersion: v1
  2. data:
  3. color: green
  4. kind: ConfigMap
  5. # 你可以保留现有的 metadata 不变。
  6. # 你将看到的值与本例的值不会完全一样。
  7. metadata:
  8. creationTimestamp: "2024-02-17T12:20:30Z"
  9. name: color
  10. namespace: default
  11. resourceVersion: "1054"
  12. uid: e40bb34c-58df-4280-8bea-6ed16edccfaa

循环访问服务 URL 几秒钟。

  1. # 当你满意时可以取消此操作 (Ctrl-C)
  2. while true; do curl --connect-timeout 7.5 http://localhost:8081; sleep 10; done

你应该会看到如下的输出变化:

  1. Sat Feb 17 13:12:35 UTC 2024 My preferred color is blue
  2. Sat Feb 17 13:12:45 UTC 2024 My preferred color is blue
  3. Sat Feb 17 13:12:55 UTC 2024 My preferred color is blue
  4. Sat Feb 17 13:13:05 UTC 2024 My preferred color is blue
  5. Sat Feb 17 13:13:15 UTC 2024 My preferred color is green
  6. Sat Feb 17 13:13:25 UTC 2024 My preferred color is green
  7. Sat Feb 17 13:13:35 UTC 2024 My preferred color is green

通过作为卷挂载的不可变 ConfigMap 更新配置

说明:

不可变 ConfigMap 专门用于恒定且预期不会随时间变化的配置。 将 ConfigMap 标记为不可变可以提高性能,因为 kubelet 不会监视变更。

如果你确实需要进行变更,你应计划:

  • 变更 ConfigMap 的名称,并转而运行引用新名称的 Pod
  • 替换集群中之前运行使用旧值的 Pod 的所有节点
  • 在任何之前加载过旧 ConfigMap 的节点上重新启动 kubelet

以下是一个不可变 ConfigMap的示例清单。

  1. configmap/immutable-configmap.yaml
  1. apiVersion: v1
  2. data:
  3. company_name: "ACME, Inc." # 虚构的公司名称
  4. kind: ConfigMap
  5. immutable: true
  6. metadata:
  7. name: company-name-20150801

创建不可变 ConfigMap:

  1. kubectl apply -f https://k8s.io/examples/configmap/immutable-configmap.yaml

下面是一个 Deployment 清单示例,其中不可变 ConfigMap company-name-20150801 作为挂载到 Pod 的唯一容器中。

  1. deployments/deployment-with-immutable-configmap-as-volume.yaml
  1. apiVersion: apps/v1
  2. kind: Deployment
  3. metadata:
  4. name: immutable-configmap-volume
  5. labels:
  6. app.kubernetes.io/name: immutable-configmap-volume
  7. spec:
  8. replicas: 3
  9. selector:
  10. matchLabels:
  11. app.kubernetes.io/name: immutable-configmap-volume
  12. template:
  13. metadata:
  14. labels:
  15. app.kubernetes.io/name: immutable-configmap-volume
  16. spec:
  17. containers:
  18. - name: alpine
  19. image: alpine:3
  20. command:
  21. - /bin/sh
  22. - -c
  23. - while true; do echo "$(date) The name of the company is $(cat /etc/config/company_name)";
  24. sleep 10; done;
  25. ports:
  26. - containerPort: 80
  27. volumeMounts:
  28. - name: config-volume
  29. mountPath: /etc/config
  30. volumes:
  31. - name: config-volume
  32. configMap:
  33. name: company-name-20150801

创建此 Deployment:

  1. kubectl apply -f https://k8s.io/examples/deployments/deployment-with-immutable-configmap-as-volume.yaml

检查此 Deployment 的 Pod 以确保它们已就绪(通过选择算符进行匹配):

  1. kubectl get pods --selector=app.kubernetes.io/name=immutable-configmap-volume

你应该看到类似以下的输出:

  1. NAME READY STATUS RESTARTS AGE
  2. immutable-configmap-volume-78b6fbff95-5gsfh 1/1 Running 0 62s
  3. immutable-configmap-volume-78b6fbff95-7vcj4 1/1 Running 0 62s
  4. immutable-configmap-volume-78b6fbff95-vdslm 1/1 Running 0 62s

Pod 的容器引用 ConfigMap 中所定义的数据,并使用它将报告打印到标准输出。 你可以通过查看 Deployment 中某个 Pod 的日志来检查此报告:

  1. # 选择属于该 Deployment 的一个 Pod,并查看其日志
  2. kubectl logs deployments/immutable-configmap-volume

你应该会看到类似以下的输出:

  1. Found 3 pods, using pod/immutable-configmap-volume-78b6fbff95-5gsfh
  2. Wed Mar 20 03:52:34 UTC 2024 The name of the company is ACME, Inc.
  3. Wed Mar 20 03:52:44 UTC 2024 The name of the company is ACME, Inc.
  4. Wed Mar 20 03:52:54 UTC 2024 The name of the company is ACME, Inc.

说明:

一旦 ConfigMap 被标记为不可变,就无法撤销此变更,也无法修改 databinaryData 字段的内容。
为了修改使用此配置的 Pod 的行为,你需要创建一个新的不可变 ConfigMap,并编辑 Deployment 以定义一个稍有不同的 Pod 模板,引用新的 ConfigMap。

通过使用下面所示的清单创建一个新的不可变 ConfigMap:

  1. configmap/new-immutable-configmap.yaml
  1. apiVersion: v1
  2. data:
  3. company_name: "Fiktivesunternehmen GmbH" # 虚构的公司名称
  4. kind: ConfigMap
  5. immutable: true
  6. metadata:
  7. name: company-name-20240312
  1. kubectl apply -f https://k8s.io/examples/configmap/new-immutable-configmap.yaml

你应该看到类似以下的输出:

  1. configmap/company-name-20240312 created

检查新建的 ConfigMap:

  1. kubectl get configmap

你应该看到输出会同时显示新旧 ConfigMap:

  1. NAME DATA AGE
  2. company-name-20150801 1 22m
  3. company-name-20240312 1 24s

修改 Deployment 以引用新的 ConfigMap。

编辑 Deployment:

  1. kubectl edit deployment immutable-configmap-volume

在出现的编辑器中,更新现有的卷定义以使用新的 ConfigMap。

  1. volumes:
  2. - configMap:
  3. defaultMode: 420
  4. name: company-name-20240312 # 更新此字段
  5. name: config-volume

你应该看到以下输出:

  1. deployment.apps/immutable-configmap-volume edited

这将触发一次上线操作。等待所有先前的 Pod 终止并且新的 Pod 处于就绪状态。

监控 Pod 的状态:

  1. kubectl get pods --selector=app.kubernetes.io/name=immutable-configmap-volume
  1. NAME READY STATUS RESTARTS AGE
  2. immutable-configmap-volume-5fdb88fcc8-29v8n 1/1 Running 0 13s
  3. immutable-configmap-volume-5fdb88fcc8-52ddd 1/1 Running 0 14s
  4. immutable-configmap-volume-5fdb88fcc8-n5jx4 1/1 Running 0 15s
  5. immutable-configmap-volume-78b6fbff95-5gsfh 1/1 Terminating 0 32m
  6. immutable-configmap-volume-78b6fbff95-7vcj4 1/1 Terminating 0 32m
  7. immutable-configmap-volume-78b6fbff95-vdslm 1/1 Terminating 0 32m

最终,你应该会看到类似以下的输出:

  1. NAME READY STATUS RESTARTS AGE
  2. immutable-configmap-volume-5fdb88fcc8-29v8n 1/1 Running 0 43s
  3. immutable-configmap-volume-5fdb88fcc8-52ddd 1/1 Running 0 44s
  4. immutable-configmap-volume-5fdb88fcc8-n5jx4 1/1 Running 0 45s

查看此 Deployment 中某个 Pod 的日志:

  1. # 选择属于此 Deployment 的一个 Pod,并查看其日志
  2. kubectl logs deployment/immutable-configmap-volume

你应该会看到类似下面的输出:

  1. Found 3 pods, using pod/immutable-configmap-volume-5fdb88fcc8-n5jx4
  2. Wed Mar 20 04:24:17 UTC 2024 The name of the company is Fiktivesunternehmen GmbH
  3. Wed Mar 20 04:24:27 UTC 2024 The name of the company is Fiktivesunternehmen GmbH
  4. Wed Mar 20 04:24:37 UTC 2024 The name of the company is Fiktivesunternehmen GmbH

建议一旦所有 Deployment 都迁移到使用新的不可变 ConfigMap,删除旧的 ConfigMap。

  1. kubectl delete configmap company-name-20150801

总结

在 Pod 上作为卷挂载的 ConfigMap 所发生的变更将在后续的 kubelet 同步后无缝生效。

配置为 Pod 环境变量的 ConfigMap 所发生变更将在后续的 Pod 上线操作后生效。

一旦 ConfigMap 被标记为不可变,就无法撤销此变更(你不能将不可变的 ConfigMap 改为可变), 并且你也不能对 databinaryData 字段的内容进行任何变更。你可以删除并重新创建 ConfigMap, 或者你可以创建一个新的不同的 ConfigMap。当你删除 ConfigMap 时, 运行中的容器及其 Pod 将保持对引用了现有 ConfigMap 的任何卷的挂载点。

清理现场

终止正在运行的 kubectl port-forward 命令。

删除以上教程中所创建的资源:

  1. kubectl delete deployment configmap-volume configmap-env-var configmap-two-containers configmap-sidecar-container immutable-configmap-volume
  2. kubectl delete service configmap-service configmap-sidecar-service
  3. kubectl delete configmap sport fruits color company-name-20240312
  4. kubectl delete configmap company-name-20150801 # 如果在任务执行期间未被处理