Kubernetes-配置字典ConfigMap

2018-12-13 558

1、ConfigMap概述

很多生产环境中的应用程序配置较为复杂，可能需要多个config文件、命令行参数和环境变量的组合。使用容器部署时，把配置应该从应用程序镜像中解耦出来，以保证镜像的可移植性。尽管Secret允许类似于验证信息和秘钥等信息从应用中解耦出来，但在K8S1.2前并没有为了普通的或者非secret配置而存在的对象。在K8S1.2后引入ConfigMap来处理这种类型的配置数据。

ConfigMap是存储通用的配置变量的，类似于配置文件，使用户可以将分布式系统中用于不同模块的环境变量统一到一个对象中管理；而它与配置文件的区别在于它是存在集群的“环境”中的，并且支持K8S集群中所有通用的操作调用方式。从数据角度来看，ConfigMap的类型只是键值组，用于存储被Pod或者其他资源对象（如RC）访问的信息。这与secret的设计理念有异曲同工之妙，主要区别在于ConfigMap通常不用于存储敏感信息，而只存储简单的文本信息。

创建pod时，对configmap进行绑定，pod内的应用可以直接引用ConfigMap的配置。相当于configmap为应用/运行环境封装配置。pod使用ConfigMap，通常用于：设置环境变量的值、设置命令行参数、创建配置文件。

Kubernetes是为了解决“如何合理使用容器支撑企业级复杂应用”这个问题而诞生的，所以它的设计理念是要支持绝大多数应用的原生形态。例如，很多应用程序的配置需要通过配置文件，命令行参数和环境变量的组合配置来完成（“十二要素应用”等均要求去配置）。这些配置应该从image内容中解耦，以此来保持容器化应用程序的可移植性。ConfigMap API资源提供了将配置数据注入容器的方式，同时保证该机制对容器来说是透明的。ConfigMap可以被用来保存单个属性，也可以用来保存整个配置文件或者JSON二进制大对象。

ConfigMap API以键值对的方式存储配置数据。ConfigMap的数据可以被Pod和控制器等系统组件使用。onfigMap和Secret类似，但ConfigMap用于存储不包含敏感信息的数据。用户和系统组件一样能够在ConfigMap中存储配置数据。ConfigMap可以保存环境变量的属性，也可以保存配置文件。ConfigMap的data field包含配置数据。如下面例子所示，ConfigMap可以包含细粒度的配置项，如：example.property.1；也可以包含粗粒度的配置文件，如：example.property.file。

kind: ConfigMap
apiVersion: v1
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

在使用Config时需要注意的事项：

在Pod 规格应用ConfigMap之前，ConfigMap必须存在。如果Pod引用的ConfigMap不存在，Pod将不能启动。
ConfigMap只能被在同一一个命名空间中的Pod所引用。

2、创建ConfigMap

在Kubernetes中，可以使用kubectl create configmap命令，通过目录、文件和指定值(literal value)来创建：

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

这里的 <map-name> 是希望创建的ConfigMap的名称，<data-source>是一个目录、文件和具体值。

在ConfigMap中，键值对的数据源如下所述：

key = 文件名或者在命令行中提供的键
value = 文件内容或者在命令行中提供的具体值

能够使用kubectl describe或者kubectl get获取ConfigMap的信息。

2.1 通过目录创建ConfigMaps

1）通过在一个目录下的多个文件创建ConfigMap,例如：

$kubectl create configmap game-config \
--from-file=https://k8s.io/docs/tasks/configure-pod-container/configmap/kubectl

2）docs/tasks/configure-pod-container/configmap/kubectl/目录下的文件包括：

$ ls docs/tasks/configure-pod-container/configmap/kubectl/

game.properties
ui.properties

3）查看game-config ConfigMap的信息:

$ kubectl describe configmaps game-config

image2018-3-26+11%3A24%3A6.png?version=1

4）在docs/tasks/configure-pod-container/configmap/kubectl/ 目录下的game.properties和ui.properties文件的内容在ConfigMap中的data区域进行显示：

$ kubectl get configmaps game-config -o yaml

image2018-3-26+11%3A25%3A9.png?version=1

2.2 通过文件创建ConfigMaps

2.2.1 通过单个文件创建

1）通过单个文件创建ConfigMap，例如：

$ kubectl create configmap game-config-2 \
--from-file=https://k8s.io/docs/tasks/configure-pod-container/configmap/kubectl/game.properties

2）查看生产的ConfigMap信息：

$ kubectl describe configmaps game-config-2

image2018-3-26+10%3A22%3A27.png?version=

2.2.2 通过多个文件生成

1）通过多个文件创建ConfigMap

$ kubectl create configmap game-config-3 \
--from-file=https://k8s.io/docs/tasks/configure-pod-container/configmap/kubectl/game.properties \ --from-file=https://k8s.io/docs/tasks/configure-pod-container/configmap/kubectl/ui.properties

2）查看生产的ConfigMap信息：

$ kubectl describe configmaps game-config-3

image2018-3-26+10%3A27%3A58.png?version=

2.2.3 通过文件创建ConfigMap时可以定义文件的键

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

这里的<my-key-name>是在ConfigMap里想要被使用的键，<path-to-file>是文件的路径。例如：

