Anthos clusters on bare metal uses certificates and private keys to authenticate and encrypt
connections between system components in clusters. The cluster certificate
authority (CA) manages these certificates and keys. When you run the
bmctl update credentials certificate-authorities rotate command,
Anthos clusters on bare metal performs following actions:
Creates and uploads new cluster certificate authorities (CAs) for the cluster CA, the etcd CA, and the front-proxy CA to the user cluster namespace in the admin cluster.
The admin cluster controllers replace the user cluster certificate authorities with the newly generated ones.
The admin cluster controllers distribute the new public CA certificates and leaf certificate key pairs to user cluster system components.
To maintain secure cluster communication, rotate your user cluster CA periodically and whenever there is a possible security breach.
Before you begin
Before you rotate your cluster's certificate authority, plan according to the following conditions and impacts:
Ensure admin and user clusters are at version 1.9.0 or higher before starting the CA rotation.
CA rotation is incremental, allowing system components to communicate during the rotation.
The CA rotation process restarts the API server, control plane processes, and pods in the user cluster.
Expect workloads to restart and be rescheduled during CA rotation.
For non-high-availability cluster configurations, expect brief periods of control plane downtime during CA rotation.
Cluster management operations aren't allowed during CA rotation.
CA rotation duration depends on the size of your cluster. For example, CA rotation may take close to two hours to complete for a cluster with one control plane and 50 worker nodes.
The certificate authority rotation capability has the following limitations:
CA rotation doesn't update certificates issued manually by an administrator, even if the cluster CA signs the certificates. Update and redistribute any manually issued certificates after user cluster CA rotation is complete.
Once started, CA rotation can't be paused or rolled back.
Cluster CA rotation is a preview feature and its interfaces and operation are subject to change.
Start a cluster CA rotation
Use the following command to start the CA rotation process:
bmctl update credentials certificate-authorities rotate --cluster CLUSTER_NAME \ --kubeconfig ADMIN_KUBECONFIG
Replace the following:
CLUSTER_NAME: the name of the cluster for which you want to rotate CAs.
ADMIN_KUBECONFIG: the path to the admin cluster kubeconfig file. For self-managing clusters, this file is the cluster's kubeconfig file.
bmctl command exits after the CA is rotated successfully and a new
kubeconfig file is generated. The standard path for the kubeconfig file is
Troubleshoot a cluster CA rotation
bmctl update credentials command displays the progress of the CA rotation.
update-credentials.log file is saved to the following