Creating ConfigMaps

1. Log in to the CCI console. In the navigation pane, choose Configuration Center > ConfigMaps. On the page displayed on the right, select a namespace and click Create ConfigMap.
2. Select a creation mode. CCI allows you to create a ConfigMap by manually specifying parameters or uploading a file.
   • Method 1: manually specifying parameters. Configure parameters based on the description in Table 1. Parameters marked with an asterisk (*) are mandatory.

     Table 1 Parameter description

     Parameter	Description
     Basic information
     * Name	Name of the ConfigMap. Enter 1 to 253 characters starting and ending with a letter or digit. Only lowercase letters, digits, hyphens (-), and periods (.) are allowed. Do not enter two consecutive periods or a period adjacent to a hyphen.
     Description	Description of the ConfigMap.
     Data	Configuration data to be stored in the ConfigMap. Key indicates the file name and Value indicates the file content. Click Add Data. Enter a key and a value.
     Label	Labels are attached to various objects (such as workloads and services) in the form of key-value pairs. Labels define the identifiable properties of these objects and are used to manage and select them. Click Add Label. Enter a key and a value.

   • Method 2: uploading a file.
     

     Ensure that the file is in JSON or YAML format and the file size is less than 1 MB. For details, see ConfigMap File Format.

     Click Add File, select an existing ConfigMap resource file, and click Open.

3. Click Create.

Using ConfigMaps

After you create a ConfigMap, mount it to the specified directory of the container during workload creation. As shown in the following figure, mount ConfigMap cci-configmap01 to the /tmp/configmap1 directory.

Figure 1 Using a ConfigMap

After you create the workload, a ConfigMap file will be created under /tmp/configmap1. The key of the ConfigMap indicates the file name, and the value indicates the file content.

ConfigMap File Format

A ConfigMap resource file must be in JSON or YAML format, and the file size cannot exceed 1 MB.

• JSON format

  An example of the configmap.json file is as follows:

  {
      "kind": "ConfigMap",
      "apiVersion": "v1",
      "metadata": {
          "name": "test-configmap",
          "labels": {
              "label-01": "value-01",
              "label-02": "value-02"
          },
          "annotations": {
              "description": "a test configmap"
          },
          "enable": true
      },
      "data": {
          "key-01": "value-01",
          "key-02": "value-02"
      }
  }

• YAML format
  An example of the configmap.yaml file is as follows:

  apiVersion: v1
  kind: ConfigMap
  metadata:
    name: test-configmap
    labels:
      label-01: value-01
      label-02: value-02
    annotations:
      description: "a test configmap"
    enable: true
  data:  
    key-01: value-01
    key-02: value-02

Creating a ConfigMap Using kubectl

For details, see ConfigMap.