All Products
Search
Document Center

Container Service for Kubernetes:Manage ConfigMaps

Last Updated:Mar 25, 2026

ConfigMaps let you store non-sensitive, unencrypted configuration data separately from your application code in Container Service for Kubernetes (ACK). For example, if your app reads a DATABASE_HOST environment variable, you can set it to localhost for local development and to a Kubernetes Service name in your cluster—without rebuilding the container image each time.

Prerequisites

Before you begin, ensure that you have:

Create a ConfigMap

  1. Log on to the ACK console. In the left-side navigation pane, click ACK consoleClusters.

  2. On the Clusters page, click the name of the cluster you want to manage, then choose Configurations > ConfigMaps in the left-side navigation pane.

  3. On the ConfigMap page, select the namespace where you want to create the ConfigMap.

    Create the ConfigMap using one of the following methods:

    • Method 1: Click Create

      1. In the upper-right corner, click Create.

      2. In the Create panel, enter a name for the ConfigMap.

        • The name can contain lowercase letters, digits, hyphens (-), and periods (.). This field is required. Other resources reference this name to retrieve the configuration data.

      3. Click + Add, enter a key and a value, then click OK.

        • To add multiple entries, repeat this step. Alternatively, click Import to import a JSON file to create the ConfigMap.

    • Method 2: Click Create from YAML

      1. In the upper-right corner, click Create from YAML.

      2. In the Sample Template drop-down list, select one of the following options:

        Option

        Description

        Custom

        Write the ConfigMap definition in YAML syntax.

        Resource - ConfigMap

        Start from a pre-filled template named aliyun-config that includes two example variable files: game.properties and ui.properties. Modify the template to fit your needs.

      3. Click Create.

    After the ConfigMap is created, it appears on the ConfigMap page.

View, edit, and delete ConfigMaps

Important

Updating a ConfigMap affects all applications that reference it.

On the ConfigMap page, you can perform the following operations:

OperationSteps
View detailsClick the name of the ConfigMap.
Edit key-value pairsIn the Actions column, click Edit. Update the Name or Value fields, then save.
Edit YAMLIn the Actions column, click Edit YAML. In the View in YAML panel, update the definition and click OK.
DeleteIn the Actions column, click Delete.

What's next

For more information about how to use ConfigMaps in pods, see Configure a pod to use a ConfigMap.