Administre los grupos de nodos

Compartida Estándar

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 de grupos 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: Consulta las características y el estado de tus grupos de nodos existentes.

• Cambia el tamaño de un grupo de nodos: Escala verticalmente o reduce verticalmente de forma manual tus grupos de nodos para adaptarlos a las fluctuaciones del tráfico de las cargas 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 las 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 los desarrolladores de aplicaciones dentro del grupo de operadores de aplicaciones y a los administradores de TI dentro del grupo de administradores de la plataforma, que son responsables de administrar los 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 organización o en un clúster estándar con alcance de proyecto. Para obtener más información, consulta Configuraciones de clústeres de Kubernetes.

Roles de clúster compartidos

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

Roles de clúster estándar

Comunícate con el administrador de proyectos de IAM para solicitar los siguientes roles:

• Administrador de clústeres 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 necesario 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:

• Busca 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 de kubeconfig del servidor de la API de administración para reemplazar MANAGEMENT_API_SERVER en estas instrucciones.

Agregue un grupo de nodos

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

Console

Importante: La consola de GDC admite configuraciones de clústeres estándar en GDC aislado 1.16.2 y versiones posteriores.

1. En el selector de proyectos, elige tu proyecto u organización.

   Los clústeres estándar tienen alcance de proyecto y los clústeres compartidos tienen alcance de organización. Selecciona el permiso 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 muestra la página Detalles del clúster.

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

5. Asigna un nombre para el 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 los siguientes parámetros de configuración:

   • Tipo de máquina
   • CPU virtual
   • Memoria

8. Haz clic en Guardar.

API

1. Abre la especificación del recurso personalizado Cluster con la CLI de kubectl usando 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: Es el nombre del clúster.
   • KUBERNETES_CLUSTER_NAMESPACE: Es 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: Es la ruta de acceso de 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: Es el tipo de máquina para los nodos trabajadores del grupo de nodos. Consulta los tipos de máquinas disponibles para ver qué se puede configurar.
   • NODE_POOL_NAME: el nombre del grupo de nodos
   • NUMBER_OF_WORKER_NODES: Es la cantidad de nodos trabajadores que se aprovisionarán en el grupo de nodos.
   • TAINTS: Son los taints que se aplicarán a los nodos de este grupo de nodos. Este paso es opcional.
   • LABELS: Son las etiquetas que se aplicarán a los nodos de este grupo de nodos. Contiene una lista de pares clave-valor. Este campo es opcional.
   • GPU_PARTITION_SCHEME: Es 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 conocer los perfiles de GPU de instancias múltiples (MIG) disponibles, consulta Perfiles de MIG compatibles.
   Nota: No puedes editar las configuraciones de los nodos, como la partición de GPU, después de crear el grupo de nodos.

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, elige tu proyecto u organización.

   Los clústeres estándar tienen alcance de proyecto y los clústeres compartidos tienen alcance de organización. Selecciona el permiso 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 muestra la página Detalles del clúster.

4. Selecciona Grupos de nodos.

Se muestra 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: Es el nombre del clúster.
  • KUBERNETES_CLUSTER_NAMESPACE: Es 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 lo siguiente:

  [
    {
      "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 aumentando o disminuyendo la escala del grupo. No puedes seleccionar un nodo específico para quitarlo cuando reduces la escala de un grupo de nodos.

Importante: No se admite el ajuste de escala automático de los grupos de nodos del clúster de Kubernetes.

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

Console

1. En el selector de proyectos, elige tu proyecto u organización.

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

2. En el panel, selecciona el proyecto en el que se encuentra 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 muestra la página Detalles del clúster.

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

6. Selecciona el ícono de Editar para el grupo de nodos al que deseas cambiar el tamaño. Aparecerá 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 ajuste a los requisitos de tu carga de trabajo.

   Nota: Reducir la escala verticalmente del grupo de nodos puede causar problemas de recursos si los nodos restantes no tienen suficiente memoria para controlar las cargas de trabajo existentes.

8. Haz clic en Guardar.

9. Vuelve a la pestaña Grupos de nodos del clúster y confirma que el grupo de nodos con el tamaño cambiado tenga el estado Ready y la cantidad correcta de nodos. El grupo de nodos puede tardar unos minutos en escalar según tu especificación.

   

API

1. Abre la especificación del recurso personalizado Cluster con la CLI de kubectl usando 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: Es el nombre del clúster que aloja el grupo de nodos.
   • KUBERNETES_CLUSTER_NAMESPACE: Es 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: Es la ruta de acceso de kubeconfig del servidor de la API zonal en el que se aloja el clúster de Kubernetes.

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

   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 haya completado el escalamiento 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 escalar según tu especificación.

Borrar 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 los Pods que se ejecutan en ellos. Si los Pods tienen selectores de nodo específicos, pueden mantenerse en una condición no programable si ningún otro nodo en el clúster cumple con los requisitos.

Importante: Los grupos de nodos del plano de control y los grupos de nodos del balanceador de cargas son fundamentales para la función de un clúster y, por lo tanto, no se pueden quitar de un clúster. Solo puedes borrar grupos de nodo trabajador trabajadores.

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, elige tu proyecto u organización.

   Los clústeres estándar tienen alcance de proyecto y los clústeres compartidos tienen alcance de organización. Selecciona el permiso 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 quieres borrar.

API

1. Abre la especificación del recurso personalizado Cluster con la CLI de kubectl usando 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: Es el nombre del clúster.
   • KUBERNETES_CLUSTER_NAMESPACE: Es 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: Es la ruta de acceso de 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 estás borrando.

3. Guarda el archivo y sal del editor.

¿Qué sigue?

• Mantén clústeres de Kubernetes
• Cargas de trabajo de contenedores en GDC
• Aísla las cargas de trabajo de los contenedores