Versión 1.2. Esta versión ya no es compatible como se describe en la política de compatibilidad de versiones de Anthos. Para obtener los últimos parches y actualizaciones de vulnerabilidades de seguridad, exposiciones y problemas que afectan a clústeres de Anthos alojados en VMware (GKE On-Prem), actualiza a una versión compatible. Puedes encontrar la versión más reciente aquí.

Versiones disponibles

Crea clústeres de usuario adicionales

En esta página, se explica cómo crear clústeres de usuario adicionales. Para crear clústeres de usuarios adicionales, haz una copia del archivo de configuración de GKE On-Prem que se usa para implementar tus clústeres. Modifica el archivo copiado para cumplir con las expectativas de los clústeres de usuarios nuevos y, luego, usa el archivo a fin de crear el clúster.

Debes copiar y modificar un archivo de configuración de GKE On-Prem para cada clúster de usuario adicional que desees crear.

Antes de comenzar

Asegúrate de que un clúster de administrador esté en ejecución. Creaste un clúster de administrador cuando instalaste GKE On-Prem.
Ubica el archivo config.yaml que generó gkectl durante la instalación. En este archivo, se definen las especificaciones para el clúster de administrador y los clústeres de usuario. Copia y modifica este archivo para crear clústeres de usuario adicionales.
Ubica el archivo kubeconfig del clúster de administrador. Haz referencia a este archivo cuando copies y modifiques config.yaml.

Limitaciones

Limitación	Descripción
Límites máximos y mínimos de los clústeres y los nodos	Consulta Cuotas y límites. El rendimiento del entorno puede afectar estos límites.
Nombres únicos de clúster de usuario	Todos los clústeres de usuario registrados en el mismo proyecto de Google Cloud deben tener nombres únicos.
No se pueden implementar los mismos clústeres en más de un centro de datos de vCenter o vSphere	Por el momento, solo puedes implementar un clúster de administrador y un conjunto de clústeres de usuario asociados en un solo centro de datos de vCenter o vSphere. No puedes implementar los mismos clústeres de administrador y de usuario en más de un centro de datos de vCenter o vSphere.
No se puede cambiar la configuración de un clúster de forma declarativa después de su creación	Si bien puedes crear clústeres adicionales y cambiar el tamaño de los clústeres existentes, no puedes cambiar un clúster existente mediante su archivo de configuración.

Verifica que haya suficientes direcciones IP disponibles

Asegúrate de tener suficientes direcciones IP asignadas para el clúster de usuario nuevo. Verificar que tienes suficientes direcciones IP depende de si usas un servidor DHCP o direcciones IP estáticas.

DHCP

Verifica que el servidor DHCP en la red en la que se creará el clúster tenga suficientes direcciones IP. Debe haber más direcciones IP que nodos en ejecución en el clúster de usuario.

IP estáticas

Verifica que hayas asignado suficientes direcciones IP en tu balanceador de cargas y asegúrate de especificarlas durante la creación del clúster.

Copia el archivo de configuración

Copia el archivo de configuración de GKE On-Prem que generaste mediante gkectl create-config y modificaste a fin de que sea adecuado para tu entorno. Cambia el nombre de la copia para usar otro nombre de archivo:

cp [CONFIG_FILE] [NEW_USER_CLUSTER_CONFIG]

En el ejemplo anterior, [NEW_USER_CLUSTER_CONFIG] es el nombre que eliges para la copia del archivo de configuración. Para los fines de estas instrucciones, llamaremos a este archivo create-user-cluster.yaml.

En create-user-cluster.yaml, debes cambiar los siguientes campos:

admincluster, la especificación del clúster de administrador. Quita por completo la especificación admincluster del archivo.
usercluster, la especificación de un clúster de usuario.

En las siguientes secciones, debes modificar los campos admincluster y usercluster de create-user-cluster.yaml y, luego, usar el archivo para crear clústeres de usuario adicionales.

Borra la especificación `admincluster`

Si deseas crear clústeres de usuario adicionales desde el clúster de administrador existente, debes borrar toda la especificación admincluster.

Para hacerlo, solo borra la especificación y todos sus subcampos.

Asegúrate de no borrar la especificación usercluster ni ninguno de los subcampos.

Modifica la especificación `usercluster`

Realiza los cambios en los campos usercluster como se describe en las siguientes secciones.

Cambia el nombre del clúster de usuario

Cambia el nombre del clúster de usuario del campo usercluster.clustername. Los clústeres de usuario nuevos deben tener nombres diferentes a los clústeres de usuario existentes.

Reserva direcciones IP para los nodos del clúster de usuario

Si usas DHCP, asegúrate de tener suficientes IP para que se creen los nodos.

