k8s-ConfigMap 实现应用和配置分离

教程

字数统计: 1.1k阅读时长: 4 min

 2023/04/07 

ConfigMap 背景

应用程序的运行可能会依赖一些配置，而这些配置又是可能会随着需求产生变化的，如果我们的应用程序架构不是应用和配置分离的，那么就会存在当我们需要去修改某些配置项的属性时需要重新构建镜像文件的窘境。

现在，ConfigMap组件可以很好的帮助我们实现应用和配置分离，避免因为修改配置项而重新构建镜像。 ConfigMap 用于保存配置数据的键值对，可以用来保存单个属性，也可以用来保存配置文件。ConfigMap 跟 Secret 很类似，但它可以更方便地处理不包含敏感信息的字符串。

ConfigMap 创建方式

ConfigMap 可以通过多种方式创建，包括：

命令行工具 kubectl

可以使用 kubectl create configmap 命令从文件或文本创建 ConfigMap。

例如，以下命令将名为 my-config 的 ConfigMap 从文件创建:

1	kubectl create configmap my-config --from-file=config.properties

声明式 YAML 文件

可以使用声明式 YAML 文件定义 ConfigMap 对象。

例如，以下 YAML 定义了一个名为 my-config 的 ConfigMap：

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-config
data:
  DB_USERNAME: admin
  DB_PASSWORD: password123

配置自动加载

在 Kubernetes 中，可以使用特定的挂载点来自动加载 ConfigMap 作为环境变量或卷。

这可以通过 Pod 中的 Volume 和环境变量实现。例如：

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
    - name: my-container
      image: my-image
      volumeMounts:
        - name: config-volume
          mountPath: /etc/config
      env:
        - name: DB_USERNAME
          valueFrom:
            configMapKeyRef:
              name: my-config
              key: DB_USERNAME
  volumes:
    - name: config-volume
      configMap:
        name: my-config

ConfigMap 的使用

在 Kubernetes 中，有三种主要方式可以将 ConfigMap 注入到 Pod 中。

定义成环境变量

在 Pod 中，可以将 ConfigMap 数据注入到容器的环境变量中。假设已经创建了一个名为 my-config 的 ConfigMap，包含以下数据：

1 2	DB_USERNAME=admin DB_PASSWORD=password123

可以通过定义环境变量引用 ConfigMap 的键来将该数据注入到容器中。例如：

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
    - name: my-container
      image: my-image
      env:
        - name: DB_USERNAME
          valueFrom:
            configMapKeyRef:
              name: my-config
              key: DB_USERNAME
        - name: DB_PASSWORD
          valueFrom:
            configMapKeyRef:
              name: my-config
              key: DB_PASSWORD

使用卷

另一种常见的方法是将 ConfigMap 数据作为文件或目录挂载到容器中。假设已经创建了一个名为 my-config 的 ConfigMap，包含以下数据：

1
2
3

config.properties:
  server.port=8080
  database.url=jdbc:mysql://localhost/mydb

则可以使用以下 YAML 定义一个 Pod，将 ConfigMap 作为 Volume 挂载到容器中：

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
    - name: my-container
      image: my-image
      volumeMounts:
        - name: config-volume
          mountPath: /etc/config
  volumes:
    - name: config-volume
      configMap:
        name: my-config

在容器内，可以使用与卷相同的路径来访问 ConfigMap 中的数据。

自定义全局参数

还可以将 ConfigMap 数据作为自定义全局参数传递给 Kubernetes 对象，如 Deployment。

例如，以下 YAML 定义了一个 Deployment，其中参数可以通过 ConfigMap 设置：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
        - name: my-container
          image: my-image
          command: ["/bin/myapp"]
          args: ["--config=/etc/myapp/config.json"]
          env:
            - name: MY_APP_ENV
              value: "production"
          volumeMounts:
            - name: config-volume
              mountPath: /etc/myapp/
      volumes:
        - name: config-volume
          configMap:
            name: my-config