Actualiza un clúster

En esta página, se analiza qué configuración puedes actualizar en los clústeres de administrador y de usuario.

Por lo general, puedes cambiar una sola configuración en un archivo de configuración y, luego, ejecutar el comando gkectl update con los parámetros adecuados. Para actualizar varias opciones, cambia una configuración a la vez y ejecuta el comando varias veces.

El comando gkectl update toma una de las siguientes formas, junto con los parámetros apropiados para la función que deseas actualizar:

Qué se puede actualizar en los clústeres y qué no

Muchas de las funciones del clúster de administrador y de los clústeres de usuarios no se pueden actualizar después de que se crea el clúster.

Para ver qué configuración se puede actualizar en el clúster de administrador, ejecuta lo siguiente:

gkectl update admin --help

Para ver qué configuración se puede actualizar en un clúster de usuario, ejecuta lo siguiente:

gkectl update cluster --help

Actualizaciones del clúster de administrador

Puedes actualizar varias funciones del clúster de administrador.

Actualiza el tipo de imagen de SO para el clúster de administrador

Puedes actualizar el tipo de imagen de SO para el clúster de administrador a fin de usar Ubuntu o COS.

Asigna direcciones IP estáticas adicionales

Si tu configuración usa direcciones IP estáticas, debes verificar cuántas usas y agregar otras si es necesario cuando actualizas una estación de trabajo de administrador o un clúster de administrador.

Habilita o inhabilita el cambio de tamaño de los nodos del plano de control de un clúster de usuario

Puedes habilitar o inhabilitar el cambio de tamaño automático de los nodos del plano de control para el clúster de usuario. Estos nodos están en el clúster de administrador.

Habilita o inhabilita la copia de seguridad del clúster

Para un clúster de administrador, puedes habilitar la copia de seguridad del clúster o inhabilitar la copia de seguridad de clústeres.

Habilita o inhabilita las métricas de recursos de vSphere

Si cambias el valor de stackdriver.disableVsphereResourceMetrics en el archivo de configuración de clústeres del administrador, ejecuta este comando para actualizar la configuración:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Actualiza la referencia del certificado de vCenter para el clúster de administrador

Si cambió tu certificado de vCenter, actualiza la referencia del certificado de vCenter. Debes actualizar el clúster de administrador y todos los clústeres de usuarios.

Habilita el cambio de tamaño automático de los nodos de complementos para el clúster de administrador (vista previa)

Puedes habilitar o inhabilitar el cambio de tamaño automático de los nodos de complementos para el clúster de administrador.

Habilita o inhabilita la reparación automática de nodos para el clúster de administrador (vista previa)

Puedes habilitar o inhabilitar la reparación automática de nodos para el clúster de administrador si cambias la configuración adecuada en el archivo de configuración del clúster de administrador y ejecutas el comando gkectl update admin.

Cómo habilitar o inhabilitar los grupos antiafinidad (vista previa)

Si cambias el valor de antiAffinityGroups.enabled en el archivo de configuración de clústeres de administrador, ejecuta el siguiente comando para actualizar la configuración:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Reemplaza lo siguiente:

  • ADMIN_CLUSTER_KUBECONFIG: es la ruta de acceso de tu archivo kubeconfig. Puedes omitir esta marca si el archivo se encuentra en el directorio actual y tiene el nombre kubeconfig.

  • ADMIN_CLUSTER_CONFIG_FILE: es la ruta de acceso al archivo de configuración del clúster de administrador. Puedes omitir esta marca si el archivo se encuentra en el directorio actual y tiene el nombre admin-cluster.yaml.

Habilita o inhabilita el registro en los Registros de auditoría de Cloud para el clúster de administrador

Para habilitar el registro en Registros de auditoría de Cloud, completa la sección cloudAuditLogging en tu archivo de configuración del clúster de administrador y, luego, actualiza el clúster.

Para inhabilitar el registro en los Registros de auditoría de Cloud, quita la sección cloudAuditLogging del archivo de configuración de tu clúster de administrador y, luego, actualiza el clúster.

Esta sección es obligatoria en el clúster de administrador si deseas administrar el ciclo de vida de los clústeres de usuario en la consola de Google Cloud.

Para actualizar el clúster, haz lo siguiente:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Reemplaza lo siguiente:

  • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador

  • ADMIN_CLUSTER_CONFIG_FILE: es la ruta de acceso al archivo de configuración del clúster de administrador.

Habilita o inhabilita el registro y la supervisión para el clúster de administrador

Para habilitar Cloud Logging y Cloud Monitoring, completa la sección stackdriver del archivo de configuración de tu clúster de administrador y, luego, actualiza el clúster:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Reemplaza lo siguiente:

  • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador

  • ADMIN_CLUSTER_CONFIG_FILE: es la ruta de acceso al archivo de configuración del clúster de administrador.

Para inhabilitar Cloud Logging y Cloud Monitoring, quita la sección stackdriver del archivo de configuración del clúster de administrador y, luego, actualiza el clúster.

La sección stackdriver es obligatoria de forma predeterminada, por lo que para quitarla, debes incluir la marca --skip-validation-stackdriver:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config ADMIN_CLUSTER_CONFIG_FILE
    --skip-validation-stackdriver

La sección stackdriver es obligatoria en el clúster de administrador si deseas administrar el ciclo de vida de los clústeres de usuario en la consola de Google Cloud.

