Estás viendo la documentación de una versión anterior de GKE On-Prem. Consulta la documentación más reciente.

Crea clústeres de usuarios 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 a fin de cumplir con las expectativas de los clústeres de usuario nuevos y, luego, usa el archivo para 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 a través de 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.

Cree una partición F5 BIG-IP

Si usas BIG-IP de F5 para el balanceo de cargas, crea una partición para el clúster de usuario nuevo.

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 los 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 13

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.

Configura la partición F5 BIG-IP

Si usas F5 BIG-IP para el balanceo de cargas, antes creaste una partición del clúster de usuarios nuevo. Ahora, configura la partición en el campo usercluster.bigip.partition. Por ejemplo:

usercluster:
...
bigip:
  partition: "my-new-user-f5-partition"
...

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]

En el comando anterior, se ilustra lo siguiente:

  • 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.

Soluciona problemas

Para obtener más información, consulta Solución de 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 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.
  • 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 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 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:

  1. 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
  2. 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