Elige una herramienta para administrar el ciclo de vida del clúster

Google Distributed Cloud te ofrece una variedad de herramientas para crear clústeres y administrar las operaciones del ciclo de vida del clúster (actualización, actualización y eliminación):

• La herramienta de línea de comandos gkectl, que ejecutas en tu estación de trabajo de administrador en tu centro de datos local. Creas un archivo de configuración que describe la red del clúster, el balanceo de cargas y otras funciones del clúster. Especificas este archivo en la línea de comandos para gkectl.
• La Google Cloud consola, Google Cloud CLI o Terraform que puedes ejecutar desde cualquier computadora que tenga conectividad de red a la API de GKE On-Prem. Estas herramientas estándar usan la API de GKE On-Prem, que se ejecuta en la infraestructura de Google Cloud . En conjunto, las herramientas estándar se denominan clientes de la API de GKE On-Prem. Para administrar el ciclo de vida de tus clústeres, la API de GKE On-Prem debe almacenar los metadatos sobre el estado de tu clúster en Google Cloud, en la región de Google Cloud que especificas cuando creas el clúster. Estos metadatos permiten que la API administre el ciclo de vida del clúster y no incluya datos específicos de la carga de trabajo.

Independientemente de la herramienta que uses para crear clústeres, la información que recopiles y proporciones a la herramienta, como las direcciones IP de las máquinas de nodos del clúster y las VIP del balanceador de cargas, es la misma.

Esta selección te permite elegir la mejor herramienta para tu caso de uso y tu entorno. Por ejemplo:

• Para tus primeras instalaciones en un entorno de desarrollo, es posible que desees usar la consola de Google Cloud , ya que la interfaz de usuario proporciona orientación y ayuda adicionales.
• Si tu organización ya usa gcloud CLI o Terraform para administrar otros recursos de Google Cloud , es probable que también quieras usar estas herramientas para Google Distributed Cloud.
• Si tu organización tiene requisitos o restricciones reglamentarias, es posible que debas limitar tu dependencia de Google Cloud y usar gkectl en tu estación de trabajo de administrador para crear clústeres y administrar el ciclo de vida de los clústeres.

Si creas un clúster con gkectl, se inscribirá con la API de GKE On-Prem de forma predeterminada. También puedes inscribir el clúster después de crearlo, lo que te permite usar los clientes de la API de GKE On-Prem.

Limitaciones con los clientes de la API de GKE On-Prem

La herramienta gkectl es la más desarrollada en cuanto a las funciones que admite. Te recomendamos que revises las capacidades de los clientes de la API de GKE On-Prem cuando elijas una opción. Los siguientes clientes de la API de GKE On-Prem no admiten las siguientes funciones:

• Administración y rotación de secretos
• Rotación de certificados
• Autenticación
• Medición de uso
• Registro y supervisión a nivel de la aplicación
• Herramientas de redes avanzadas
• Grupos de nodos de Windows

En la siguiente lista, se describen limitaciones adicionales con los clientes de la API de GKE On-Prem:

• Gcloud CLI no es compatible con ninguna operación del ciclo de vida del clúster de administrador. Puedes usar gkectl, la consola, gcloud CLI o Terraform para crear clústeres de administrador.

• La herramienta de línea de comandos de gkectl es la única disponible para actualizar, actualizar y borrar clústeres de administrador.

• Solo gkectl y Terraform admiten el uso de un registro privado.

• El tipo de balanceador de cargas para un clúster de administrador y sus clústeres de usuario debe ser el mismo. La única excepción es si el clúster de administrador usa Seesaw, en cuyo caso los clústeres de usuario pueden usar MetalLB. Si quieres que tus clústeres de administrador y de usuario usen diferentes tipos de balanceadores de cargas, debes crear los clústeres con gkectl.

• Cuando creas un clúster de usuario con la consola de Google Cloud , todos los parámetros de configuración devCenter se heredan del clúster de administrador. Si necesitas que un clúster de usuario tenga una configuración de vCenter diferente a la de su clúster de administrador, usa gcloud CLI, Terraform o gkectl para crear el clúster de usuario.

Limitaciones de los clústeres avanzados

Cuando creas un clúster, si Google Distributed Cloud crea un clúster avanzado o no avanzado de forma predeterminada depende de la versión, como se indica a continuación:

• Versión 1.32 o anterior: Se crea un clúster no avanzado de forma predeterminada.
• Versión 1.33 o posterior: Se crea un clúster avanzado de forma predeterminada.

Solo Terraform y la herramienta de línea de comandos de gkectl pueden cambiar el comportamiento predeterminado. Para cambiar el comportamiento predeterminado, haz lo siguiente:

• gkectl: Incluye el campo booleano enableAdvancedCluster en el archivo de configuración del clúster. Por ejemplo, para crear un clúster avanzado con la versión 1.32, especifica enableAdvancedCluster: true en el archivo de configuración del clúster.

• Terraform: Incluye el campo booleano enable_advanced_cluster en tu archivo de configuración (por lo general, llamado main.tf). Por ejemplo, para crear un clúster avanzado con la versión 1.32, agrega enable_advanced_cluster = true a main.tf.

Solo se admite la herramienta de línea de comandos de gkectl en los siguientes casos:

• Cuando se actualiza un clúster no avanzado a un clúster avanzado
• Cuando se actualiza un clúster de la versión 1.32 a la 1.33

Para obtener más información, consulta Actualiza un clúster a un clúster avanzado.

