• 【Kubernetes 系列】ConfigMap 进阶 环境变量的配置及使用

    作者：半身风雪
    上一节：配置 Java 微服务
    内容简介：上一节主要学习创建ConfigMap 的九种方式，那么本节内容主要讲解 ConfigMap 的使用。

    在这里插入图片描述

    文章目录

    目标

    本节学习目标：

    • 在ConfigMap 中的容器环境变量
    • ConfigMap volume中的数据处理

    提示：以下是本篇文章正文内容，下面案例可供参考

    一、ConfigMap 容器环境变量的设置

    1.1、使用单个 ConfigMap 中的数据定义容器环境变量

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

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

    1. 将 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: k8s.gcr.io/busybox
   
      command: [ "/bin/sh", "-c", "env" ]
   
      env:
   
        # 定义环境变量
   
        - name: SPECIAL_LEVEL_KEY
   
          valueFrom:
   
            configMapKeyRef:
   
              # ConfigMap 包含你要赋给 SPECIAL_LEVEL_KEY 的值
   
              name: special-config
   
              # 指定与取值相关的键名
   
              key: special.how
   
  restartPolicy: Never
   

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    1. 执行 kubectl create -f 命令，创建pod:

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

    Pod 的输出包含环境变量 SPECIAL_LEVEL_KEY=very。

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

    1. 在目录 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
  

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    1. 执行命令创建 ConfigMap:

    $ kubectl create -f https://kubernetes.io/examples/configmap/configmaps.yaml

    1. 在目录 pods/pod-multiple-configmap-env-variable.yaml 中定义环境变量:
    apiVersion: v1
  
kind: Pod
  
metadata:
  
  name: dapi-test-pod
  
spec:
  
  containers:
  
    - name: test-container
  
      image: k8s.gcr.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
  

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    1. 执行命令创建 Pod：

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

    Pod 的输出包含环境变量 SPECIAL_LEVEL_KEY=very 和 LOG_LEVEL=INFO。

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

    1. 在目录 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
  

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    1. 创建 ConfigMap:

    $ kubectl create -f https://kubernetes.io/examples/configmap/configmaps.yaml

    1. 在目录 pods/pod-multiple-configmap-env-variable.yaml 中定义环境变量:
    apiVersion: v1
  
kind: Pod
  
metadata:
  
  name: dapi-test-pod
  
spec:
  
  containers:
  
    - name: test-container
  
      image: k8s.gcr.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
  

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    1. 执行命令创建 Pod：

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

    Pod 的输出包含环境变量 SPECIAL_LEVEL_KEY=very 和 LOG_LEVEL=INFO。

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

    1. 在目录 configmap/configmap-multikeys.yaml 中创建一个包含多个键值对的 ConfigMap。
    apiVersion: v1
  
kind: ConfigMap
  
metadata:
  
  name: special-config
  
  namespace: default
  
data:
  
  SPECIAL_LEVEL: very
  
  SPECIAL_TYPE: charm

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    1. 创建 ConfigMap:

    $ kubectl create -f https://kubernetes.io/examples/configmap/configmap-multikeys.yaml

    1. 在 pods/pod-configmap-envFrom.yaml 目录中，使用 envFrom 将所有 ConfigMap 的数据定义为容器环境变量，ConfigMap 中的键成为 Pod 中的环境变量名称。
    apiVersion: v1
  
kind: Pod
  
metadata:
  
  name: dapi-test-pod
  
spec:
  
  containers:
  
    - name: test-container
  
      image: k8s.gcr.io/busybox
  
      command: [ "/bin/sh", "-c", "env" ]
  
      envFrom:
  
      - configMapRef:
  
          name: special-config
  
  restartPolicy: Never
  

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    1. 创建 Pod:

    $ kubectl create -f https://kubernetes.io/examples/pods/pod-configmap-envFrom.yaml

    Pod 的输出包含环境变量 SPECIAL_LEVEL=very 和 SPECIAL_TYPE=charm。

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

    1. 在目录 pods/pod-configmap-env-var-valueFrom.yaml 中使用**$(VAR_NAME)** Kubernetes 替换语法在容器的 command 和 args 属性中使用 ConfigMap 定义的环境变量。
    apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: k8s.gcr.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

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    1. 运行下面命令创建 Pod：

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

    1. 会在 test-container 容器中产生以下输出:
    very charm

    • 1

    二、将 ConfigMap 数据添加到volume中

    使用 --from-file 创建 ConfigMap 时，文件名成为存储在 ConfigMap 的 data 部分中的键， 文件内容成为键对应的值。

    下面看一个示例configmap/configmap-multikeys.yaml：

    apiVersion: v1
