Skip to content

Commit 2b457e1

Browse files
authored
Merge pull request #28944 from aliakbar-hemmati/fix-28875
Add explanations for control-plane pods restart after certificate ren…
2 parents 08c735e + 85cc70b commit 2b457e1

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

content/en/docs/tasks/administer-cluster/kubeadm/kubeadm-certs.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,18 @@ command. In that case, you should explicitly set `--certificate-renewal=true`.
126126

127127
You can renew your certificates manually at any time with the `kubeadm certs renew` command.
128128

129-
This command performs the renewal using CA (or front-proxy-CA) certificate and key stored in `/etc/kubernetes/pki`.
129+
This command performs the renewal using CA (or front-proxy-CA) certificate and key stored in `/etc/kubernetes/pki`.
130+
131+
After running the command you should restart the control plane Pods. This is required since
132+
dynamic certificate reload is currently not supported for all components and certificates.
133+
[Static Pods](/docs/tasks/configure-pod-containerstatic-pod/) are managed by the local kubelet
134+
and not by the API Server, thus kubectl cannot be used to delete and restart them.
135+
To restart a static Pod you can temporarily remove its manifest file from `/etc/kubernetes/manifests/`
136+
and wait for 20 seconds (see the `fileCheckFrequency` value in [KubeletConfiguration struct](/docs/
137+
reference/config-api/kubelet-config.v1beta1/).
138+
The kubelet will terminate the Pod if it's no longer in the manifest directory.
139+
You can then move the file back and after another `fileCheckFrequency` period, the kubelet will recreate
140+
the Pod and the certificate renewal for the component can complete.
130141

131142
{{< warning >}}
132143
If you are running an HA cluster, this command needs to be executed on all the control-plane nodes.

0 commit comments

Comments
 (0)