本文主要描述容器中使用配置项（ConfigMap）的场景及其相关操作步骤。 ## 背景信息企业应用部署涉及大量配置管理，若将配置硬编码到镜像中，会导致环境耦合，每个环境都需要单独构建镜像。ConfigMap 通过配置与应用解耦，实现同一镜像适配多环境（开发、测试、生产），专门存储非敏感配置数据。创建 ConfigMap 后，可以通过以下两种方式在容器中使用： |**使用方式** |**说明** |**适用场景** | |---|---|---| |环境变量注入 |将 ConfigMap 中的键值对直接注入到容器的环境变量中。 |简单的运行时参数、功能开关、数据库连接字符串等短配置项。 | |数据卷挂载 |将 ConfigMap 中的数据以文件形式挂载到容器指定目录，支持自动同步和热更新。 |完整配置文件管理，以及需要动态更新配置而不重启容器的场景。 | ## 准备工作提前准备 ConfigMap。详细操作，请参见 [创建配置项](https://www.volcengine.com/docs/6460/101005)。为方便您验证 ConfigMap 的使用结果，本文使用如下示例 ConfigMap 文件`demo-config.yaml`。 ```YAML apiVersion: v1 kind: ConfigMap metadata: name: demo-config # ConfigMap 名称，工作负载引用时使用此名称。 namespace: default # ConfigMap 命名空间，需与工作负载一致。 data: # ConfigMap 键值对配置集合。 APP_MODE: "prod" LOG_LEVEL: "info" PLAYER_NAME: "vke-user" WELCOME_MESSAGE: "hello-from-configmap" game.properties: | APP_MODE=prod LOG_LEVEL=info PLAYER_NAME=vke-user ``` ## 操作步骤 ### 场景一：环境变量注入下文以无状态负载（Deployment）为例，介绍如何使用 ConfigMap 设置工作负载的环境变量。通过控制台配置 1. 登录 [容器服务控制台](https://console.volcengine.com/vke)。 2. 单击左侧导航栏中的 **集群**。 3. 在集群列表页面，单击目标集群。 4. 选择 **工作负载** \> **无状态负载**，单击 **创建无状态负载**。 5. 在 **创建无状态负载** 页面，部分参数按如下说明配置，其余参数按实际需求自定义配置。详细操作，请参见 [创建无状态负载](https://docs.volcengine.com/docs/6460/100971)。在 ②**容器配置** 步骤中，单击 **环境变量** 区域的`+`图标，添加环境变量，将前提条件中准备的 ConfigMap 作为无状态负载的环境变量。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_746ec51ae6ecdbb0198c89cf489c7440.png) 6. 单击 **确定**，创建完成无状态负载。 7. 检查无状态负载创建结果并查看环境变量是否注入成功。 1. 在 **无状态负载** 页面找到刚创建的负载，单击名称进入 **无状态负载详情页**。 2. 在 **无状态负载详情页**，选择 **实例列表** 页签，查看无状态负载对应的 Pod 是否均处于 **Running** 状态。 3. 单击 Pod 名称进入 **容器组详情页**，然后单击页面右上角 **控制台** 登录 Pod 后执行如下命令验证环境变量是否注入成功。 ```Bash env | grep CONFIG_ ``` 输出内容与配置项内容一致，表明环境变量注入方式已成功使无状态负载访问到配置项数据。通过 kubectl 配置 1. 通过 kubectl 连接目标集群，详情请参见 [使用 kubectl 连接集群](https://www.volcengine.com/docs/6460/100942)。 2. Deployment 对应的 YAML 示例文件`configmap-env-demo.yaml`内容如下。详细的 YAML 配置说明，请参见 [创建无状态负载](https://docs.volcengine.com/docs/6460/100971)。 ```YAML apiVersion: apps/v1 kind: Deployment metadata: name: configmap-env-demo # Deployment 名称。 namespace: default # Deployment 命名空间，需与 ConfigMap 一致。 spec: replicas: 2 # Deployment 副本数。 selector: matchLabels: app: configmap-env-demo template: metadata: labels: app: configmap-env-demo spec: containers: - name: nginx image: vke-cn-beijing.cr.volces.com/vke/nginx:latest # 容器镜像，请替换为您自己的镜像地址。 ports: - containerPort: 80 envFrom: # 批量注入 ConfigMap 所有键值对。 - prefix: CONFIG_ # 可选：为所有注入的环境变量添加统一前缀。 configMapRef: name: demo-config # ConfigMap 名称。 ``` 3. 执行以下命令，创建 Deployment。 ```Bash kubectl apply -f configmap-env-demo.yaml ``` 4. 执行以下命令，检查工作负载是否正常拉起。输出 Pod 为 **Running** 状态，说明 Deployment 创建成功。 ```Bash kubectl get pods -l app=configmap-env-demo -n default ``` 5. 执行以下命令，验证环境变量是否注入成功。 ```Bash kubectl exec deployment/configmap-env-demo -n default -- env | grep CONFIG_ ``` 预期输出中应包含`CONFIG_APP_MODE=prod`、`CONFIG_LOG_LEVEL=info`、`CONFIG_PLAYER_NAME=vke-user`。 ### 场景二：数据卷挂载下文以 Deployment 为例，介绍如何将 ConfigMap 挂载为工作负载的数据卷。通过控制台配置 1. 登录 [容器服务控制台](https://console.volcengine.com/vke)。 2. 单击左侧导航栏中的 **集群**。 3. 在集群列表页面，单击目标集群。 4. 选择 **工作负载** \> **无状态负载**，单击 **创建无状态负载**。 5. 在 **创建无状态负载** 页面，部分参数按如下说明配置，其余参数按实际需求自定义配置。详细操作，请参见 [创建无状态负载](https://docs.volcengine.com/docs/6460/100971)。在 ②**容器配置** 步骤中，按如下说明配置 **存储配置** 区域的参数。 * 在 **添加卷** 中，单击`+`图标，将配置项配置为存储卷。 * 在 **挂载卷** 中，单击`+`图标，挂载配置好的配置项。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_153fb53e4b9851f82003e1d11ce5bf09.png) 6. 单击 **确定**，创建完成无状态负载。 7. 检查无状态负载创建结果并查看环境变量是否注入成功。 1. 在 **无状态负载** 页面找到刚创建的负载，单击名称进入 **无状态负载详情页**。 2. 在 **无状态负载详情页**，选择 **实例列表** 页签，查看无状态负载对应的 Pod 是否均处于 **Running** 状态。 3. 单击 Pod 名称进入 **容器组详情页**，然后单击页面右上角 **控制台** 登录 Pod 后执行如下命令验证配置项是否挂载成功。 ```Bash ls /etc/config/ ``` 输出内容为 ConfigMap 中各 key 对应的文件名（例如`APP_MODE`、`LOG_LEVEL`等），即说明挂载成功。 4. 执行如下命令，验证配置项文件内容是否正确。 ```Bash cat /etc/config/APP_MODE ``` 输出`APP_MODE`文件对应的值（如`prod`），说明配置项内容正确。通过 kubectl 配置 1. 通过 kubectl 连接目标集群，详情请参见 [使用 kubectl 连接集群](https://www.volcengine.com/docs/6460/100942)。 2. Deployment 对应的 YAML 示例文件`configmap-volume-demo.yaml`内容如下。详细的 YAML 配置说明，请参见 [创建无状态负载](https://docs.volcengine.com/docs/6460/100971)。 ```YAML apiVersion: apps/v1 kind: Deployment metadata: name: configmap-volume-demo # Deployment 名称。 namespace: default # Deployment 命名空间，需与 ConfigMap 一致。 spec: replicas: 1 # Deployment 副本数。 selector: matchLabels: app: configmap-volume-demo template: metadata: labels: app: configmap-volume-demo spec: containers: - name: nginx image: vke-cn-beijing.cr.volces.com/vke/nginx:latest # 容器镜像，请替换为您自己的镜像地址。 command: ["/bin/sh", "-c", "cat /etc/config/game.properties && sleep 3600"] volumeMounts: # 容器内挂载配置。 - name: config-volume # 引用下方 volumes 中定义的卷名称。 mountPath: /etc/config # 容器内挂载目录。ConfigMap 中映射出的文件会出现在该目录下，应用可直接按文件路径读取。 readOnly: true # 开启只读挂载，防止容器内误修改。 volumes: # Pod 级别的卷定义。 - name: config-volume # 卷名称，与 volumeMounts.name 对应。 configMap: name: demo-config # 引用的 ConfigMap 名称。 items: # 可选：指定只挂载部分 key。 - key: game.properties path: game.properties ``` 3. 执行以下命令，创建 Deployment。 ```Bash kubectl apply -f configmap-volume-demo.yaml ``` 4. 执行以下命令，检查工作负载是否正常拉起。输出 Pod 为 **Running** 状态，说明 Deployment 创建成功。 ```Bash kubectl get pods -l app=configmap-volume-demo -n default ``` 5. 执行以下命令，验证 ConfigMap 是否成功挂载且内容正确。 ```Bash kubectl exec deployment/configmap-volume-demo -n default -- ls -l /etc/config ``` 输出的挂载目录列表中包含`game.properties`文件，则表示挂载成功。 6. 执行以下命令，检查 ConfigMap 内容是否正确。 ```Bash kubectl exec deployment/configmap-volume-demo -n default -- cat /etc/config/game.properties ``` 输出的内容与 ConfigMap 中定义的键值一致（如下示例），则说明数据卷挂载成功。 ```Bash APP_MODE=prod LOG_LEVEL=info PLAYER_NAME=vke-user ``` ## 后续操作若您更新 ConfigMap 后希望工作负载尽快生效，则按如下说明操作： * 环境变量场景通常需要执行滚动更新，例如以 Deployment 为例，执行以下命令滚动升级。 ```Bash kubectl rollout restart deployment/ -n # 替换为您自己的 Deployment 名称。 # 替换为您 Deployment 所在命名空间。 ``` * 数据卷挂载场景则需要结合应用自身热加载机制有您自己判断是否需要重启。