OpsCanary
kubernetesconfigPractitioner

Mastering ConfigMaps: Injecting Configurations into Your Kubernetes Pods

5 min read Kubernetes DocsApr 28, 2026Reviewed for accuracy
Share
PractitionerHands-on experience recommended

ConfigMaps exist to solve a fundamental problem: keeping your application configurations separate from your container images. This separation allows for greater flexibility and portability, enabling you to change configurations without rebuilding your images. By using ConfigMaps, you can inject configuration data directly into your application pods, making it easier to manage different environments or settings without altering the core application code.

The ConfigMap mechanism works by allowing you to create a ConfigMap using commands like 'kubectl create configmap' or through a ConfigMap generator in 'kustomization.yaml'. When you create a ConfigMap from a file, the key defaults to the file's basename, while the value is the file's content. You can specify a directory, file, or literal value as your data source. For example, to create a ConfigMap from multiple files, you can use a command like: 'kubectl create configmap game-config-2 --from-file=configure-pod-container/configmap/game.properties --from-file=configure-pod-container/configmap/ui.properties'. This flexibility is crucial for managing complex applications with various configuration needs.

In production, be aware of the gotchas. Each filename used in ConfigMap creation must consist of acceptable characters (letters, digits, '-', '_', or '.'). If any filename contains unacceptable characters, the command may fail without an error message. Starting with Kubernetes v1.23, you can use the '--from-env-file' argument multiple times, allowing for even more complex configurations. Ensure you have a properly configured Kubernetes cluster and the necessary tools, like wget, for downloading files.

Key takeaways

  • Create ConfigMaps using 'kubectl create configmap <map-name> <data-source>'.
  • Use multiple data sources by specifying '--from-file' multiple times.
  • Ensure filenames for ConfigMaps contain only acceptable characters.
  • Utilize '--from-env-file' for creating ConfigMaps from environment variable files.
  • Check your Kubernetes version for support of multiple '--from-env-file' arguments.

Why it matters

In production, managing configurations effectively can reduce downtime and streamline deployments. ConfigMaps enable quick adjustments to application settings without the need for redeployment, which is critical for maintaining uptime and responsiveness.

Code examples

Bash
kubectl create configmap <map-name> <data-source>
Bash
kubectl create configmap game-config --from-file=configure-pod-container/configmap/
Bash
kubectl create configmap game-config-2 --from-file=configure-pod-container/configmap/game.properties --from-file=configure-pod-container/configmap/ui.properties

When NOT to use this

The official docs don't call out specific anti-patterns here. Use your judgment based on your scale and requirements.

Want the complete reference?

Read official docs

Test what you just learned

Quiz questions written from this article

Take the quiz →
Better StackSponsor

Unified observability — logs, uptime monitoring, and on-call in one place. Used by 50,000+ engineering teams to ship faster and sleep better.

Try Better Stack free →

Get the daily digest

One email. 5 articles. Every morning.

No spam. Unsubscribe anytime.