配置 Pod 使用 ConfigMap

许多应用程序依赖于配置，这些配置在应用程序初始化或运行时使用。大多数情况下，需要调整分配给配置参数的值。ConfigMap 是 Kubernetes 中的一种机制，允许您将配置数据注入应用程序 Pod 中。

ConfigMap 概念允许您将配置工件与镜像内容分离，以保持容器化应用程序的可移植性。例如，您可以下载并运行相同的 容器镜像 来启动容器，用于本地开发、系统测试或运行实时最终用户工作负载。

本页提供了一系列使用示例，演示如何创建 ConfigMap 并使用 ConfigMap 中存储的数据配置 Pod。

开始之前

您需要拥有一个 Kubernetes 集群，并且 kubectl 命令行工具必须配置为与您的集群通信。建议在至少有两个节点的集群上运行本教程，这些节点不充当控制平面主机。如果您还没有集群，可以使用 minikube 创建一个，或者您可以使用以下 Kubernetes 游乐场之一

您需要安装 wget 工具。如果您有其他工具（例如 curl）并且没有 wget，则需要调整下载示例数据的步骤。

创建 ConfigMap

您可以使用 kubectl create configmap 或 kustomization.yaml 中的 ConfigMap 生成器来创建 ConfigMap。

使用 kubectl create configmap 创建 ConfigMap

使用 kubectl create configmap 命令从 目录、文件 或 字面值 创建 ConfigMap

kubectl create configmap <map-name> <data-source>

其中 <map-name> 是您要分配给 ConfigMap 的名称，<data-source> 是要从中提取数据的目录、文件或字面值。ConfigMap 对象的名称必须是有效的 DNS 子域名。

当您基于文件创建 ConfigMap 时，<data-source> 中的键默认为文件的基名，值默认为文件内容。

您可以使用 kubectl describe 或 kubectl get 来检索有关 ConfigMap 的信息。

从目录创建 ConfigMap

您可以使用 kubectl create configmap 从同一目录中的多个文件创建 ConfigMap。当您基于目录创建 ConfigMap 时，kubectl 会识别文件名是目录中有效键的文件，并将这些文件中的每一个打包到新的 ConfigMap 中。除了常规文件之外的任何目录条目都会被忽略（例如：子目录、符号链接、设备、管道等）。

创建本地目录

mkdir -p configure-pod-container/configmap/

现在，下载示例配置并创建 ConfigMap

# Download the sample files into `configure-pod-container/configmap/` directory
wget https://kubernetes.ac.cn/examples/configmap/game.properties -O configure-pod-container/configmap/game.properties
wget https://kubernetes.ac.cn/examples/configmap/ui.properties -O configure-pod-container/configmap/ui.properties

# Create the ConfigMap
kubectl create configmap game-config --from-file=configure-pod-container/configmap/

上面的命令将 configure-pod-container/configmap/ 目录中的每个文件（在本例中为 game.properties 和 ui.properties）打包到 game-config ConfigMap 中。您可以使用以下命令显示 ConfigMap 的详细信息

kubectl describe configmaps game-config

输出类似于以下内容

Name:         game-config
Namespace:    default
Labels:       <none>
Annotations:  <none>

Data
====
game.properties:
----
enemies=aliens
lives=3
enemies.cheat=true
enemies.cheat.level=noGoodRotten
secret.code.passphrase=UUDDLRLRBABAS
secret.code.allowed=true
secret.code.lives=30
ui.properties:
----
color.good=purple
color.bad=yellow
allow.textmode=true
how.nice.to.look=fairlyNice

configure-pod-container/configmap/ 目录中的 game.properties 和 ui.properties 文件在 ConfigMap 的 data 部分中表示。

kubectl get configmaps game-config -o yaml

输出类似于以下内容

apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: 2022-02-18T18:52:05Z
  name: game-config
  namespace: default
  resourceVersion: "516"
  uid: b4952dc3-d670-11e5-8cd0-68f728db1985
