Crear plantillas de nodos de único cliente

En este documento se describe cómo crear y eliminar plantillas de nodos de único propietario. Antes de crear plantillas de nodos de un solo inquilino, consulta la descripción general de los nodos de un solo inquilino para conocer conceptos y términos importantes.

Las plantillas de nodos de único cliente son recursos regionales que especifican propiedades para grupos de nodos de único cliente. Debes crear una plantilla de nodo antes de crear un grupo de nodos.

Crear una plantilla de nodo de único cliente

Si usas la CLI de gcloud o REST, puedes crear un recurso de plantilla de nodo que puedes usar más adelante para crear uno o varios grupos de nodos. Si usas la consola, debes crear plantillas de nodos al crear un grupo de nodos. Google Cloud

Para crear una plantilla de nodo de un solo inquilino, utiliza uno de los siguientes métodos:

Consola

  1. En la Google Cloud consola, ve a la página Nodos de un solo inquilino.

    Ir a Nodos de único cliente

  2. Haz clic en Crear grupo de nodos. El proceso de creación de un grupo de nodos en la consola incluye la creación o la selección de una plantilla de nodo.

  3. Especifica un Nombre para el grupo de nodos.

  4. Especifica una región en la que crear la plantilla de nodo. Puedes usar la plantilla de nodo para crear grupos de nodos en cualquier zona de esta región.

  5. Especifica la zona y haz clic en Continuar.

  6. En la lista Node template (Plantilla de nodo), haga clic en Create node template (Crear plantilla de nodo) para empezar a crear una plantilla de nodo de único inquilino.

  7. Especifica un nombre para la plantilla de nodo.

  8. Especifica el Tipo de nodo de cada nodo de único propietario del grupo de nodos que se va a crear a partir de esta plantilla de nodo.

  9. También puede especificar las siguientes propiedades del nodo template:

    • Añade una SSD local y un acelerador de GPU.
    • Selecciona Habilitar exceso de compromiso de CPU para controlar los niveles de exceso de compromiso de CPU de cada VM programada en el nodo.
    • Añade etiquetas de afinidad de nodos. Las etiquetas de afinidad te permiten agrupar de forma lógica nodos y grupos de nodos. Más adelante, cuando aprovisiones máquinas virtuales, podrás especificar etiquetas de afinidad en las máquinas virtuales para programarlas en un conjunto específico de nodos o grupos de nodos. Para obtener más información, consulta Afinidad y antiafinidad de nodos.

  10. Haga clic en Crear para terminar de crear la plantilla de nodo.

  11. Opcional: Para añadir una plantilla de nodos de único inquilino en otra región, repite los pasos anteriores.

Para ver las plantillas de nodo, haga clic en Plantillas de nodo en la página Nodos de un solo inquilino.

gcloud

Usa el comando gcloud compute sole-tenancy node-templates create para crear una plantilla de nodo:

gcloud compute sole-tenancy node-templates create TEMPLATE_NAME \
  --node-type=NODE_TYPE \
  [--region=REGION \]
  [--node-affinity-labels=AFFINITY_LABELS \]
  [--accelerator type=GPU_TYPE,count=GPU_COUNT \]
  [--disk type=local-ssd,count=DISK_COUNT,size=DISK_SIZE \]
  [--cpu-overcommit-type=CPU_OVERCOMMIT_TYPE]

Haz los cambios siguientes:

  • TEMPLATE_NAME: el nombre de la nueva plantilla de nodo.

  • NODE_TYPE: el tipo de nodo de los nodos de único cliente creados a partir de esta plantilla. Usa el comando gcloud compute sole-tenancy node-types list para obtener una lista de los tipos de nodo disponibles en cada zona.

  • REGION: la región en la que se creará la plantilla de nodo. Puede usar esta plantilla para crear grupos de nodos en cualquier zona de esta región.

  • AFFINITY_LABELS: las claves y los valores, [KEY=VALUE,...], de las etiquetas de afinidad. Las etiquetas de afinidad te permiten agrupar lógicamente nodos y grupos de nodos. Más adelante, cuando aprovisiones máquinas virtuales, podrás especificar etiquetas de afinidad en las máquinas virtuales para programarlas en un conjunto específico de nodos o grupos de nodos. Para obtener más información, consulta Afinidad y antiafinidad de nodos.

  • GPU_TYPE: el tipo de GPU de cada nodo de único inquilino creado a partir de esta plantilla de nodo. Para obtener información sobre la disponibilidad de las GPUs por zonas, usa el comando gcloud compute accelerator-types list y elige una zona en la que esté disponible el tipo de nodo de único propietario n1, g2, a3-highgpu o a3-megagpu. En función de la disponibilidad zonal, se puede definir uno de los siguientes valores:

    • En A3 High: nvidia-h100-80gb
    • Para A3 Mega: nvidia-h100-mega-80gb
    • Para G2: nvidia-l4
    • Para N1:
      • nvidia-tesla-p100
      • nvidia-tesla-p4
      • nvidia-tesla-t4
      • nvidia-tesla-v100

  • GPU_COUNT: el número de GPUs que se debe especificar en función del tipo de GPU. Asigna el valor especificado para el tipo de GPU, tal como se muestra en la siguiente tabla:

    GPU_TYPE GPU_COUNT
    nvidia-h100-80gb 8
    nvidia-h100-mega-80gb 8
    nvidia-l4 8
    nvidia-tesla-p100 4
    nvidia-tesla-p4 4
    nvidia-tesla-t4 4
    nvidia-tesla-v100 8

  • DISK_COUNT: número de discos SSD locales. Su valor debe ser 16 o 24. Este parámetro no es obligatorio para los tipos de nodo A3 High y A3 Mega, ya que incluyen un número fijo de discos SSD locales.

  • DISK_SIZE: valor opcional del tamaño de la partición de la SSD local en GB. El único tamaño de partición admitido es 375. Si no defines este valor, se asignará 375 de forma predeterminada.

  • CPU_OVERCOMMIT_TYPE: el tipo de compromiso de CPU de una VM. Su valor debe ser enabled o none.