Los clientes de la API de GKE On-Prem tienen limitaciones en las operaciones de creación, actualización, actualización y eliminación, como se muestra en la siguiente tabla. Solo se admite la herramienta de línea de comandos gkectl para todas las operaciones, excepto la eliminación del clúster de administrador. Borrar un clúster de administrador es un caso especial que implica borrar recursos de Google Cloud , recursos de balanceador de cargas, la VM y el disco de datos de vSphere. Para obtener más información, consulta Cómo borrar un clúster de administrador.

Usa los siguientes menús desplegables para filtrar la tabla por cliente y tipo de clúster:

Selecciona un cliente Console CLI de gcloud Terraform Selecciona un tipo de clúster Clúster de usuario no avanzado Clúster de administrador no avanzado Clúster de usuario avanzado Clúster de administrador avanzado

En la siguiente tabla, se muestran las operaciones de clúster admitidas para el cliente seleccionado:

Cliente	Tipo de clúster	Operación	Compatible / Versión
Terraform	Clúster de usuario no avanzado	Crear	1.32 o una versión anterior
Terraform	Clúster de usuario no avanzado	Actualiza y mantente en el nivel básico	1.32 o una versión anterior
Terraform	Clúster de usuario no avanzado	Actualiza a Advanced	No
Terraform	Clúster de usuario no avanzado	Actualizar configuración	Sí
Terraform	Clúster de usuario no avanzado	Borrar	Sí
Terraform	Clúster de usuario avanzado	Crear	1.33.200 o versiones posteriores
Terraform	Clúster de usuario avanzado	Actualizar	1.33.200 o versiones posteriores
Terraform	Clúster de usuario avanzado	Actualizar configuración	Sí
Terraform	Clúster de usuario avanzado	Borrar	Sí
Terraform	Clúster de administrador no avanzado	Crear	1.32 o una versión anterior
Terraform	Clúster de administrador no avanzado	Actualiza y mantente en el nivel básico	No
Terraform	Clúster de administrador no avanzado	Actualiza a Advanced	No
Terraform	Clúster de administrador no avanzado	Actualizar configuración	Sí
Terraform	Clúster de administrador no avanzado	Borrar	No
Terraform	Clúster de administrador avanzado	Crear	1.33.200 o versiones posteriores
Terraform	Clúster de administrador avanzado	Actualizar	No
Terraform	Clúster de administrador avanzado	Actualizar configuración	Sí
Terraform	Clúster de administrador avanzado	Borrar	No
Console	Clúster de usuario no avanzado	Crear	1.32 o una versión anterior
Console	Clúster de usuario no avanzado	Actualiza y mantente en el nivel básico	1.32 o una versión anterior
Console	Clúster de usuario no avanzado	Actualiza a Advanced	No
Console	Clúster de usuario no avanzado	Actualizar configuración	Sí
Console	Clúster de usuario no avanzado	Borrar	Sí
Console	Clúster de usuario avanzado	Crear	1.33.200 o versiones posteriores
Console	Clúster de usuario avanzado	Actualizar	1.33.200 o versiones posteriores
Console	Clúster de usuario avanzado	Actualizar configuración	Sí
Console	Clúster de usuario avanzado	Borrar	Sí
Console	Clúster de administrador no avanzado	Crear	1.32 o una versión anterior
Console	Clúster de administrador no avanzado	Actualiza y mantente en el nivel básico	No
Console	Clúster de administrador no avanzado	Actualiza a Advanced	No
Console	Clúster de administrador no avanzado	Actualizar configuración	No
Console	Clúster de administrador no avanzado	Borrar	No
Console	Clúster de administrador avanzado	Crear	1.33.200 o versiones posteriores
Console	Clúster de administrador avanzado	Actualizar	No
Console	Clúster de administrador avanzado	Actualizar configuración	No
Console	Clúster de administrador avanzado	Borrar	No
gcloud CLI	Clúster de usuario no avanzado	Crear	1.32 o una versión anterior
gcloud CLI	Clúster de usuario no avanzado	Actualiza y mantente en el nivel básico	1.32 o una versión anterior
gcloud CLI	Clúster de usuario no avanzado	Actualiza a Advanced	No
gcloud CLI	Clúster de usuario no avanzado	Actualizar configuración	Sí
gcloud CLI	Clúster de usuario no avanzado	Borrar	Sí
gcloud CLI	Clúster de usuario avanzado	Crear	1.33.200 o versiones posteriores
gcloud CLI	Clúster de usuario avanzado	Actualizar	1.33.200 o versiones posteriores
gcloud CLI	Clúster de usuario avanzado	Actualizar configuración	Sí
gcloud CLI	Clúster de usuario avanzado	Borrar	Sí
gcloud CLI	Clúster de administrador no avanzado	Crear	No
gcloud CLI	Clúster de administrador no avanzado	Actualiza y mantente en el nivel básico	1.32 y versiones anteriores
gcloud CLI	Clúster de administrador no avanzado	Actualiza a Advanced	No
gcloud CLI	Clúster de administrador no avanzado	Actualizar configuración	No
gcloud CLI	Clúster de administrador no avanzado	Borrar	No
gcloud CLI	Clúster de administrador avanzado	Crear	No
gcloud CLI	Clúster de administrador avanzado	Actualizar	1.33.200 y versiones posteriores
gcloud CLI	Clúster de administrador avanzado	Actualizar configuración	No
gcloud CLI	Clúster de administrador avanzado	Borrar	No

Consulta estas limitaciones cada tanto a medida que evolucionan los clientes de la API de GKE On-Prem.