Administre los grupos de nodos

Cuando creas un clúster de Kubernetes aislado de Google Distributed Cloud (GDC), la cantidad y el tipo de nodos que especificas crean el primer grupo de nodos del clúster. Puedes realizar las siguientes tareas del grupo de nodos para un clúster existente a medida que cambian sus requisitos de procesamiento:

  • Agrega un grupo de nodos nuevo: Agrega grupos de nodos nuevos a medida que aumenta la demanda de las cargas de trabajo del clúster.

  • Visualiza un grupo de nodos: Visualiza las características y el estado de tus grupos de nodos existentes.

  • Cambia el tamaño de un grupo de nodos: Aumenta o disminuye de forma manual los grupos de nodos para adaptarlos a las fluctuaciones del tráfico de la carga de trabajo.

  • Borra un grupo de nodos: Quita los grupos de nodos si disminuye la demanda de las cargas de trabajo del clúster o si deseas borrar los tipos de máquinas que ya no son prudentes para tus operaciones de contenedores.

Para obtener más información sobre los grupos de nodos en un clúster, consulta Acerca de los nodos.

Este documento está dirigido a desarrolladores de aplicaciones dentro del grupo de operadores de aplicaciones y administradores de TI dentro del grupo de administradores de la plataforma que son responsables de administrar clústeres de Kubernetes dentro de su organización. Para obtener más información, consulta Públicos de la documentación de GDC aislado.

Antes de comenzar

Para completar las tareas de este documento, debes solicitar los permisos necesarios y preparar tu entorno.

Solicita roles de IAM

Debes tener roles específicos para obtener los permisos que necesitas para administrar grupos de nodos en un clúster de Kubernetes. Los roles que necesitas dependen de si trabajas en un clúster compartido con alcance de la organización o en un clúster estándar con alcance del proyecto. Para obtener más información, consulta Configuraciones del clúster de Kubernetes.

Roles de clúster compartido

Para crear, borrar, editar o visualizar los grupos de nodos de un clúster compartido, comunícate con tu administrador de IAM de la organización para solicitar el rol de Administrador del clúster de usuario (user-cluster-admin). Este rol no está vinculado a un espacio de nombres.

Roles de clúster estándar

Comunícate con tu administrador de IAM del proyecto para solicitar los siguientes roles:

  • Administrador del clúster estándar (standard-cluster-admin): Crea, borra, edita o visualiza los grupos de nodos de un clúster estándar.

  • Desarrollador de clústeres (cluster-developer): Crea, borra, edita o visualiza un clúster estándar. Este rol es obligatorio para ver los detalles del grupo de nodos del clúster desde la consola de GDC.

Estos roles están vinculados al espacio de nombres de tu proyecto.

Prepara el entorno

Para ejecutar comandos en un clúster de Kubernetes con la API, asegúrate de tener los siguientes recursos:

  • Ubica el nombre del clúster de Kubernetes o pregúntale a un miembro del grupo de administradores de la plataforma cuál es el nombre del clúster.

  • Usa el nombre del clúster de Kubernetes para reemplazar KUBERNETES_CLUSTER_NAME en estas instrucciones.

  • Accede y genera el archivo kubeconfig del servidor de la API de administración para el clúster de Kubernetes.

  • Usa la ruta de acceso kubeconfig del servidor de la API de administración para reemplazar MANAGEMENT_API_SERVER en estas instrucciones.

Agrega un grupo de nodos

Para agregar un grupo de nodos a un clúster de Kubernetes existente, completa los siguientes pasos:

Console

  1. En el selector de proyectos, selecciona tu proyecto o tu organización.

    Los clústeres estándar tienen alcance del proyecto y los clústeres compartidos tienen alcance de la organización. Selecciona el alcance correcto para ver el tipo de clúster de Kubernetes adecuado.

  2. En el menú de navegación, selecciona Kubernetes Engine > Clústeres.

  3. Haz clic en el clúster de la lista de clústeres. Se mostrará la página Detalles del clúster.

  4. Selecciona Grupos de nodos > Agregar grupo de nodos.

  5. Asigna un nombre al grupo de nodos. No puedes modificar el nombre después de crear el grupo de nodos.

  6. Especifica la cantidad de nodos trabajadores que se crearán en el grupo de nodos.

  7. Selecciona la clase de máquina que mejor se adapte a los requisitos de tu carga de trabajo. Las clases de máquinas se muestran en la siguiente configuración:

    • Tipo de máquina
    • vCPU
    • Memoria

  8. Haz clic en Guardar.