Para una IP estática, debes modificar el archivo proporcionado por usercluster.ipblockfilepath que contiene las direcciones IP predefinidas del clúster de usuario o proporcionar un archivo YAML de IP estática diferente con las IP que desees.

Reserva direcciones IP para el balanceador de cargas

Si usas el balanceador de cargas de BIG-IP de F5, asegúrate de reservar dos direcciones IP para el plano de control y la entrada del balanceador de cargas del clúster de usuario. Los campos correspondientes son usercluster.vips.controlplanevip y usercluster.vips.ingressvip.

Cambia los requisitos de la máquina (opcional)

Si necesitas que el plano de control o los nodos trabajadores de este clúster de usuario usen una cantidad diferente de CPU o memoria, o si necesitas que el clúster ejecute más o menos nodos, establece valores para los siguientes campos:

`usercluster.masternode`

usercluster.masternode.cpus: Cantidad de núcleos de CPU que se usarán
usercluster.masternode.memorymb: Cantidad de MB de memoria que se usarán
usercluster.masternode.replicas: Cantidad de nodos de este tipo que se ejecutarán. El valor debe ser 1 o 3

`usercluster.workernode`

usercluster.workernode.cpus: Cantidad de núcleos de CPU que se usarán
usercluster.workernode.memorymd: Cantidad de MB de memoria que se usarán
usercluster.workernode.replicas: Cantidad de nodos de este tipo que se ejecutarán.

Crea el clúster de usuario

Ahora que propagaste un archivo create-user-cluster.yaml, podrás usarlo para crear un clúster de usuario adicional.

Ejecuta el siguiente comando:

gkectl create cluster --config create-user-cluster.yaml --kubeconfig [ADMIN_CLUSTER_KUBECONFIG]

Donde:

create-user-cluster.yaml es el archivo de configuración que acabas de crear. Es posible que hayas elegido un nombre diferente para este archivo.
[ADMIN_CLUSTER_KUBECONFIG] apunta al kubeconfig del clúster de administrador existente.

Problemas conocidos

Versión 1.1: la creación de un segundo clúster de usuario falla cuando se usa un almacén de datos de vSAN

Consulta las notas de la versión de GKE On-Prem.

Soluciona problemas

Para obtener más información, consulta Soluciona problemas.

Diagnostica problemas de clústeres mediante `gkectl`

Usa los comandos gkectl diagnose para identificar los problemas de clústeres y compartir la información de un clúster con Google. Consulta Diagnostica problemas de clústeres.

Comportamiento de registro predeterminado

Para gkectl y gkeadm, basta con usar la configuración de registro predeterminada:

De forma predeterminada, las entradas de registro se guardan de la siguiente manera:
- Para gkectl, el archivo de registro predeterminado es /home/ubuntu/.config/gke-on-prem/logs/gkectl-$(date).log y el archivo está vinculado con un symlink con el archivo logs/gkectl-$(date).log en el directorio local en el que ejecutas gkectl.
- Para gkeadm, el archivo de registro predeterminado es logs/gkeadm-$(date).log en el directorio local en el que ejecutas gkeadm.
Todas las entradas de registro se guardan en el archivo de registro, incluso si no se imprimen en la terminal (cuando --alsologtostderr es false).
El nivel de verbosidad -v5 (predeterminado) cubre todas las entradas de registro que necesita el equipo de asistencia al cliente.
El archivo de registro también contiene el comando ejecutado y el mensaje de error.

Recomendamos que envíes el archivo de registro al equipo de asistencia al cliente cuando necesites ayuda.

Especifica una ubicación no predeterminada para el archivo de registro

A fin de especificar una ubicación no predeterminada para el archivo de registro gkectl, usa la marca --log_file. El archivo de registro que especifiques no se vinculará con un symlink con el directorio local.

A fin de especificar una ubicación no predeterminada para el archivo de registro gkeadm, usa la marca --log_file.

Ubica los registros de la API de clúster en el clúster de administrador

Si una VM no se inicia después de que se inicia el plano de control de administrador, puedes intentar depurarla mediante la inspección de los registros de los controladores de la API de clúster en el clúster de administrador:

Encuentra el nombre del Pod de controladores de la API de clúster en el espacio de nombres kube-system, en el que [ADMIN_CLUSTER_KUBECONFIG] es la ruta de acceso al archivo kubeconfig del clúster de administrador:
```
kubectl --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] -n kube-system get pods | grep clusterapi-controllers
```
Abre los registros del Pod, en los que [POD_NAME] es el nombre del Pod. De manera opcional, usa grep o una herramienta similar para buscar errores:
```
kubectl --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] -n kube-system logs [POD_NAME] vsphere-controller-manager
```