配置字典

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

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

本教程演示如何在 KubeSphere 中创建配置字典。

准备工作

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

创建配置字典

  1. 以 project-regular 用户登录控制台并进入项目，在左侧导航栏中选择配置下的配置字典，然后点击创建。

  2. 在弹出的对话框中，设置配置字典的名称（例如 demo-configmap），然后点击下一步。

    提示

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

  3. 在数据设置选项卡，点击添加数据以配置键值对。

  4. 输入一个键值对。下图为示例：

    备注

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

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

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

  6. 点击创建以生成配置字典。

查看配置字典详情

  1. 配置字典创建后会显示在配置字典页面。您可以点击右侧的 配置字典 - 图1，并从下拉菜单中选择操作来修改配置字典。

    • 编辑：查看和编辑基本信息。
    • 编辑 YAML：查看、上传、下载或更新 YAML 文件。
    • 编辑设置：修改配置字典键值对。
    • 删除：删除配置字典。

  2. 点击配置字典名称打开其详情页面。在数据选项卡，您可以查看配置字典的所有键值对。

  3. 点击更多操作对配置字典进行其他操作。

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

使用配置字典

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