kind: ConfigMap
metadata:
  name: special-config
  namespace: default
data:
  SPECIAL_LEVEL: very
  SPECIAL_TYPE: charm

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8

    创建 ConfigMap:

    $ kubectl create -f https://kubernetes.io/examples/configmap/configmap-multikeys.yaml

    2.1、使用存储在 ConfigMap 中的数据填充volume

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

    1. 先看一下示例代码pods/pod-configmap-volume.yaml ：
    apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: k8s.gcr.io/busybox
      command: [ "/bin/sh", "-c", "ls /etc/config/" ]
      volumeMounts:
      - name: config-volume
        mountPath: /etc/config
  volumes:
    - name: config-volume
      configMap:
        # 提供包含要添加到容器中的文件的 ConfigMap 的名称
        name: special-config
  restartPolicy: Never

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    1. 创建 Pod:

    $ kubectl create -f https://kubernetes.io/examples/pods/pod-configmap-volume.yaml

    1. Pod 运行时，命令 ls /etc/config/ 产生下面的输出：

    SPECIAL_LEVEL
    SPECIAL_TYPE

    2.2、将 ConfigMap 数据添加到volume中的特定路径

    使用 path 字段为特定的 ConfigMap 项目指定预期的文件路径。 在这里，ConfigMap 中键 SPECIAL_LEVEL 的内容将挂载在 config-volume 卷中 /etc/config/keys 文件中。

    1. pods/pod-configmap-volume-specific-key.yaml示例代码：
    apiVersion: v1
kind: Pod
metadata:
  name: dapi-test-pod
spec:
  containers:
    - name: test-container
      image: k8s.gcr.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

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    1. 创建Pod：

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

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

    very

    三、ConfigMap 和 Pod

    ConfigMap API 资源将配置数据存储为键值对。 数据可以在 Pod 中使用，也可以用来提供系统组件（如控制器）的配置。 ConfigMap 与 Secret 类似， 但是提供的是一种处理不含敏感信息的字符串的方法。 用户和系统组件都可以在 ConfigMap 中存储配置数据。

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

    apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: 2016-02-18T19:14:38Z
  name: example-config
  namespace: default
data:
  # 使用 --from-literal 定义的简单属性
  example.property.1: hello
  example.property.2: world
  # 使用 --from-file 定义复杂属性的例子
  example.property.file: |-
    property.1=value-1
    property.2=value-2
    property.3=value-3    

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15

    3.1、限制

    • 在 Pod 规约中引用某个 ConfigMap 之前，必须先创建它（除非将 ConfigMap 标记为 “optional（可选）”）。如果引用的 ConfigMap 不存在，则 Pod 将不会启动。 同样，引用 ConfigMap 中不存在的主键也会令 Pod 无法启动。
    • 如果你使用 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 位于确定的名字空间中。 每个 ConfigMap 只能被同一名字空间中的 Pod 引用.
    • 你不能将 ConfigMap 用于静态 Pod， 因为 Kubernetes 不支持这种用法。

    总结

    文章写到这里，我想大家已经ConfigMap 有了一定的了解，对于 ConfigMap 的讲解，到这里就结束了，大家快动手试试吧！！！

  • 相关阅读:
    Spring 补充@Component 和 注入技巧 问题
    tiup mirror grant
    GPT-SoVITS声音训练报错ZeroDivisionError: division by zero
    Nacos配置中心集群原理及源码分析
    目标检测中的解耦和耦合、anchor-free和anchor-base
    Android学习笔记 47. Intent
    技术管理杂谈
    高薪程序员&面试题精讲系列130之说说你对微服务的理解？SpringCloud中有哪些常用的组件和注解？
    批量挖漏洞（从内网到外网、从白盒到黑盒）
    php空合并运算符，三元运算符，PHP高级
  • 原文地址：https://blog.csdn.net/u010755471/article/details/125782198