Updated on 2024-06-17 GMT+08:00

ConfigMaps

ConfigMaps allow you to decouple configuration files from container images to enhance the portability of workloads.

ConfigMaps provide the following benefits:

  • Manage configurations for different environments and services.
  • Deploy workloads in different environments. Multiple versions are supported for configuration files so that you can update and roll back workloads easily.
  • Quickly import configurations in the form of files to containers.
  • After a ConfigMap is created on the UCS console, it is in the undeployed state by default. You need to mount the ConfigMap when creating or updating a workload. For details, see ConfigMap.
  • After a ConfigMap is mounted to a workload, a ConfigMap with the same name is created in each cluster to which the workload belongs.

Creating a ConfigMap

  1. Log in to the UCS console. In the navigation pane, choose Fleets.
  2. On the Fleets tab, click the name of the federation-enabled fleet to access its details page.
  3. Choose ConfigMaps and Secrets in the navigation pane and click the ConfigMaps tab.
  4. Select the namespace for which you want to create a ConfigMap and click Create ConfigMap in the upper right corner.
  5. Set the parameters listed in Table 1.

    Table 1 Parameters for creating a ConfigMap

    Parameter

    Description

    Name

    Name of a ConfigMap, which must be unique in a namespace.

    Namespace

    Namespace that the ConfigMap belongs to. The current namespace is used by default.

    Description

    Description of the ConfigMap.

    Data

    The workload configuration data can be used in a container or used to store the configuration data.

    Click and enter the key and value. Key indicates the configuration name, and Value indicates the configuration content.

    Label

    Labels are attached to objects such as workloads, nodes, and Services in key-value pairs.

    Labels define identified attributes of these objects and can be used to manage and select objects.

    1. Enter the label key and value.
    2. Click Confirm.

  6. Click OK.

Using a ConfigMap

After a ConfigMap is created, you can mount the ConfigMap to a container for storage during workload creation. Then, you can read the ConfigMap data from the mount path of the container. For details, see ConfigMap.

Related Operations

You can also perform operations described in Table 2.
Table 2 Related operations

Operation

Description

Creating a ConfigMap from a YAML file

Click Create from YAML in the upper right corner to create a ConfigMap from an existing YAML file.

Viewing details

Click the ConfigMap name to view its details.

Editing a YAML file

Click Edit YAML in the row where the target ConfigMap resides to edit its YAML file.

Updating a ConfigMap

  1. Choose More > Update in the Operation column of the target ConfigMap.
  2. Modify the ConfigMap information according to Table 1.
  3. Click OK to submit the modified information.

Deleting a ConfigMap

Choose More > Delete in the row where the target ConfigMap resides, and click Yes.

Deleting ConfigMaps in batches

  1. Select the ConfigMaps to be deleted.
  2. Click Delete in the upper left corner.
  3. Click Yes.