From 4270513c19f4e0d22465aae567a0591441bc60b7 Mon Sep 17 00:00:00 2001 From: Shyam Jeedigunta Date: Mon, 5 Jun 2017 10:12:30 -0700 Subject: [PATCH 1/2] Update ConfigMap doc to explain TTL-based cache updates --- docs/tasks/configure-pod-container/configure-pod-configmap.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/tasks/configure-pod-container/configure-pod-configmap.md b/docs/tasks/configure-pod-container/configure-pod-configmap.md index ab102aecb8c06..fac5d32f89a04 100644 --- a/docs/tasks/configure-pod-container/configure-pod-configmap.md +++ b/docs/tasks/configure-pod-container/configure-pod-configmap.md @@ -273,6 +273,10 @@ very You can project keys to specific paths and specific permissions on a per-file basis. The [Secrets](/docs/concepts/configuration/secret#using-secrets-as-files-from-a-pod) user guide explains the syntax. +### Mounted ConfigMaps are updated automatically + +When a ConfigMap being already consumed in a volume is updated, projected keys are eventually updated as well. Kubelet is checking whether the mounted ConfigMap is fresh on every periodic sync. However, it is using its local ttl-based cache for getting the current value of the ConfigMap. As a result, the total delay from the moment when the ConfigMap is updated to the moment when new keys are projected to the pod can be as long as kubelet sync period + ttl of ConfigMaps cache in kubelet. + {% endcapture %} {% capture discussion %} From d593a3c2b6a884c0e6de8eb3617dd9c2597f1aab Mon Sep 17 00:00:00 2001 From: Andrew Chen Date: Mon, 5 Jun 2017 10:39:45 -0700 Subject: [PATCH 2/2] swap word order Change "When a ConfigMap being already consumed..." to "When a ConfigMap already being consumed..." --- docs/tasks/configure-pod-container/configure-pod-configmap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tasks/configure-pod-container/configure-pod-configmap.md b/docs/tasks/configure-pod-container/configure-pod-configmap.md index fac5d32f89a04..35f81e6dfb47e 100644 --- a/docs/tasks/configure-pod-container/configure-pod-configmap.md +++ b/docs/tasks/configure-pod-container/configure-pod-configmap.md @@ -275,7 +275,7 @@ basis. The [Secrets](/docs/concepts/configuration/secret#using-secrets-as-files- ### Mounted ConfigMaps are updated automatically -When a ConfigMap being already consumed in a volume is updated, projected keys are eventually updated as well. Kubelet is checking whether the mounted ConfigMap is fresh on every periodic sync. However, it is using its local ttl-based cache for getting the current value of the ConfigMap. As a result, the total delay from the moment when the ConfigMap is updated to the moment when new keys are projected to the pod can be as long as kubelet sync period + ttl of ConfigMaps cache in kubelet. +When a ConfigMap already being consumed in a volume is updated, projected keys are eventually updated as well. Kubelet is checking whether the mounted ConfigMap is fresh on every periodic sync. However, it is using its local ttl-based cache for getting the current value of the ConfigMap. As a result, the total delay from the moment when the ConfigMap is updated to the moment when new keys are projected to the pod can be as long as kubelet sync period + ttl of ConfigMaps cache in kubelet. {% endcapture %}