Crear clústeres de usuario

Esta página está destinada a los administradores de la plataforma.

Puedes crear clústeres de usuarios con la consola del centro de administración de Anthos o con kubectl.

Antes de comenzar

Asegúrate de que la máquina requerida y los recursos VIP estén registrados por el operador de la infraestructura antes de crear un clúster.

Centro de administración

  1. En la consola del centro de administración, abre el menú Clústeres.

  2. En la página Clústeres, haz clic en Crear clúster para crear un clúster de usuario de Anthos nuevo.

  3. Configura el clúster de usuario nuevo mediante la página Configuración del clúster:

    Agrega un clúster

  4. Usa el botón Agregar grupo de nodos para agregar grupos de nodos al clúster. Usa el formulario del grupo de nodos para nombrar los grupos de nodos y asignar los nodos trabajadores a los grupos de nodos.

Una vez que se crea el clúster, se registra de forma automática en el centro de administración y aparece en el panel del clúster de inmediato.

kubectl

Crea los recursos del clúster y del grupo de nodos para que se registren en el clúster de administrador mediante el siguiente comando:

kubectl apply -f USER_CLUSTER_YAML --kubeconfig=ADMIN_KUBECONFIG

Reemplaza lo siguiente:

  • USER_CLUSTER_YAML: El manifiesto YAML para el clúster de usuario y los grupos de nodos. Consulta los archivos de configuración de muestra de clúster de usuario y grupo de nodos.
  • ADMIN_KUBECONFIG: El archivo kubeconfig del clúster de administrador.

Si usas los archivos de configuración del clúster de administrador como base para la configuración de tu clúster de usuario, modifica los siguientes campos en la sección de configuración del clúster de usuario:

  • Quita los campos sshPrivateKeyPath, privateRegistry, privateRegistryConfigPath y privateRegistryTLSCertPath de la parte superior.
  • Asegúrate de que las <cluster-name> sean coherentes en todas las opciones de configuración.
  • Cluster.spec.type debe ser de usuario, diferente del tipo de clúster para un clúster de administrador.
  • Cluster.metadata.namespace debería ser cluster-<cluster-name>, en el que <cluster-name> es el nombre del clúster de usuario que se crea.
  • Asegúrate de que Cluster.spec.loadBalancer.vips.controlPlaneVIP y Cluster.spec.loadBalancer.addressPools no se superpongan con la configuración de otros clústeres.
  • Cluster.spec.loadBalancer.addressPools contiene el rango de direcciones IP que se asignan a los servicios de tipo LoadBalancer. Puede aceptar más de un grupo de direcciones. Si creas varios grupos de direcciones con nombres diferentes, más adelante puedes crear servicios y asignar grupos de direcciones específicos a cada uno. Debes agregar metallb.universe.tf/address-pool: <address-pool-name> a la anotación del servicio cuando lo creas. Si en una etapa posterior necesitas extender el rango que usan los servicios, puedes agregar grupos de direcciones adicionales mediante la edición del clúster de usuario: kubectl edit cluster user-cluster-name --kubeconfig admin_kubeconfig -n user-cluster-name. No puedes cambiar los poolPools existentes. A continuación, se muestra un ejemplo.
  • Nodepool.metadata.name debe tener el formato: <cluster-name>-worker-node-pool.
  • Nodepool.metadata.namespace debería ser cluster-<cluster-name> y metadata.name coincide con el nombre del clúster en el clúster.
  loadBalancer:
    addressPools:
    - addresses:
      - 10.200.0.112-10.200.0.119
      name: pool1
    - addresses:
      - 10.200.0.120-10.200.0.121
      name: pool2

Verifica el estado del clúster

El clúster puede tardar hasta 15 minutos en iniciarse y estar listo. Mientras esperas, puedes verificar el estado del clúster de usuario con el siguiente comando:

kubectl get Cluster -n cluster-USER_CLUSTER_NAME --kubeconfig=ADMIN_KUBECONFIG

Reemplaza USER_CLUSTER_NAME por el nombre del clúster que creaste.

Cuando el estado del clúster es ready, el clúster de usuario se crea y registra de forma correcta en el de administrador.

Descarga el archivo kubeconfig

Después de crear el clúster de usuario, puedes descargar el archivo kubeconfig desde el centro de administración.

  1. En la consola del centro de administración, abre el menú Clústeres.
  2. En la página Clústeres, haz clic en el nombre del clúster.
  3. En la página Cluster configuration, descarga el archivo kubeconfig:
    • Los operadores de infraestructura y administradores de plataformas pueden hacer clic en Descargar kubeconfig raíz.
    • Los usuarios con acceso de lectura pueden hacer clic en Download read-only kubeconfig.

El archivo kubeconfig se descarga en el sistema.