Crea grupos de nodos de usuario único

En este documento, se describe cómo crear y borrar grupos de nodos de usuario único. Si aún no creaste una plantilla de nodo de usuario único, debes hacerlo antes de crear un grupo de nodos.

Los grupos de nodos son recursos zonales que heredan propiedades de la plantilla de nodos en la que se basan. Cuando creas un grupo de nodos, debes especificar la configuración, como la cantidad de nodos y los parámetros de mantenimiento.

Crea un grupo de nodo de usuario único

Para crear un grupo de nodos de usuario único, usa uno de los siguientes métodos:

Console

  1. En la consola de Google Cloud , ve a la página Nodos de usuario único.

    Ir a Nodos de usuario único

  2. Haz clic en Crear grupo de nodos para comenzar.

  3. Especifica un Nombre para el grupo de nodos.

  4. Especifica la Región para que el grupo de nodos muestre las plantillas de nodo disponibles en esa región.

  5. Especifica la Zona dentro de la región en la que se creará el grupo de nodos.

  6. Especifica la Plantilla de nodo a partir de la que se creará el grupo de nodos o haz clic en Crear plantilla de nodo a fin de crear una plantilla de nodo de usuario único nueva. La plantilla de nodos seleccionada se aplica al grupo de nodos.

  7. Elige una de las siguientes opciones del modo de ajuste de escala automático para el escalador automático del grupo de nodos:

    • Desactivado: se administra de forma manual el tamaño del grupo de nodos.

    • Activo: permite que los nodos se agreguen o quiten de forma automática del grupo de nodos.

    • Solo escalar horizontalmente: se agregan nodos al grupo de nodos cuando se requiere capacidad adicional.

  8. Especifica un valor en Cantidad de nodos para el grupo. Si habilitas el escalador automático de grupos de nodos, especifica un rango para el tamaño del grupo de nodos. Puedes cambiar los valores de forma manual más adelante.

  9. Establece la Política de mantenimiento del grupo de nodos de usuario único en la sección Establece la configuración de mantenimiento en uno de los siguientes valores. La política de mantenimiento te permite configurar el comportamiento de las VM en el grupo de nodos durante los eventos de mantenimiento del host. Para obtener más información, consulta Políticas de mantenimiento:

    • Valor predeterminado
    • Reiniciar en su ubicación
    • Migrar dentro del grupo de nodos

  10. Puedes elegir entre períodos de mantenimiento habituales y control de mantenimiento avanzado para controlar el mantenimiento de tu grupo de nodos de usuario único, de la siguiente manera:

    • Período de mantenimiento: Selecciona el período durante el que deseas que se produzcan los eventos de mantenimiento planificado para los nodos de los grupos de nodos de usuario único.

    • Habilita el control de mantenimiento avanzado para usuarios únicos: El control de mantenimiento avanzado para usuarios únicos te permite controlar los eventos de mantenimiento planificado para grupos de nodos de usuario único y minimizar las interrupciones relacionadas con el mantenimiento. Para habilitar el control de mantenimiento avanzado, haz clic en el botón de activación Habilita el control de mantenimiento avanzado para usuarios únicos y llévalo a la posición activado. Si decides usar esta opción para el mantenimiento de los nodos, se inhabilita el campo Período de mantenimiento y el mantenimiento se realiza según la configuración del control de mantenimiento avanzado.

    Ten en cuenta que el control de mantenimiento avanzado solo admite la política de mantenimiento predeterminada.

  11. Para establecer la configuración de uso compartido, especifica una de las siguientes opciones en Establece la configuración de uso compartido:

    • Para compartir el grupo de nodos con todos los proyectos de tu organización, elige Compartir este grupo de nodos con todos los proyectos dentro de la organización.
    • Para compartir el grupo de nodos con proyectos específicos dentro de la organización, elige Compartir este grupo de nodos con proyectos seleccionados dentro de la organización.

    Si no deseas compartir el grupo de nodos, elige No compartir este grupo de nodos con otros proyectos. Para obtener más información sobre el uso compartido de grupos de nodos, consulta Comparte grupos de nodos de usuario único.

  12. Haz clic en Crear para terminar de crear el grupo de nodos.

