您正在查看 KubeSphere 版本的文档:v3.0.0

KubeSphere v3.0.0 版本的文档已不再维护。您现在看到的版本来自于一份静态的快照。如需查阅最新文档,请点击 最新版本

ConfigMap

Kubernetes ConfigMap 以键值对的形式存储配置数据。ConfigMap 资源可用于向 Pod 中注入配置数据。ConfigMap 对象中存储的数据可以被 ConfigMap 类型的卷引用,并由 Pod 中运行的容器化应用使用。ConfigMap 通常用于以下场景:

  • 设置环境变量的值。
  • 设置容器中的命令参数。
  • 在卷中创建配置文件。

本教程演示如何在 KubeSphere 中创建 ConfigMap。

准备工作

您需要创建一个企业空间、一个项目和一个帐户(例如 project-regular)。该帐户必须已邀请至该项目,并具有 operator 角色。有关更多信息,请参阅创建企业空间、项目、帐户和角色

创建 ConfigMap

步骤 1:进入 ConfigMap 页面

project-regular 用户登录控制台并进入项目,在左侧导航栏中选择配置中心下的配置,然后点击创建

create-configmap

步骤 2:配置基本信息

设置 ConfigMap 的名称(例如 demo-configmap),然后点击下一步

提示

您可以在对话框右上角启用编辑模式来查看 ConfigMap 的 YAML 清单文件,并通过直接编辑清单文件来创建 ConfigMap。您也可以继续执行后续步骤在控制台上创建 ConfigMap。

set-basic-info

步骤 3:配置键值对

  1. 配置设置选项卡,点击添加数据以配置键值对。

    add-data

  2. 配置一个键值对。下图为示例:

    key-value

    备注

    • 配置的键值对会显示在清单文件中的 data 字段下。

    • 目前 KubeSphere 控制台只支持在 ConfigMap 中配置键值对。未来版本将会支持添加配置文件的路径来创建 ConfigMap。

  3. 点击对话框右下角的 以保存配置。您可以再次点击添加数据继续配置更多键值对。

    finish-creating

  4. 配置完成后点击创建来生成 ConfigMap。

查看 ConfigMap 详情

  1. ConfigMap 创建后会显示在如图所示的列表中。您可以点击右边的三个点,并从下拉菜单中选择操作来修改 ConfigMap。

    configmap-list

    • 编辑:查看和编辑基本信息。
    • 编辑配置文件:查看、上传、下载或更新 YAML 文件。
    • 修改配置:修改 ConfigMap 键值对。
    • 删除:删除 ConfigMap。
  2. 点击 ConfigMap 名称打开 ConfigMap 详情页面。在详情选项卡,您可以查看 ConfigMap 的所有键值对。

    detail-page

  3. 点击更多操作对 ConfigMap 进行其他操作。

    configmap-dropdown-menu

    • 编辑配置文件:查看、上传、下载或更新 YAML 文件。
    • 修改配置:修改 ConfigMap 键值对。
    • 删除:删除 ConfigMap 并返回 ConfigMap 列表页面。
  4. 点击编辑信息来查看和编辑 ConfigMap 的基本信息。

    edit-configmap-info

使用 ConfigMap

在创建工作负载、服务任务定时任务时,您可以用 ConfigMap 为容器添加环境变量。您可以在容器镜像页面勾选环境变量,点击引用配置文件或密钥,然后从下拉列表中选择一个 ConfigMap。

use-configmap