API

  1. Abre la especificación del recurso personalizado Cluster con la CLI de kubectl mediante el editor interactivo:

    kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER

    Reemplaza lo siguiente:

    • KUBERNETES_CLUSTER_NAME: el nombre del clúster
    • KUBERNETES_CLUSTER_NAMESPACE: el espacio de nombres del clúster Para los clústeres compartidos, usa el espacio de nombres platform. Para los clústeres estándar, usa el espacio de nombres del proyecto del clúster.
    • MANAGEMENT_API_SERVER: la ruta de acceso kubeconfig del servidor de la API zonal en el que se aloja el clúster de Kubernetes

  2. Agrega una entrada nueva en la sección nodePools:

    nodePools:
# Several lines of code are omitted here.
- machineTypeName: MACHINE_TYPE
  name: NODE_POOL_NAME
  nodeCount: NUMBER_OF_WORKER_NODES
  taints: TAINTS
  labels: LABELS
  acceleratorOptions:
    gpuPartitionScheme: GPU_PARTITION_SCHEME

    Reemplaza lo siguiente:

    • MACHINE_TYPE: el tipo de máquina para los nodos trabajadores del grupo de nodos Consulta los tipos de máquinas disponibles para ver lo que se puede configurar.
    • NODE_POOL_NAME: el nombre del grupo de nodos
    • NUMBER_OF_WORKER_NODES: la cantidad de nodos trabajadores que se aprovisionarán en el grupo de nodos
    • TAINTS: los taints que se aplicarán a los nodos de este grupo de nodos Este paso es opcional,
    • LABELS: las etiquetas que se aplicarán a los nodos de este grupo de nodos Contiene una lista de pares clave-valor. Este paso es opcional,
    • GPU_PARTITION_SCHEME: el esquema de partición de GPU, si ejecutas cargas de trabajo de GPU Por ejemplo, mixed-2. La GPU no se particiona si no se configura este campo. Para obtener perfiles de GPU de instancias múltiples (MIG) disponibles, consulta Perfiles de MIG compatibles.

  3. Guarda el archivo y sal del editor.

Visualiza grupos de nodos

Para ver los grupos de nodos existentes en un clúster de Kubernetes, completa los siguientes pasos:

Console

  1. En el selector de proyectos, selecciona tu proyecto o tu organización.

    Los clústeres estándar tienen alcance del proyecto y los clústeres compartidos tienen alcance de la organización. Selecciona el alcance correcto para ver el tipo de clúster de Kubernetes adecuado.

  2. En el menú de navegación, selecciona Kubernetes Engine > Clústeres.

  3. Haz clic en el clúster de la lista de clústeres. Se mostrará la página Detalles del clúster.

  4. Selecciona Grupos de nodos.

Se mostrará la lista de grupos de nodos que se ejecutan en el clúster. Puedes administrar los grupos de nodos del clúster desde esta página.

API

  • Visualiza los grupos de nodos de un clúster de Kubernetes específico:

    kubectl get clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    -o json --kubeconfig MANAGEMENT_API_SERVER | \
    jq .status.workerNodePoolStatuses

    Reemplaza lo siguiente:

    • KUBERNETES_CLUSTER_NAME: el nombre del clúster
    • KUBERNETES_CLUSTER_NAMESPACE: el espacio de nombres del clúster Para los clústeres compartidos, usa el espacio de nombres platform. Para los clústeres estándar, usa el espacio de nombres del proyecto del clúster.

    El resultado es similar a este:

    [
  {
    "conditions": [
      {
        "lastTransitionTime": "2023-08-31T22:16:17Z",
        "message": "",
        "observedGeneration": 2,
        "reason": "NodepoolReady",
        "status": "True",
        "type": "Ready"
      },
      {
        "lastTransitionTime": "2023-08-31T22:16:17Z",
        "message": "",
        "observedGeneration": 2,
        "reason": "ReconciliationCompleted",
        "status": "False",
        "type": "Reconciling"
      }
    ],
    "name": "worker-node-pool",
    "readyNodes": 3,
    "readyTimestamp": "2023-08-31T18:59:46Z",
    "reconcilingNodes": 0,
    "stalledNodes": 0,
    "unknownNodes": 0
  }
]

Cambia el tamaño de los grupos de nodos

Puedes cambiar el tamaño de los grupos de nodos de forma manual en un clúster de Kubernetes si aumentas o disminuyes el grupo. No puedes seleccionar un nodo específico para quitarlo cuando disminuyes un grupo de nodos.

Para ajustar la escala de un grupo de nodos en un clúster existente, completa los siguientes pasos:

