Configure and apply a Kubernetes ConfigMap

Octopus.KubernetesDeployConfigMap exported 2026-07-22 by Octopus Deploy belongs to ‘Kubernetes’ category.

Deploy a ConfigMap resource to Kubernetes.

Parameters

When this step is included in a project’s deployment process, the parameters below can be set.

Config Map Name

Octopus.Action.KubernetesContainers.ConfigMapName (required)

The name of the ConfigMap resource.

Example: my-config-map

Config Map Items

Octopus.Action.KubernetesContainers.ConfigMapValues

The ConfigMap resource values. Provided as a JSON object of key-value pairs.

Example: {"key1": "value1"}

Config Map Labels

Octopus.Action.KubernetesContainers.DeploymentLabels

The labels applied to the ConfigMap resource. Provided as a JSON object of key-value pairs.

Namespace

Octopus.Action.KubernetesContainers.Namespace

The Kubernetes namespace for the ConfigMap.

Resource Status Check

Octopus.Action.Kubernetes.ResourceStatusCheck

Whether to verify that the ConfigMap reached its desired state after deployment.

Allowed values: True, False

Default: True

Server-Side Apply

Octopus.Action.Kubernetes.ServerSideApply.Enabled

Whether to use server-side apply (—server-side) when calling kubectl apply.

Allowed values: True, False

Default: True

Force Conflicts

Octopus.Action.Kubernetes.ServerSideApply.ForceConflicts

Whether to forcefully overwrite conflicts (—force-conflicts) when using server-side apply.

Allowed values: True, False

Default: True

Step configuration using OCL

Example in Octopus Configuration Language (OCL):

step "deploy-configmap" {
    name = "Deploy ConfigMap"
    properties = {
        Octopus.Action.TargetRoles = "k8s-cluster"
    }

    action {
        action_type = "Octopus.KubernetesDeployConfigMap"
        properties = {
            Octopus.Action.Kubernetes.ResourceStatusCheck = "True"
            Octopus.Action.Kubernetes.ServerSideApply.Enabled = "True"
            Octopus.Action.Kubernetes.ServerSideApply.ForceConflicts = "True"
            Octopus.Action.KubernetesContainers.ConfigMapName = "my-config"
            Octopus.Action.KubernetesContainers.Namespace = "default"
            Octopus.Action.RunOnServer = "false"
        }
    }
}

Page updated on Wednesday, July 22, 2026