Course contentsShow
← Cloud and Infrastructure
Lesson 1257 of 2,98925. Kubernetes Configuration and SecretsFree lesson

ConfigMap Naming and Labeling Strategies

Apply naming conventions and labels to manage ConfigMap versions and facilitate rollbacks.

ConfigMap Naming and Labeling Strategies

What you'll learn: How to use smart naming and labeling conventions to track ConfigMap versions and enable easy rollbacks.

Why Naming and Labeling Matter

You've learned to create and use ConfigMaps, but as your application evolves, so does its configuration. When you update a ConfigMap, Kubernetes doesn't automatically track which version was used by which deployment. Without a clear naming strategy, rolling back to a previous configuration becomes guesswork.

Think of ConfigMaps like recipe cards in a kitchen. If you just call every version "recipe," you'll never know which one worked last Tuesday when the dish came out perfectly. But if you label them "recipe-v1," "recipe-v2," and tag them with dates and ingredients, you can always recreate success.

Naming Conventions for Versioning

Instead of reusing the same ConfigMap name (like app-config), include a version identifier:

  • app-config-v1, app-config-v2, app-config-v3
  • app-config-20240115, app-config-20240201 (date-based)
  • app-config-abc123f (git commit hash)

When you deploy a new version, create a new ConfigMap and update your Deployment to reference it. This creates an immutable history.

Label Everything

Apply labels to track ownership, environment, and version:

metadata:
  name: app-config-v2
  labels:
    app: myapp
    version: "v2"
    environment: production
    config-type: application

These labels let you quickly query: "What ConfigMaps belong to this app?" or "Which version is in production?" You can also label your Deployments with matching config-version labels to see what's using what.

Rollback-Friendly Approach

With versioned ConfigMaps, rolling back is simple: update your Deployment's configMapRef to point to the previous ConfigMap name. No guessing, no overwriting—just point to the known-good version.

Key Takeaway: Use versioned names and descriptive labels for ConfigMaps to maintain a clear audit trail and enable instant, reliable rollbacks without overwriting configuration history.