配置项(ConfigMap)是一种用于存储工作负载所需配置信息的资源类型,需要您自定义配置项的内容。
创建配置项
本部分介绍如何通过容器应用服务控制台完成配置项创建操作。
操作步骤
登录容器应用服务控制台,在左侧导航栏单击 配置 > 配置项。
单击 创建,在 创建配置项 页面,填写以下信息:
命名空间:选择命名空间。若不选择,默认为 default。
名称:配置项名称,同一个命名空间里命名必须唯一,最多 32 个字符。
配置源:
键值对:键代表文件名,值代表文件中的内容。
文件:可上传文件创建配置项。
配置完成后,单击 创建。
使用配置项
您可以在 Pod 中使用配置项,主要包括以下使用场景:
- 重要
在 Pod 里使用配置项时,需两者处于同一命名空间中。
更多关于配置项的信息,可参见 Configure a Pod to Use a ConfigMap。
用配置项定义 Pod 环境变量
您可以使用配置项定义 Pod 中环境变量,使用 valueFrom
引用配置项数据。
登录容器应用服务控制台,在左侧导航栏单击 工作负载 > 容器组(Pods)。
单击 从 YAML 创建,在输入框中输入以下内容,单击 创建。
下面是一个编排示例。
apiVersion: v1 kind: Pod metadata: name: config-pod-1 namespace: yournamespace #改成当前的命名空间名称 spec: containers: - name: test-container image: busybox command: [ "/bin/sh", "-c", "env" ] env: - name: SPECIAL_LEVEL_KEY valueFrom: #使用valueFrom来指定env引用配置项的value值 configMapKeyRef: name: special-config #引用的配置文件名称 key: SPECIAL_LEVEL #引用的配置项key restartPolicy: Never
通过配置项设置命令行参数
您可以使用配置项设置容器中的命令或者参数值,使用环境变量替换语法 $(VAR_NAME)
来进行。
登录容器应用服务控制台,在左侧导航栏单击 工作负载 > 容器组(Pods)。
单击 从 YAML 创建,在输入框中输入以下内容,单击 创建。
下面是一个编排示例。
apiVersion: v1 kind: Pod metadata: name: config-pod-3 namespace: yournamespace # 改成当前的命名空间名称 spec: containers: - name: test-container image: 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
运行该 Pod 后,会输出如下结果。
very charm
在数据卷中使用配置项
您也可以在数据卷里面使用配置项,在 volumes 下指定配置项名称,会将 key/values 的数据存储到 mountPath 路径下(本例中是 /etc/config
)。最终生成以 key 为文件名,values 为文件内容的配置文件。
登录容器应用服务控制台,在左侧导航栏单击 工作负载 > 容器组(Pods)。
单击 从 YAML 创建,在输入框中输入以下内容,单击 创建。
下面是一个编排示例。
apiVersion: v1 kind: Pod metadata: name: config-pod-4 namespace: yournamespace #改成当前的命名空间名称 spec: containers: - name: test-container image: busybox command: [ "/bin/sh", "-c", "ls /etc/config/" ] #列出该目录下的文件名 volumeMounts: - name: config-volume mountPath: /etc/config volumes: - name: config-volume configMap: name: special-config restartPolicy: Never
运行 Pod 后,会输出配置项的 key。
SPECIAL_TYPE
SPECIAL_LEVEL
修改配置项
修改配置文件会影响使用该配置文件的应用。
操作步骤
登录容器应用服务控制台,在左侧导航栏单击 配置 > 配置项。
在配置项列表页,单击 名称 进入配置项详情页。
您可以进行以下修改:
单击 编辑,修改已有的配置项数据,单击 提交。
单击 添加配置项数据,增加变量名和值,单击 提交。
查看配置项
前提条件
已 创建配置项。
操作步骤
登录容器应用服务控制台,在左侧导航栏单击 配置 > 配置项。
在配置项列表页,单击 名称 进入配置项详情页,查看配置项详细数据。