Skip to content

Commit 8c61a3f

Browse files
authored
Merge pull request #24423 from neolit123/1.20-amend-ca-rotation-page
manual-ca-rotation: adjust note for "--client-ca-file"
2 parents 7939600 + c6ac783 commit 8c61a3f

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

content/en/docs/tasks/tls/manual-rotation-of-ca-certificates.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -33,14 +33,17 @@ Configurations with a single API server will experience unavailability while the
3333
(ex: `ca.crt`, `ca.key`, `front-proxy-ca.crt`, and `front-proxy-ca.key`)
3434
to all your control plane nodes in the Kubernetes certificates directory.
3535

36-
1. Update *Kubernetes controller manager's* `--root-ca-file` to include both old and new CA and restart controller manager.
36+
1. Update {{< glossary_tooltip text="kube-controller-manager" term_id="kube-controller-manager" >}}'s `--root-ca-file` to
37+
include both old and new CA. Then restart the component.
3738

3839
Any service account created after this point will get secrets that include both old and new CAs.
3940

4041
{{< note >}}
41-
Remove the flag `--client-ca-file` from the *Kubernetes controller manager* configuration.
42-
You can also replace the existing client CA file or change this configuration item to reference a new, updated CA.
43-
[Issue 1350](https://github.com/kubernetes/kubeadm/issues/1350) tracks an issue with *Kubernetes controller manager* being unable to accept a CA bundle.
42+
The files specified by the kube-controller-manager flags `--client-ca-file` and `--cluster-signing-cert-file`
43+
cannot be CA bundles. If these flags and `--root-ca-file` point to the same `ca.crt` file which is now a
44+
bundle (includes both old and new CA) you will face an error. To workaround this problem you can copy the new CA to a separate
45+
file and make the flags `--client-ca-file` and `--cluster-signing-cert-file` point to the copy. Once `ca.crt` is no longer
46+
a bundle you can restore the problem flags to point to `ca.crt` and delete the copy.
4447
{{< /note >}}
4548

4649
1. Update all service account tokens to include both old and new CA certificates.

0 commit comments

Comments
 (0)