data:
  game.properties: |
    enemies=aliens
    lives=3
    enemies.cheat=true
    enemies.cheat.level=noGoodRotten
    secret.code.passphrase=UUDDLRLRBABAS
    secret.code.allowed=true
    secret.code.lives=30    
  ui.properties: |
    color.good=purple
    color.bad=yellow
    allow.textmode=true
    how.nice.to.look=fairlyNice

从文件创建 ConfigMap

您可以使用 kubectl create configmap 从单个文件或多个文件创建 ConfigMap。

例如，

kubectl create configmap game-config-2 --from-file=configure-pod-container/configmap/game.properties

将生成以下 ConfigMap

kubectl describe configmaps game-config-2

其中输出类似于以下内容

Name:         game-config-2
Namespace:    default
Labels:       <none>
Annotations:  <none>

Data
====
game.properties:
----
enemies=aliens
lives=3
enemies.cheat=true
enemies.cheat.level=noGoodRotten
secret.code.passphrase=UUDDLRLRBABAS
secret.code.allowed=true
secret.code.lives=30

您可以多次传递 --from-file 参数以从多个数据源创建 ConfigMap。

kubectl create configmap game-config-2 --from-file=configure-pod-container/configmap/game.properties --from-file=configure-pod-container/configmap/ui.properties

您可以使用以下命令显示 game-config-2 ConfigMap 的详细信息

kubectl describe configmaps game-config-2

输出类似于以下内容

Name:         game-config-2
Namespace:    default
Labels:       <none>
Annotations:  <none>

Data
====
game.properties:
----
enemies=aliens
lives=3
enemies.cheat=true
enemies.cheat.level=noGoodRotten
secret.code.passphrase=UUDDLRLRBABAS
secret.code.allowed=true
secret.code.lives=30
ui.properties:
----
color.good=purple
color.bad=yellow
allow.textmode=true
how.nice.to.look=fairlyNice

使用选项 --from-env-file 从 env-file 创建 ConfigMap，例如

# Env-files contain a list of environment variables.
# These syntax rules apply:
#   Each line in an env file has to be in VAR=VAL format.
#   Lines beginning with # (i.e. comments) are ignored.
#   Blank lines are ignored.
#   There is no special handling of quotation marks (i.e. they will be part of the ConfigMap value)).

# Download the sample files into `configure-pod-container/configmap/` directory
wget https://kubernetes.ac.cn/examples/configmap/game-env-file.properties -O configure-pod-container/configmap/game-env-file.properties
wget https://kubernetes.ac.cn/examples/configmap/ui-env-file.properties -O configure-pod-container/configmap/ui-env-file.properties

# The env-file `game-env-file.properties` looks like below
cat configure-pod-container/configmap/game-env-file.properties
enemies=aliens
lives=3
allowed="true"

# This comment and the empty line above it are ignored

kubectl create configmap game-config-env-file \
       --from-env-file=configure-pod-container/configmap/game-env-file.properties

将生成一个 ConfigMap。查看 ConfigMap

kubectl get configmap game-config-env-file -o yaml

输出类似于

apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: 2019-12-27T18:36:28Z
  name: game-config-env-file
  namespace: default
  resourceVersion: "809965"
  uid: d9d1ca5b-eb34-11e7-887b-42010a8002b8
data:
  allowed: '"true"'
  enemies: aliens
  lives: "3"

从 Kubernetes v1.23 开始，kubectl 支持多次指定 --from-env-file 参数以从多个数据源创建 ConfigMap。

kubectl create configmap config-multi-env-files \
        --from-env-file=configure-pod-container/configmap/game-env-file.properties \
        --from-env-file=configure-pod-container/configmap/ui-env-file.properties

将生成以下 ConfigMap

kubectl get configmap config-multi-env-files -o yaml

其中输出类似于以下内容

apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: 2019-12-27T18:38:34Z
  name: config-multi-env-files
  namespace: default
  resourceVersion: "810136"
  uid: 252c4572-eb35-11e7-887b-42010a8002b8
data:
  allowed: '"true"'
  color: purple
  enemies: aliens
  how: fairlyNice
  lives: "3"
  textmode: "true"

定义从文件创建 ConfigMap 时要使用的键

使用 --from-file 参数时，您可以定义除文件名以外的键在 ConfigMap 的 data 部分中使用

kubectl create configmap game-config-3 --from-file=<my-key-name>=<path-to-file>

其中 <my-key-name> 是您要在 ConfigMap 中使用的键，<path-to-file> 是您希望键代表的数据源文件的位置。

例如

kubectl create configmap game-config-3 --from-file=game-special-key=configure-pod-container/configmap/game.properties

将生成以下 ConfigMap

kubectl get configmaps game-config-3 -o yaml

其中输出类似于以下内容

apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: 2022-02-18T18:54:22Z
  name: game-config-3
  namespace: default
  resourceVersion: "530"
  uid: 05f8da22-d671-11e5-8cd0-68f728db1985
data:
  game-special-key: |
    enemies=aliens
    lives=3
    enemies.cheat=true
    enemies.cheat.level=noGoodRotten
    secret.code.passphrase=UUDDLRLRBABAS
    secret.code.allowed=true
    secret.code.lives=30

从字面值创建 ConfigMap

您可以使用 kubectl create configmap 以及 --from-literal 参数从命令行定义字面值

kubectl create configmap special-config --from-literal=special.how=very --from-literal=special.type=charm

您可以传递多个键值对。命令行上提供的每个对都作为 ConfigMap 的 data 部分中的单独条目表示。

kubectl get configmaps special-config -o yaml

输出类似于以下内容

apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: 2022-02-18T19:14:38Z
  name: special-config
  namespace: default
  resourceVersion: "651"
  uid: dadce046-d673-11e5-8cd0-68f728db1985
data:
  special.how: very
  special.type: charm

从生成器创建 ConfigMap

您还可以从生成器创建 ConfigMap，然后将其应用以在集群的 API 服务器中创建该对象。您应该在目录中的 kustomization.yaml 文件中指定生成器。

从文件生成 ConfigMap

例如，要从文件 configure-pod-container/configmap/game.properties 生成 ConfigMap

# Create a kustomization.yaml file with ConfigMapGenerator
cat <<EOF >./kustomization.yaml
configMapGenerator:
- name: game-config-4
  options:
    labels:
      game-config: config-4
  files:
  - configure-pod-container/configmap/game.properties
EOF

应用 kustomization 目录以创建 ConfigMap 对象

kubectl apply -k .

configmap/game-config-4-m9dm2f92bt created

您可以像这样检查 ConfigMap 是否已创建

kubectl get configmap

NAME                       DATA   AGE
game-config-4-m9dm2f92bt   1      37s

以及

kubectl describe configmaps/game-config-4-m9dm2f92bt