Console

  1. En el selector de proyectos, selecciona tu proyecto o tu organización.

    Los clústeres estándar tienen alcance del proyecto y los clústeres compartidos tienen alcance de la organización. Selecciona el alcance correcto para ver el tipo de clúster de Kubernetes adecuado.

  2. En el panel, selecciona el proyecto en el que existe el clúster que deseas editar.

  3. En el menú de navegación, selecciona Kubernetes Engine > Clústeres.

  4. Selecciona el nombre del clúster con el que está asociado el grupo de nodos. Se mostrará la página Detalles del clúster.

  5. Haz clic en la pestaña Grupos de nodos.

  6. Selecciona el ícono Editar para el grupo de nodos cuyo tamaño deseas cambiar. Se mostrará el mensaje Editar grupo de nodos.

  7. Actualiza el campo Cantidad de nodos para reflejar la nueva cantidad de nodos necesarios en el grupo de nodos. Puedes aumentar o disminuir la cantidad de nodos para que se adapte a los requisitos de tu carga de trabajo.

  8. Haz clic en Guardar.

  9. Vuelve a la pestaña Grupos de nodos de tu clúster y confirma que el grupo de nodos cuyo tamaño se cambió tiene el estado Ready y la cantidad correcta de nodos. El grupo de nodos puede tardar unos minutos en ajustarse a tu especificación.

    Confirma que tu grupo de nodos esté listo con la consola.

API

  1. Abre la especificación del recurso personalizado Cluster con la CLI de kubectl mediante el editor interactivo:

    kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER

    Reemplaza lo siguiente:

    • KUBERNETES_CLUSTER_NAME: el nombre del clúster que aloja el grupo de nodos
    • KUBERNETES_CLUSTER_NAMESPACE: el espacio de nombres del clúster Para los clústeres compartidos, usa el espacio de nombres platform. Para los clústeres estándar, usa el espacio de nombres del proyecto del clúster.
    • MANAGEMENT_API_SERVER: la ruta de acceso kubeconfig del servidor de la API zonal en el que se aloja el clúster de Kubernetes

  2. Actualiza el campo nodeCount para el grupo de nodos cuyo tamaño deseas cambiar:

    nodePools:
# Several lines of code are omitted here.
- machineTypeName: n2-standard-2-gdc
  name: nodepool-1
  nodeCount: NUMBER_OF_WORKER_NODES

    Reemplaza NUMBER_OF_WORKER_NODES por la cantidad actualizada de nodos trabajadores que se aprovisionarán en el grupo de nodos.

  3. Guarda el archivo y sal del editor.

  4. Para verificar que se completó el ajuste de escala de nodos, revisa la configuración del grupo de nodos:

    kubectl get clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE -o json \
    --kubeconfig MANAGEMENT_API_SERVER | jq .status.workerNodePoolStatuses

    Confirma que el número readyNodes refleje la cantidad de nodos que estableciste para el grupo de nodos. El grupo de nodos puede tardar unos minutos en ajustarse a tu especificación.

Borra un grupo de nodos

Cuando se borra un grupo de nodos, se borran los nodos y las rutas a ellos. Estos nodos expulsan y reprograman cualquier pod que se ejecute en ellos. Si los pods tienen selectores de nodos específicos, pueden permanecer en una condición no programable si ningún otro nodo del clúster cumple con los criterios.

Asegúrate de tener al menos tres nodos trabajadores antes de borrar un grupo de nodos para garantizar que tu clúster tenga suficiente espacio de procesamiento para ejecutarse de manera eficaz.

Para borrar un grupo de nodos, completa los siguientes pasos:

Console

  1. En el selector de proyectos, selecciona tu proyecto o tu organización.

    Los clústeres estándar tienen alcance del proyecto y los clústeres compartidos tienen alcance de la organización. Selecciona el alcance correcto para ver el tipo de clúster de Kubernetes adecuado.

  2. En el menú de navegación, selecciona Kubernetes Engine > Clústeres.

  3. Haz clic en el clúster que aloja el grupo de nodos que deseas borrar.

  4. Selecciona Grupos de nodos.

  5. Haz clic en Borrar junto al grupo de nodos que deseas borrar.

API

  1. Abre la especificación del recurso personalizado Cluster con la CLI de kubectl mediante el editor interactivo:

    kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER

    Reemplaza lo siguiente:

    • KUBERNETES_CLUSTER_NAME: el nombre del clúster
    • KUBERNETES_CLUSTER_NAMESPACE: el espacio de nombres del clúster Para los clústeres compartidos, usa el espacio de nombres platform. Para los clústeres estándar, usa el espacio de nombres del proyecto del clúster.
    • MANAGEMENT_API_SERVER: la ruta de acceso kubeconfig del servidor de la API zonal en el que se aloja el clúster de Kubernetes

  2. Quita la entrada del grupo de nodos de la sección nodePools. Por ejemplo, en el siguiente fragmento, debes quitar los campos machineTypeName, name y nodeCount:

    nodePools:
# Several lines of code are omitted here.
- machineTypeName: n2-standard-2-gdc
  name: nodepool-1
  nodeCount: 3

    Asegúrate de quitar todos los campos del grupo de nodos que borras.

  3. Guarda el archivo y sal del editor.

¿Qué sigue?