$ kubectl create configmap game-config-4 \
--from-file=game-special-key=https://k8s.io/docs/tasks/configure-pod-container/configmap/kubectl/game.properties
$ kubectl get configmaps game-config-4 -o yaml

image2018-3-26+10%3A40%3A33.png?version=

2.3 通过具体值创建ConfigMaps

通过kubectl create configmap命令，能够使用–from-literal参数来定义具体值来创建ConfigMap：

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

在命令行中可以输入多个键-值对。每一一个键值对会成为ConfigMap data部分的一条记录。

$ kubectl get configmaps special-config -o yaml

image2018-3-26+11%3A26%3A33.png?version=

3、使用ConfigMap

3.1 使用ConfigMap数据定义Pod环境变量

3.1.1 Pod环境变量的值来自于单一ConfigMap

1）在ConfigMap中定义一个环境变量作为键值对：

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

2）指派ConfigMap中定义的special.how的值给Pod中SPECIAL_LEVEL_KEY环境变量：

$ kubectl edit pod dapi-test-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"]
 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规格的变化，Pod将输出SPECIAL_LEVEL_KEY=very。

3.1.2 Pod环境变量的值来自于多个ConfigMap

首先创建两个ConfigMap：

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

在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"]
 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，Pod将会输出SPECIAL_LEVEL_KEY=very和LOG_LEVEL=info。

3.2 在一个ConfigMap中配置的键值对都作为一个Pod的环境变量

注意：此能力在Kubernetes v1.6+可用。创建包含多个键-值对的ConfigMap。

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

使用envFrom定义所有的ConfigMap数据作为Pod的环境变量。来自于Config的键成为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

保存Pod规范的变更，现在Pod的输出包括：SPECIAL_LEVEL=very 和 SPECIAL_TYPE=charm

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

在Pod规范的command 中使用$(VAR_NAME) ，获取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","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

test-container容器的输入如下：

very charm

4、添加ConfigMap数据至存储卷

当通过–from-file创建的ConfigMap时，文件将作为一个键保存在ConfigMap中，而此文件的内容将作为值。

apiVersion:v1
kind:ConfigMap
metadata:
 name:special-config
 namespace:default
data:
 special.level:very
 special.type:charm

4.1 将ConfigMap中的数据传播到指定目录

在Pod的存储卷区域添加ConfigMap的名称。这将添加ConfigMap数据到volumeMounts.mountPath指定的目录下（在此例子为/etc/config）。command区域将引用保存在ConfigMap中的special.level条目。

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: # Provide the name of the ConfigMap containing the files you want # to add to the container
 name:special-config
 restartPolicy:Never

当Pod运行时，command (“ls /etc/config/”)将输出下面的内容：

special.level
special.type

注意：如果在/etc/config/目录下存在文件，将不会删除。

4.2 添加ConfigMap数据至存储卷指定的目录

为ConfigMap条目，使用path指定文件路径。在此示例中，special.level将在config-volume存储卷中被挂接至/etc/config/keys。

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

当Pod运行时，(“cat /etc/config/keys”) 将输出：

very

本文转自中文社区-Kubernetes-配置字典ConfigMap

微信关注我们

原文链接：https://yq.aliyun.com/articles/679299

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

Kubernetes-身份认证

1、Kubernetes中的用户所有的系统都存在访问和使用其的用户，Kubernetes也一样，在Kubernetes集群中有存在两类用户： service accounts：由Kubernetes进行管理的特殊用户；普通用户：普通用户是由外部应用进行管理的用户。对于普通用户，Kubernetes管理员只负责为其分配私钥。普通用户可能来自于Keystone或google中，或者甚至是存储在文件中的用户名和密码列表。在Kubernetes中，没有表达普通用户的对象，因此，也就不能通过API将普通用户添加到集群中。而Service Account是由Kubernetes API管理的用户，它们被绑定到特定的命名空间中，并由API服务器自动创建或通过API调用手动创建。Service Account与存储在Secrets的一组证书相关联，这些凭据被挂载到pod中，以允许集群中进程与Kubernetes API进行通信。 API请求要么来自于普通用户或Service Account，或来自于匿名请求。这就意味着集群内外部的所有进程（从来自于用户使用kubectl输入的请求，或来自于No...

2018-12-14

551

1、环境准备在进行Kubernetes部署之前，需要提供其要求的软硬件环境。此文档描述的场景：在无法直接连接互联网的情况下，如何进行安装部署Kubernetes。 1.1 操作系统操作系统推荐使用： Ubuntu 16.04 (64-bit) Red Hat Enterprise Linux 7.5 (64-bit) 序号主机角色软硬件环境硬件配置备注 1 k8s-master 主节点操作系统：CentOS Linux release 7.2.1511 (Core) 容器环境：Docker version 1.13.1 CPU：8核内存：8GB 磁盘：根磁盘：500GB 所有磁盘：1TB 部署Kunbernetes集群主节点和etcd，用于管理和监控Kubernetes其它的工作节点和存在状态信息。 2 k8s-worker01 工作节点操作系统：CentOS Linux release 7.2.1511 (Core) 容器环境：Docker version 1.13.1 CPU：8核内存：8GB 磁盘：根磁盘：500GB 所有磁盘：1TB 部署Kuberne...

2018-12-14

684

资源下载

更多资源

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。