gcloud

Ejecuta el comando gcloud compute sole-tenancy node-groups create para crear un grupo de nodos basado en una plantilla de nodo creada antes:

gcloud compute sole-tenancy node-groups create GROUP_NAME \
  --node-template=TEMPLATE_NAME \
  --target-size=TARGET_SIZE \
  [--zone=ZONE \]
  [--maintenance-policy=MAINTENANCE_POLICY \]
  [--maintenance-window-start-time=START_TIME \]
  [--autoscaler-mode=AUTOSCALER_MODE \
  --min-nodes=MIN_NODES \
  --max-nodes=MAX_NODES]

Reemplaza lo siguiente:

  • GROUP_NAME: Es el nombre del grupo de nodos nuevo.
  • TEMPLATE_NAME: es el nombre de la plantilla de nodos que se usará para crear este grupo.
  • TARGET_SIZE: es la cantidad de nodos que se crearán en el grupo.
  • ZONE: Es la zona en la que se creará el grupo de nodos. Debe ser la misma región que la de la plantilla de nodo en la que se basa el grupo de nodos.

  • MAINTENANCE_POLICY: Es la política de mantenimiento del grupo de nodos. Para obtener más información, consulta Políticas de mantenimiento. Debe ser uno de los siguientes valores:

    • default
    • restart-in-place
    • migrate-within-node-group

    Como alternativa, puedes habilitar el control de mantenimiento avanzado para el grupo de nodos de usuario único con la marca --maintenance-interval. Para obtener más información, consulta Habilita el control de mantenimiento avanzado en un nodo de usuario único.

  • START_TIME: Es la hora de inicio en GMT para el período de mantenimiento de las VM en este grupo de nodos. Establece en una de las siguientes opciones: 00:00, 04:00, 08:00, 12:00, 16:00 o 20:00. Si no se configura, el grupo de nodos no tendrá un período de mantenimiento establecido.

  • AUTOSCALER_MODE: Es la política de escalador automático para el grupo de nodos. Debe ser una de las siguientes:

    • off: Administra de forma manual el tamaño del grupo de nodos.
    • on: Permite que los nodos se agreguen o quiten de forma automática del grupo de nodos.
    • only-scale-out: Agrega nodos al grupo de nodos cuando se requiere capacidad adicional.

  • MIN_NODES: Es el tamaño mínimo del grupo de nodos. El valor predeterminado es 0 y debe ser un número entero menor o igual que MAX_NODES.

  • MAX_NODES: Es el tamaño máximo del grupo de nodos. Debe ser menor o igual que 100 y mayor o igual que MIN_NODES. Es obligatorio si AUTOSCALER_MODE no está configurado como off.

REST

Usa el método nodeGroups.insert para crear un grupo de nodos basado en una plantilla de nodos creada antes:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups?initialNodeCount=TARGET_SIZE
{
  "nodeTemplate": "regions/REGION/nodeTemplates/TEMPLATE_NAME",
  "name": "GROUP_NAME",
  "maintenancePolicy": MAINTENANCE_POLICY,
  "maintenanceWindow": {
      "startTime": "START_TIME"
  },
  "autoscalingPolicy": {
      "mode": AUTOSCALER_MODE,
      "minNodes": MIN_NODES,
      "maxNodes": MAX_NODES
  },
}

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.

  • ZONE: Es la zona en la que se creará el grupo de nodos. Debe estar en la misma región que la plantilla de nodos en la que se basa el grupo de nodos.

  • TARGET_SIZE: es la cantidad de nodos que se crearán en el grupo.

  • REGION: Es la región en la que se creará el grupo de nodos. Debes tener una plantilla de nodo en la región seleccionada.

  • TEMPLATE_NAME: es el nombre de la plantilla de nodos que se usará para crear este grupo.

  • GROUP_NAME: Es el nombre del grupo de nodos nuevo.

  • MAINTENANCE_POLICY: Es la política de mantenimiento del grupo de nodos. Debe ser uno de los siguientes valores:

    • DEFAULT
    • RESTART_IN_PLACE
    • MIGRATE_WITHIN_NODE_GROUP

    Como alternativa, puedes habilitar el control de mantenimiento avanzado para el grupo de nodos de usuario único con el campo maintenanceInterval. Para obtener más información, consulta Habilita el control de mantenimiento avanzado en un nodo de usuario único.

  • START_TIME: Es la hora de inicio en GMT para el período de mantenimiento de las VM en este grupo de nodos. Establece en una de las siguientes opciones: 00:00, 04:00, 08:00, 12:00, 16:00 o 20:00. Si no se configura, el grupo de nodos no tendrá un período de mantenimiento establecido.

  • AUTOSCALER_MODE: Es la política de escalador automático para el grupo de nodos. Debe ser uno de los siguientes valores:

    • OFF: Administra de forma manual el tamaño del grupo de nodos.
    • ON: Permite que los nodos se agreguen o quiten de forma automática del grupo de nodos.
    • ONLY_SCALE_OUT: Agrega nodos al grupo de nodos cuando se requiere capacidad adicional.

  • MIN_NODES: Es el tamaño mínimo del grupo de nodos. El valor predeterminado es 0 y debe ser un número entero menor o igual que MAX_NODES.

  • MAX_NODES: Es el tamaño máximo del grupo de nodos. Debe ser menor o igual que 100 y mayor o igual que MIN_NODES. Es obligatorio si AUTOSCALER_MODE no está configurado como OFF.

