Puedes rotar las autoridades certificadoras (AC) del sistema principal en un clúster de usuario de Google Distributed Cloud para renovarlas antes de que venzan. Durante una rotación, el clúster de administrador reemplaza las AC del clúster de usuario por las AC recién generadas y, luego, distribuye los certificados y los pares de claves que las AC nuevas emiten a los componentes del sistema. La rotación es incremental, por lo que los componentes del sistema pueden seguir comunicándose, pero las cargas de trabajo y los nodos se reinician. Para rotar las AC en un clúster de administrador, consulta Rota los certificados de la AC del clúster de administrador.
Acerca de las AC del clúster de usuario
El clúster de administrador gestiona tres AC del sistema autofirmadas para cada clúster de usuario. Cada AC emite certificados, llamados certificados de hoja, a componentes individuales del sistema, que los usan para autenticar y encriptar sus conexiones:
- La CA de etcd protege la comunicación del servidor de la API a las réplicas de etcd y el tráfico entre réplicas de etcd.
- La CA del clúster protege la comunicación entre el servidor de la API y todos los clientes internos de la API de Kubernetes (kubelets, controladores, programadores).
- La CA de proxy principal protege la comunicación con las API agregadas.
También puedes usar una
CA de la organización
para firmar el certificado configurado por la opción authentication.sni, que
entrega la API de Kubernetes a los clientes fuera del clúster. Tú administras esta CA
y generas el certificado de SNI de forma manual. La rotación de la AC del clúster de usuario no
afecta a la AC de la organización ni al certificado de SNI.
Limitaciones
Ten en cuenta la siguiente limitación con los clústeres avanzados:
- Versión 1.31: No se admite la rotación de AC en clústeres avanzados.
- Versión 1.32 y posteriores: La rotación de AC es compatible con los clústeres avanzados, pero hay algunas diferencias menores que se indican cuando corresponde en este documento.
La rotación de certificados de la AC se limita a las AC de etcd, clúster y proxy principal mencionadas antes.
La rotación de certificados de la AC se limita a los certificados emitidos de forma automática por Google Distributed Cloud. No actualiza los certificados que emite un administrador de forma manual, incluso si las CA del sistema firman esos certificados.
Una rotación de AC reinicia varias veces el servidor de la API, otros procesos del plano de control y cada nodo del clúster. Cada etapa de una rotación de CA avanza de manera similar a una actualización de clúster. Si bien el clúster de usuario permanece operativo durante una rotación de AC, debes esperar que las cargas de trabajo se reinicien y se reprogramen. También debes esperar períodos breves de tiempo de inactividad del plano de control si tu clúster de usuario no tiene un plano de control de alta disponibilidad.
Debes actualizar el archivo kubeconfig del clúster de usuario y los archivos de configuración de autenticación después de una rotación de AC. Esto se debe a que se revoca el certificado de clúster anterior y las credenciales en el archivo kubeconfig ya no funcionarán.
Una vez que se inicia una rotación de CA, no se puede pausar ni revertir.
Una rotación de CA puede tardar un tiempo considerable en completarse, según el tamaño del clúster de usuario.
Realiza una rotación de AC
Inicia la rotación:
gkectl update credentials certificate-authorities rotate \ --config USER_CLUSTER_CONFIG \ --kubeconfig ADMIN_CLUSTER_KUBECONFIGReemplaza lo siguiente:
USER_CLUSTER_CONFIG: la ruta del archivo de configuración de tu clúster de usuario
ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador
El comportamiento del comando varía según si el clúster avanzado está habilitado:
No habilitada
Si la actualización avanzada no está habilitada en el clúster, el comando es asíncrono,
inicia la rotación de la AC y, luego, se cierra. No es necesario que mires el
resultado del comando durante toda la rotación de la AC. En su lugar, puedes
verificar el progreso de forma periódica con el comando
gkectl update credentials certificate-authorities status.
Si la rotación de la AC se inicia correctamente, verás un mensaje similar al siguiente:
successfully started the CA rotation with CAVersion 2, use gkectl update credentials certificate-authorities status command to view the current state of CA rotation
Si ya hay una rotación de AC en curso, verás un mensaje de error similar al siguiente:
Exit with error: admission webhook "vonpremusercluster.onprem.cluster.gke.io" denied the request: requests must not modify CAVersion when cluster is not ready: ready condition is not true: ClusterCreateOrUpdate: Creating or updating user cluster control plane workloads
Para ver el estado de la rotación, haz lo siguiente:
gkectl update credentials certificate-authorities status \
--config USER_CLUSTER_CONFIG \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG
El comando anterior informa el CAVersion, que es un número entero que el sistema incrementa automáticamente para diferenciar las AC usadas antes y después de una rotación. El comando también informa un estado (True o False)
que indica si se completó la rotación de la AC y un mensaje que describe
qué CAVersion está usando cada componente del sistema en ese momento.
Si la rotación de la AC ya se completó, verás un mensaje similar al siguiente:
State of CARotation with CAVersion 2 is - status: True, reason: CARotationCompleted, message: Control plane has CA bundle [2], certs from CA 2, CA 2 is CSR signer. Data plane has CA bundle [2], CA 2 was CSR signer at last restart.
Si la rotación de la CA aún está en curso, verás un mensaje similar al siguiente:
State of CARotation with CAVersion 2 is - status: False, reason: CARotationProgressed, message: Control plane has CA bundle [1 2], certs from CA 2, CA 1 is CSR signer. Data plane has CA bundle [1 2], CA 1 was CSR signer at last restart.
Actualiza las credenciales del clúster de usuario
En los clústeres que no tienen habilitado el clúster avanzado, debes obtener un archivo kubeconfig del clúster de usuario nuevo del clúster de administrador. Esto se debe a que la rotación de la AC revoca la AC en la que se basaba el archivo kubeconfig anterior.
Obtén un archivo kubeconfig nuevo:
kubectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG get secret admin \
-n USER_CLUSTER_NAME -o jsonpath='{.data.admin\.conf}' \
| base64 --decode > USER_CLUSTER_NAME-kubeconfig
Habilitado
Si el clúster avanzado está habilitado, el comando gkectl update credentials
certificate-authorities rotate es síncrono. El comando muestra
mensajes de estado en la estación de trabajo de administrador a medida que avanza la rotación de la AC.
Después de que la CA se rota correctamente, el comando se cierra y se genera un archivo kubeconfig nuevo de forma automática. El resultado del comando proporciona el nombre del archivo kubeconfig nuevo y es similar al siguiente:
Beginning CA rotation with generated CA ... Successfully rotated CA for user cluster "USER_CLUSTER_NAME". The kubeconfig file "/home/ubuntu"/USER_CLUSTER_NAME-kubeconfig" has been updated.
El kubeconfig nuevo se encuentra en el mismo directorio que el kubeconfig del clúster de administrador
que especificaste en el comando. El nombre del nuevo kubeconfig
es USER_CLUSTER_NAME-kubeconfig.
Distribuye el archivo kubeconfig nuevo
Distribuye el archivo kubeconfig nuevo a todos los que usen un archivo kubeconfig para interactuar con el clúster.
Actualiza los archivos de configuración de autenticación
Después de que se complete la rotación de la AC, se deben actualizar y redistribuir los archivos de configuración de autenticación. Para obtener más información, consulta Administra la identidad del usuario.
Rotación de certificados del plano de control
Sin rotación, las AC del clúster de usuario y los certificados del plano de control vencen diez años después de la fecha de creación del clúster (para las versiones anteriores a la 1.36.100, estos certificados vencen después de cinco años). Los certificados del plano de control del clúster de usuario se rotan automáticamente en un plazo de diez horas después de cada actualización del clúster de usuario, pero las AC no se rotan automáticamente. Esto significa que se debe realizar una rotación de la AC al menos una vez cada diez años (cinco años para las versiones anteriores a la 1.36.100), además de las actualizaciones de versión habituales.
Para evitar que un clúster de usuario deje de estar disponible, los certificados del plano de control se rotan en un plazo de diez horas después de la actualización del clúster de usuario. Cuando esto sucede, aparece un mensaje en el estado de rotación de la AC del clúster de usuario.
Para ver la última versión a la que se actualizó un clúster de usuario cuando se rotaron los certificados del plano de control, haz lo siguiente:
gkectl update credentials certificate-authorities status \ --config USER_CLUSTER_CONFIG \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG
La información aparece al final del campo message en un plazo de diez horas después de una
actualización. Por ejemplo:
Last Leaf Certificates Rotation Version: 1.16.0-gke.0.
Soluciona problemas de rotación de CA
El comando gkectl diagnose admite la verificación del estado esperado de una rotación de CA completa en un clúster de usuario. Para obtener instrucciones sobre cómo ejecutar
gkectl diagnose en un clúster de usuario, consulta
Diagnostica problemas de clústeres.
Si tienes problemas con una rotación de CA, comunícate con el equipo de Atención al cliente de Google y
proporciona el resultado de gkectl diagnose.