REST

Usa el método nodeTemplates.insert para crear una plantilla de nodo:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/nodeTemplates

{
  "name": "TEMPLATE_NAME",
  "nodeType": "NODE_TYPE",
  "nodeAffinityLabels": {
    "KEY": "VALUE",
    ...
  },
  "accelerators": [
    {
      "acceleratorType": "GPU_TYPE",
      "acceleratorCount": GPU_COUNT
    }
  ],
  "disks": [
    {
      "diskType": "local-ssd",
      "diskSizeGb": DISK_SIZE,
      "diskCount": DISK_COUNT
    }
  ],
  "cpuOvercommitType": CPU_OVERCOMMIT_TYPE
}

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto.

  • REGION: la región en la que se creará la plantilla de nodo. Puede usar esta plantilla para crear grupos de nodos en cualquier zona de esta región.

  • TEMPLATE_NAME: el nombre de la nueva plantilla de nodo.

  • NODE_TYPE: el tipo de nodo de los nodos de único cliente creados a partir de esta plantilla. Usa el método nodeTypes.list para obtener una lista de los tipos de nodos disponibles en cada zona.

  • KEY: el valor nodeAffinityLabels que especifica la parte de la clave de una etiqueta de afinidad de nodo expresada como un par clave-valor. Las etiquetas de afinidad te permiten agrupar lógicamente nodos y grupos de nodos. Más adelante, al aprovisionar máquinas virtuales, puedes especificar etiquetas de afinidad en las máquinas virtuales para programarlas en un conjunto específico de nodos o grupos de nodos. Para obtener más información, consulta Afinidad y antiafinidad de nodos.

  • VALUE: el valor nodeAffinityLabels que especifica la parte del valor de un par clave-valor de etiqueta de afinidad de nodo.

  • GPU_TYPE: el tipo de GPU de cada nodo de único inquilino creado a partir de esta plantilla de nodo. Para obtener información sobre la disponibilidad de las GPUs por zonas, usa el comando gcloud compute accelerator-types list y elige una zona en la que esté disponible el tipo de nodo de único propietario n1, g2, a3-highgpu o a3-megagpu. En función de la disponibilidad zonal, se puede definir uno de los siguientes valores:

    • En A3 High: nvidia-h100-80gb
    • Para A3 Mega: nvidia-h100-mega-80gb
    • Para G2: nvidia-l4
    • Para N1:
      • nvidia-tesla-p100
      • nvidia-tesla-p4
      • nvidia-tesla-t4
      • nvidia-tesla-v100

  • GPU_COUNT: número de GPUs de cada nodo de único inquilino creado a partir de esta plantilla de nodo. Asigna el valor especificado para el tipo de GPU, tal como se muestra en la siguiente tabla:

    GPU_TYPE GPU_COUNT
    nvidia-h100-80gb 8
    nvidia-h100-mega-80gb 8
    nvidia-l4 8
    nvidia-tesla-p100 4
    nvidia-tesla-p4 4
    nvidia-tesla-t4 4
    nvidia-tesla-v100 8

  • DISK_SIZE: valor opcional del tamaño de la partición de la SSD local en GB. El único tamaño de partición admitido es 375. Si no defines este valor, se asignará 375 de forma predeterminada.

  • DISK_COUNT: número de discos SSD locales. Su valor debe ser 16 o 24. Este parámetro no es obligatorio para los tipos de nodo A3 High y A3 Mega, ya que incluyen un número fijo de discos SSD locales.

  • CPU_OVERCOMMIT_TYPE: tipo de exceso de compromiso de CPU. Su valor debe ser enabled, none o CPU_OVERCOMMIT_TYPE_UNSPECIFIED.

Eliminar plantilla de nodo

Puedes eliminar una plantilla de nodo después de haber eliminado todos los grupos de nodos que la usen.

Consola

  1. En la Google Cloud consola, ve a la página Nodos de un solo inquilino.

    Ir a Nodos de único cliente

  2. Haz clic en Plantillas de nodos.

  3. Seleccione el nombre de una plantilla de nodo que no se haya usado.

  4. Haz clic en Eliminar.

gcloud

Usa el comando gcloud compute sole-tenancy node-templates delete para eliminar una plantilla de nodo que no se use:

gcloud compute sole-tenancy node-templates delete TEMPLATE_NAME \
  --region=REGION

Haz los cambios siguientes:

  • TEMPLATE_NAME: el nombre de la plantilla de nodo que se va a eliminar

  • REGION: la región de la plantilla de nodo

REST

Siga el compute.nodeTemplates.delete método para eliminar una plantilla de nodo que no se utilice:

 DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/nodeTemplates/TEMPLATE_NAME

Haz los cambios siguientes:

  • PROJECT_ID: tu ID de proyecto

  • REGION: la región Google Cloud que contiene la plantilla de nodo

  • TEMPLATE_NAME: el nombre de la plantilla de nodo que se va a eliminar

Siguientes pasos