Borrar un grupo de nodos

Si necesitas borrar un grupo de nodos de usuario único, primero quita cualquier VM del grupo de nodos.

Console

  1. Ve a la página Nodos de usuario único.

    Ir a Nodos de usuario único

  2. Haz clic en el Nombre del grupo de nodos que deseas borrar.

  3. En cada nodo del grupo de nodos, haz clic en el nombre del nodo y borra las instancias de VM individuales en la página de detalles del nodo, o sigue el procedimiento estándar para borrar una VM individual. Para borrar VMs en un grupo de instancias administrado, borra el grupo de instancias administrado.

  4. Después de borrar todas las instancias de VM que se ejecutan en todos los nodos del grupo, regresa a la página Nodos de usuario único.

    Ir a Nodos de usuario único

  5. Haz clic en Grupos de nodos.

  6. Selecciona el nombre del grupo de nodos que deseas borrar.

  7. Haz clic en Borrar.

gcloud

  1. Enumera las instancias de VM en ejecución en los nodos del grupo de nodos mediante el comando gcloud compute sole-tenancy node-groups list-nodes:

    gcloud compute sole-tenancy node-groups list-nodes GROUP_NAME \
  --zone=ZONE

    Reemplaza lo siguiente:

    • GROUP_NAME: el nombre del grupo de nodos
    • ZONE: Es la zona del grupo de nodos.

  2. Si hay VMs en ejecución en el grupo de nodos, sigue el procedimiento para borrar una VM individual o el procedimiento para borrar un grupo de instancias administrado.

  3. Después de borrar todas las VM que se ejecutan en todos los nodos del grupo de nodos, borra el grupo mediante el comando gcloud compute sole-tenancy node-groups delete:

    gcloud compute sole-tenancy node-groups delete GROUP_NAME \
    --zone=ZONE

    Reemplaza lo siguiente:

    • GROUP_NAME: es el nombre del grupo de nodos
    • ZONE: es la zona del grupo de nodos

REST

  1. Enumera las instancias de VM en ejecución en los nodos del grupo de nodos mediante el método nodeGroups.listNodes:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/GROUP_NAME/listNodes

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto
    • ZONE: es la zona del grupo de nodos
    • GROUP_NAME: Es el grupo para el que se enumerarán las VM.

  2. Si hay VMs en ejecución en el grupo de nodos, sigue el procedimiento para borrar una VM individual o el procedimiento para borrar un grupo de instancias administrado.

  3. Después de borrar todas las VM que se ejecutan en todos los nodos del grupo de nodos, borra el grupo mediante el método nodeGroups.delete:

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/GROUP_NAME

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto
    • ZONE: es la zona del grupo de nodos
    • GROUP_NAME: es el nombre del grupo de nodos que se borrará

¿Qué sigue?