Registra un clúster de administrador

Cuando creas un clúster de administrador, puedes registrarlo si completas la sección gkeConnect en el archivo de configuración del clúster de administrador antes de crearlo. Si no registraste el clúster en el momento de la creación, puedes registrar un clúster posteriormente si editas el archivo de configuración para agregar la sección gkeConnect y, luego, ejecutar el comando gkectl update admin.

Esta sección es obligatoria en el clúster de administrador si deseas administrar el ciclo de vida de los clústeres de usuario en la consola de Google Cloud.

Rota una clave de cuenta de servicio de registro de conexión para el clúster de administrador.

Para rotar una clave de cuenta de servicio de registro de conexión, usa el comando gkectl update credentials como se describe en Rota claves de cuenta de servicio.

Actualizaciones del clúster de usuario

Puedes actualizar los clústeres de usuario si editas la configuración en el archivo de configuración de usuario y ejecutas gkectl update cluster con los parámetros adecuados. Estos son los cambios que puedes realizar en los clústeres de usuario.

Asigna direcciones IP estáticas adicionales

Si tu configuración usa direcciones IP estáticas, debes verificar cuántas usas y agregar otras si es necesario cuando realizas uno de estos cambios:

Actualiza el parámetro nodePool para cambiar el tamaño de un clúster de usuario

Puedes cambiar el tamaño de un clúster de usuario si actualizas el valor replicas en la sección nodePools y, luego, ejecutas el comando gkectl update cluster.

Habilita o inhabilita las métricas de recursos de vSphere

Puedes habilitar o inhabilitar las métricas de recursos de vSphere en el archivo de configuración del clúster de usuario y, luego, ejecutar el comando gkectl update cluster.

Actualiza la referencia del certificado de vCenter para los clústeres de usuario

Si cambió tu certificado de vCenter, actualiza la referencia del certificado de vCenter. Debes actualizar el clúster de administrador y todos los clústeres de usuarios.

Registra un clúster de usuario

Cuando creas un clúster, puedes registrarlo si completas la sección gkeConnect en el archivo de configuración del clúster de usuario antes de crearlo. Si no registraste el clúster en el momento de la creación, puedes registrar un clúster de usuario existente si editas el archivo de configuración para agregar la sección gkeConnect y, luego, ejecutar el comando gkectl update cluster.

Habilita o inhabilita el registro y la supervisión de un clúster de usuario (vista previa)

Para habilitar el registro y la supervisión, completa la sección stackdriver del archivo de configuración de tu clúster de usuario y, luego, actualiza el clúster:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE

Reemplaza lo siguiente:

  • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador

  • USER_CLUSTER_CONFIG_FILE es la ruta de acceso del archivo de configuración del clúster de usuario.

Para inhabilitar el registro y la supervisión, quita la sección stackdriver del archivo de configuración de tu clúster de usuario y, luego, actualiza el clúster.

La sección stackdriver es obligatoria de forma predeterminada, por lo que para quitarla, debes incluir la marca --skip-validation-stackdriver:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config USER_CLUSTER_CONFIG_FILE
    --skip-validation-stackdriver

Habilita o inhabilita la reparación automática de nodos para clústeres de usuarios

Puedes habilitar o inhabilitar la reparación automática de nodos para el usuario si cambias la configuración adecuada en el archivo de configuración del clúster de usuario y ejecutas el comando gkectl update cluster.

Cambia el tamaño de un nodo en un clúster de usuario de forma automática

Para habilitar el cambio de tamaño automático de un nodo en un clúster de usuario, edita el archivo de configuración del clúster de usuario y ejecuta el comando gkectl update.

Habilita o inhabilita el registro de auditoría de Cloud en un clúster de usuario

Puedes habilitar el registro de auditoría de Cloud o inhabilitar el registro de auditoría de Cloud.

Inhabilita el controlador de CSI de vSphere

De forma predeterminada, el controlador de CSI de vSphere está habilitado. Puedes inhabilitar el controlador de CSI de vSphere.

Rota la clave de una cuenta de servicio del registro de conexión para un clúster de usuario.

Para rotar una clave de cuenta de servicio de registro de conexión, usa el comando gkectl update credentials como se describe en Rota claves de cuenta de servicio.

Actualiza la configuración de Windows Server para usar containerd y Windows Dataplane V2

Si tu configuración incluye un grupo de nodos de nodos del SO de Windows Server, ten en cuenta que Docker y Flannel dejarán de estar disponibles en una próxima actualización. Recomendamos que actualices los clústeres de usuario ahora para usar containerd y Windows Dataplane V2 en su lugar.

Para realizar esta actualización, sigue estos pasos:

  1. Configura enableWindowsDataplaneV2 como true en el archivo de configuración del clúster de usuario.

  2. Ejecuta el comando gkectl update cluster.

Actualizar la configuración de MetalLB

Puedes actualizar los grupos de direcciones de MetalLB en el archivo de configuración del clúster de usuario. También puedes habilitar o inhabilitar MetalLB en cualquier grupo de nodos si actualizas el valor enableLoadBalancer en la sección nodePools. Realiza los cambios aplicables en el archivo de configuración y, a continuación, llama a gkectl update cluster:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONIFG --config USER_CLUSTER_CONFIG

Reemplaza lo siguiente:

  • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador

  • USER_CLUSTER_CONFIG_FILE es la ruta de acceso del archivo de configuración del clúster de usuario.