Name:         game-config-4-m9dm2f92bt
Namespace:    default
Labels:       game-config=config-4
Annotations:  kubectl.kubernetes.io/last-applied-configuration:
                {"apiVersion":"v1","data":{"game.properties":"enemies=aliens\nlives=3\nenemies.cheat=true\nenemies.cheat.level=noGoodRotten\nsecret.code.p...

Data
====
game.properties:
----
enemies=aliens
lives=3
enemies.cheat=true
enemies.cheat.level=noGoodRotten
secret.code.passphrase=UUDDLRLRBABAS
secret.code.allowed=true
secret.code.lives=30
Events:  <none>

请注意，生成的 ConfigMap 名称附加了通过对内容进行哈希生成的后缀。这确保每次内容修改时都会生成新的 ConfigMap。

定义从文件生成 ConfigMap 时要使用的键

您可以定义除文件名以外的键在 ConfigMap 生成器中使用。例如，要从文件 configure-pod-container/configmap/game.properties 生成 ConfigMap，并使用键 game-special-key

# Create a kustomization.yaml file with ConfigMapGenerator
cat <<EOF >./kustomization.yaml
configMapGenerator:
- name: game-config-5
  options:
    labels:
      game-config: config-5
  files:
  - game-special-key=configure-pod-container/configmap/game.properties
EOF

应用 kustomization 目录以创建 ConfigMap 对象。

kubectl apply -k .

configmap/game-config-5-m67dt67794 created

从字面值生成 ConfigMap

本示例演示如何使用 Kustomize 和 kubectl 从两个字面键值对：special.type=charm 和 special.how=very 创建 ConfigMap。为此，您可以指定 ConfigMap 生成器。创建（或替换）kustomization.yaml，使其包含以下内容

---
# kustomization.yaml contents for creating a ConfigMap from literals
configMapGenerator:
- name: special-config-2
  literals:
  - special.how=very
  - special.type=charm

应用 kustomization 目录以创建 ConfigMap 对象

kubectl apply -k .

configmap/special-config-2-c92b5mmcf2 created

临时清理

在继续之前，清理您创建的一些 ConfigMap

kubectl delete configmap special-config
kubectl delete configmap env-config
kubectl delete configmap -l 'game-config in (config-4,config-5)'

现在您已经了解了如何定义 ConfigMap，您可以继续下一部分，并了解如何将这些对象与 Pod 一起使用。

使用 ConfigMap 数据定义容器环境变量

使用来自单个 ConfigMap 的数据定义容器环境变量

  1. 在 ConfigMap 中定义环境变量作为键值对

    kubectl create configmap special-config --from-literal=special.how=very

  2. 将 ConfigMap 中定义的 special.how 值分配给 Pod 规范中的 SPECIAL_LEVEL_KEY 环境变量。

    pods/pod-single-configmap-env-variable.yaml 
    apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: registry.k8s.io/busybox
      command: [ "/bin/sh", "-c", "env" ]
      env:
        # Define the environment variable
        - name: SPECIAL_LEVEL_KEY
          valueFrom:
            configMapKeyRef:
              # The ConfigMap containing the value you want to assign to SPECIAL_LEVEL_KEY
              name: special-config
              # Specify the key associated with the value
              key: special.how
  restartPolicy: Never

    创建 Pod

    kubectl create -f https://kubernetes.ac.cn/examples/pods/pod-single-configmap-env-variable.yaml

    现在，Pod 的输出包括环境变量 SPECIAL_LEVEL_KEY=very。

使用来自多个 ConfigMap 的数据定义容器环境变量

与前面的示例一样，首先创建 ConfigMap。以下是您将使用的清单

configmap/configmaps.yaml 
apiVersion: v1
kind: ConfigMap
metadata:
  name: special-config
  namespace: default
data:
  special.how: very
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: env-config
  namespace: default
data:
  log_level: INFO

  • 创建 ConfigMap

    kubectl create -f https://kubernetes.ac.cn/examples/configmap/configmaps.yaml

  • 在 Pod 规范中定义环境变量。

    pods/pod-multiple-configmap-env-variable.yaml 
    apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: registry.k8s.io/busybox
      command: [ "/bin/sh", "-c", "env" ]
      env:
        - name: SPECIAL_LEVEL_KEY
          valueFrom:
            configMapKeyRef:
              name: special-config
              key: special.how
        - name: LOG_LEVEL
          valueFrom:
            configMapKeyRef:
              name: env-config
              key: log_level
  restartPolicy: Never

    创建 Pod

    kubectl create -f https://kubernetes.ac.cn/examples/pods/pod-multiple-configmap-env-variable.yaml

    现在，Pod 的输出包括环境变量 SPECIAL_LEVEL_KEY=very 和 LOG_LEVEL=INFO。

    如果您准备继续，请删除该 Pod

    kubectl delete pod dapi-test-pod --now

将 ConfigMap 中的所有键值对配置为容器环境变量

  • 创建一个包含多个键值对的 ConfigMap。

    configmap/configmap-multikeys.yaml 
    apiVersion: v1
kind: ConfigMap
metadata:
  name: special-config
  namespace: default
data:
  SPECIAL_LEVEL: very
  SPECIAL_TYPE: charm

    创建 ConfigMap

    kubectl create -f https://kubernetes.ac.cn/examples/configmap/configmap-multikeys.yaml

  • 使用 envFrom 将 ConfigMap 中的所有数据定义为容器环境变量。ConfigMap 中的键将成为 Pod 中的环境变量名称。

    pods/pod-configmap-envFrom.yaml 
    apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: registry.k8s.io/busybox
      command: [ "/bin/sh", "-c", "env" ]
      envFrom:
      - configMapRef:
          name: special-config
  restartPolicy: Never

    创建 Pod

    kubectl create -f https://kubernetes.ac.cn/examples/pods/pod-configmap-envFrom.yaml

    现在，Pod 的输出包括环境变量 SPECIAL_LEVEL=very 和 SPECIAL_TYPE=charm。

    如果您准备继续，请删除该 Pod

    kubectl delete pod dapi-test-pod --now

在 Pod 命令中使用 ConfigMap 定义的环境变量

您可以使用 $(VAR_NAME) Kubernetes 替换语法在容器的 command 和 args 中使用 ConfigMap 定义的环境变量。

例如，以下 Pod 清单

pods/pod-configmap-env-var-valueFrom.yaml 
apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: registry.k8s.io/busybox
      command: [ "/bin/echo", "$(SPECIAL_LEVEL_KEY) $(SPECIAL_TYPE_KEY)" ]
      env:
        - name: SPECIAL_LEVEL_KEY
          valueFrom:
            configMapKeyRef:
              name: special-config
              key: SPECIAL_LEVEL
        - name: SPECIAL_TYPE_KEY
          valueFrom:
            configMapKeyRef:
              name: special-config
              key: SPECIAL_TYPE
  restartPolicy: Never

通过运行以下命令创建该 Pod：

kubectl create -f https://kubernetes.ac.cn/examples/pods/pod-configmap-env-var-valueFrom.yaml

该 Pod 从 test-container 容器产生以下输出

kubectl logs dapi-test-pod

very charm

如果您准备继续，请删除该 Pod

kubectl delete pod dapi-test-pod --now

将 ConfigMap 数据添加到卷中

如 从文件创建 ConfigMap 中所述，当您使用 --from-file 创建 ConfigMap 时，文件名将成为存储在 ConfigMap 的 data 部分中的键。文件内容将成为键的值。

本节中的示例引用了一个名为 special-config 的 ConfigMap。

configmap/configmap-multikeys.yaml 
apiVersion: v1
kind: ConfigMap
metadata:
  name: special-config
  namespace: default
data:
  SPECIAL_LEVEL: very
  SPECIAL_TYPE: charm

创建 ConfigMap

kubectl create -f https://kubernetes.ac.cn/examples/configmap/configmap-multikeys.yaml

使用存储在 ConfigMap 中的数据填充卷

在 Pod 规范的 volumes 部分下添加 ConfigMap 名称。这会将 ConfigMap 数据添加到指定为 volumeMounts.mountPath 的目录（在本例中为 /etc/config）。command 部分列出了与 ConfigMap 中的键匹配的名称的目录文件。

pods/pod-configmap-volume.yaml 
apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: registry.k8s.io/busybox
      command: [ "/bin/sh", "-c", "ls /etc/config/" ]
      volumeMounts:
      - name: config-volume
        mountPath: /etc/config
  volumes:
    - name: config-volume
      configMap:
        # Provide the name of the ConfigMap containing the files you want
        # to add to the container
        name: special-config
  restartPolicy: Never

创建 Pod

kubectl create -f https://kubernetes.ac.cn/examples/pods/pod-configmap-volume.yaml

当 Pod 运行时，命令 ls /etc/config/ 会产生以下输出

SPECIAL_LEVEL
SPECIAL_TYPE

文本数据使用 UTF-8 字符编码作为文件公开。要使用其他字符编码，请使用 binaryData（有关更多详细信息，请参阅 ConfigMap 对象）。

如果您准备继续，请删除该 Pod

kubectl delete pod dapi-test-pod --now

将 ConfigMap 数据添加到卷中的特定路径

使用 path 字段为特定 ConfigMap 项目指定所需的路径。在本例中，SPECIAL_LEVEL 项目将挂载到 config-volume 卷的 /etc/config/keys 中。

pods/pod-configmap-volume-specific-key.yaml 
apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: registry.k8s.io/busybox
      command: [ "/bin/sh","-c","cat /etc/config/keys" ]
      volumeMounts:
      - name: config-volume
        mountPath: /etc/config
  volumes:
    - name: config-volume
      configMap:
        name: special-config
        items:
        - key: SPECIAL_LEVEL
          path: keys
  restartPolicy: Never

创建 Pod

kubectl create -f https://kubernetes.ac.cn/examples/pods/pod-configmap-volume-specific-key.yaml

当 Pod 运行时，命令 cat /etc/config/keys 会产生以下输出

very

删除该 Pod

kubectl delete pod dapi-test-pod --now

将键投影到特定路径和文件权限

您可以将键投影到特定路径。有关语法的详细信息，请参阅 Secrets 指南中的相应部分。
您可以为键设置 POSIX 权限。有关语法的详细信息，请参阅 Secrets 指南中的相应部分。

可选引用

ConfigMap 引用可以标记为可选。如果 ConfigMap 不存在，则挂载的卷将为空。如果 ConfigMap 存在，但引用的键不存在，则该路径将不存在于挂载点下方。有关更多详细信息，请参阅 可选 ConfigMap。

挂载的 ConfigMap 会自动更新

当挂载的 ConfigMap 更新时，投影的内容最终也会更新。这适用于在 Pod 启动后可选引用的 ConfigMap 存在的情况。

Kubelet 在每次定期同步时都会检查挂载的 ConfigMap 是否是最新的。但是，它使用其本地基于 TTL 的缓存来获取 ConfigMap 的当前值。因此，从 ConfigMap 更新到新键投影到 Pod 的总延迟可能与 kubelet 同步周期（默认情况下为 1 分钟）+ kubelet 中 ConfigMap 缓存的 TTL（默认情况下为 1 分钟）一样长。您可以通过更新 Pod 的其中一个注释来触发立即刷新。

了解 ConfigMap 和 Pod

ConfigMap API 资源将配置数据存储为键值对。这些数据可以在 Pod 中使用，或者为控制器等系统组件提供配置。ConfigMap 与 Secrets 类似，但提供了一种处理不包含敏感信息字符串的方法。用户和系统组件都可以将配置数据存储在 ConfigMap 中。

ConfigMap 的 data 字段包含配置数据。如下面的示例所示，这可以很简单（例如使用 --from-literal 定义的单个属性）或很复杂（例如使用 --from-file 定义的配置文件或 JSON 块）。

apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: 2016-02-18T19:14:38Z
  name: example-config
  namespace: default
data:
  # example of a simple property defined using --from-literal
  example.property.1: hello
  example.property.2: world
  # example of a complex property defined using --from-file
  example.property.file: |-
    property.1=value-1
    property.2=value-2
    property.3=value-3

当 kubectl 从非 ASCII 或 UTF-8 的输入创建 ConfigMap 时，该工具会将这些输入放入 ConfigMap 的 binaryData 字段中，而不是 data 中。文本和二进制数据源可以组合在一个 ConfigMap 中。

如果您想查看 ConfigMap 中的 binaryData 键（及其值），可以运行 kubectl get configmap -o jsonpath='{.binaryData}' <name>。

Pod 可以从使用 data 或 binaryData 的 ConfigMap 加载数据。

可选 ConfigMap

您可以在 Pod 规范中将对 ConfigMap 的引用标记为可选。如果 ConfigMap 不存在，则 Pod 中提供数据的配置（例如：环境变量、挂载的卷）将为空。如果 ConfigMap 存在，但引用的键不存在，则数据也为空。

例如，以下 Pod 规范将 ConfigMap 中的环境变量标记为可选

apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: gcr.io/google_containers/busybox
      command: ["/bin/sh", "-c", "env"]
      env:
        - name: SPECIAL_LEVEL_KEY
          valueFrom:
            configMapKeyRef:
              name: a-config
              key: akey
              optional: true # mark the variable as optional
  restartPolicy: Never

如果您运行此 Pod，并且不存在名为 a-config 的 ConfigMap，则输出为空。如果您运行此 Pod，并且存在名为 a-config 的 ConfigMap，但该 ConfigMap 没有名为 akey 的键，则输出也为空。如果您确实在 a-config ConfigMap 中为 akey 设置了值，则此 Pod 会打印该值，然后终止。

您还可以将 ConfigMap 提供的卷和文件标记为可选。Kubernetes 始终为卷创建挂载路径，即使引用的 ConfigMap 或键不存在。例如，以下 Pod 规范将引用 ConfigMap 的卷标记为可选

apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: gcr.io/google_containers/busybox
      command: ["/bin/sh", "-c", "ls /etc/config"]
      volumeMounts:
      - name: config-volume
        mountPath: /etc/config
  volumes:
    - name: config-volume
      configMap:
        name: no-config
        optional: true # mark the source ConfigMap as optional
  restartPolicy: Never

限制

  • 您必须在 Pod 规范中引用它之前创建 ConfigMap 对象。或者，在 Pod 规范中将 ConfigMap 引用标记为 optional（请参阅 可选 ConfigMap）。如果您引用了不存在的 ConfigMap，并且您没有将引用标记为 optional，则 Pod 不会启动。同样，对 ConfigMap 中不存在的键的引用也会阻止 Pod 启动，除非您将键引用标记为 optional。

  • 如果您使用 envFrom 从 ConfigMap 定义环境变量，则将跳过被视为无效的键。Pod 将被允许启动，但无效名称将记录在事件日志中 (InvalidVariableNames)。日志消息列出了每个跳过的键。例如

    kubectl get events

    输出类似于以下内容

    LASTSEEN FIRSTSEEN COUNT NAME          KIND  SUBOBJECT  TYPE      REASON                            SOURCE                MESSAGE
0s       0s        1     dapi-test-pod Pod              Warning   InvalidEnvironmentVariableNames   {kubelet, 127.0.0.1}  Keys [1badkey, 2alsobad] from the EnvFrom configMap default/myconfig were skipped since they are considered invalid environment variable names.

  • ConfigMap 驻留在特定的 命名空间 中。Pod 只能引用与 Pod 位于同一命名空间中的 ConfigMap。

  • 您不能将 ConfigMap 用于 静态 Pod，因为 kubelet 不支持此功能。

清理

删除您创建的 ConfigMap 和 Pod。

kubectl delete configmaps/game-config configmaps/game-config-2 configmaps/game-config-3 \
               configmaps/game-config-env-file
kubectl delete pod dapi-test-pod --now

# You might already have removed the next set
kubectl delete configmaps/special-config configmaps/env-config
kubectl delete configmap -l 'game-config in (config-4,config-5)'

如果您创建了一个名为 configure-pod-container 的目录，并且不再需要它，则您应该将其删除，或者将其移动到垃圾箱/已删除文件的位置。

下一步

上次修改时间：2023 年 12 月 27 日下午 3:37 PST：通过 ConfigMap 更新配置 (3efc5cde2f)