Skip to content

Commit 592515d

Browse files
committed
Enhance blog post on Kubernetes ConfigMaps by adding Kanvas Designer section and clarifying reload behavior
Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
1 parent 3a66301 commit 592515d

1 file changed

Lines changed: 40 additions & 3 deletions

File tree

  • src/collections/blog/2025/11-03-2025-understanding-configmaps

src/collections/blog/2025/11-03-2025-understanding-configmaps/post.mdx

Lines changed: 40 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -140,15 +140,52 @@ Here’s a simple table to remember the differences:
140140

141141
| Consumption Method | How to Identify in Pod YAML | Are Changes Updated in Running Pod? | How Are Changes Seen? |
142142
| :--- | :--- | :--- | :--- |
143-
| **Environment Variables** | `spec.containers.env` <br> `spec.containers.envFrom` | **No**| Pod must be **restarted**. |
144-
| **Mounted Volume** | `spec.containers.volumeMounts` <br> `spec.volumes` | **Yes** ✅ (with delay) | Kubelet updates files. **Application must be coded** to reload the updated file. |
143+
| **Environment Variables** | `spec.containers.env` `spec.containers.envFrom` | **No**| Pod must be **restarted**. |
144+
| **Mounted Volume** | `spec.containers.volumeMounts` `spec.volumes` | **Yes** ✅ (with delay) | Kubelet updates files. **Application must be coded** to reload the updated file. |
145145

146146
### What If I Need Automatic Restarts?
147147

148148
If you are using the volume mount method but your application doesn't support live reloading, you can use a "reloader" tool. A popular open-source controller like [**Stakater's Reloader**](https://github.com/stakater/Reloader) can watch for ConfigMap changes and automatically trigger a rolling restart of any Deployment that uses it. This gives you the best of both worlds: configuration in files and automatic updates for apps that can't reload on their own.
149149

150150
-----
151151

152-
This [Kubernetes ConfigMap Tutorial video](https://www.youtube.com/watch?v=P7mHN_PUz_w) provides a great visual walkthrough of how to create and use ConfigMaps, including injecting them as both volumes and environment variables.
152+
Alternatively, you can skip the YAML editing and make these changes visually. That is, if you're managing your Kubernetes cluster using Kanvas. Let's break down how to use it to manage your resources, like a `ConfigMap`.
153+
154+
## 🤔 What is Kanvas Designer?
155+
156+
[Layer5's Kanvas](https://layer5.io/kanvas) is a powerful tool for designing, deploying, and managing your Kubernetes and Cloud infrastructure and workloads from a visual interface. Instead of writing hundreds of lines of YAML by hand, you build a **Design**. This design is a visual representation of your components (`Deployment`, `Service`, `ConfigMap`, etc.) and their relationships.
157+
158+
-----
159+
160+
## 🎨 How to Update a ConfigMap in Kanvas Designer
161+
162+
Updating a `ConfigMap` through the Designer follows this "design-first" workflow. You don't just "edit" the live resource in the cluster; you **update your design** and then **(re-)deploy it**.
163+
164+
Here is the step-by-step process:
165+
166+
1. **Open Kanvas Designer:** Log in to your Kanvas UI and navigate to Designer mode (the default mode).
167+
168+
2. **Load Your Design:** Open the design file that contains the `ConfigMap` you want to edit. If you don't have a design yet, you can import your existing `ConfigMap` from your cluster directly onto the canvas.
169+
170+
3. **Find the ConfigMap Component:** On the visual canvas, find the block representing your `ConfigMap`. It will have the Kubernetes icon and the "ConfigMap" kind.
171+
172+
4. **Edit the Configuration:** Click on the component. A configuration panel will slide out, often with a 'Configure' tab or an editor icon. This will show you the key/value pairs for that *specific* `ConfigMap` resource.
173+
174+
5. **Deploy the Design:** Changes are automatically saved in your design as you make them. Use the **Deploy** button to send your entire design to your target Kubernetes or Cloud environment. Kanvas will calculate the difference (a "diff") and apply the updated `ConfigMap` manifest to your cluster. This action is the equivalent of running `kubectl` server-side apply using your design.
175+
176+
-----
177+
178+
## 🛑 The Most Important Part: Reload Behavior
179+
180+
This is critical: **Using Kanvas Designer to update a ConfigMap does NOT change how your application reloads it.**
181+
182+
Deploying from Kanvas is just a friendly, visual way to run `kubectl apply`. The rules we discussed in our previous post about ConfigMap behavior still apply completely:
183+
184+
* **If your Pod consumes the ConfigMap as Environment Variables:** Your running Pods **will not** see the change. You must still restart them (e.g., `kubectl rollout restart deployment ...`).
185+
* **If your Pod consumes the ConfigMap as a Mounted Volume:** The files inside the Pod **will** be updated (after the kubelet sync delay), but your application *still* needs to be smart enough to re-read that file from disk.
186+
187+
Kanvas Designer simplifies the *applying* of the change and helps you visually manage your application's state, but it doesn't change the fundamental Kubernetes behavior of *how* that change is consumed by your workloads.
188+
189+
</BlogWrapper>
153190

154191
</BlogWrapper>

0 commit comments

Comments
 (0)