Crea plantillas de nodos de usuario único

En este documento, se describe cómo crear y borrar plantillas de nodos de usuario único. Antes de crear plantillas de nodos de usuario único, revisa la descripción general de los nodos de usuario único para conocer conceptos y terminología importantes.

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

Crea una plantilla de nodo de usuario único

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

Para crear una plantilla de nodo 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. El proceso de creación de un grupo de nodos en la consola incluye la creación o selección de una plantilla de nodo.

  3. Especifica un Nombre para el grupo de nodos.

  4. Especifica una Región en la que se 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 Plantilla de nodo, haz clic en Crear plantilla de nodo para comenzar a crear una plantilla de nodo de usuario único.

  7. Especifica un Nombre para la plantilla de nodo.

  8. Especifica el Tipo de nodo para cada nodo de usuario único del grupo de nodos que deseas crear en función de esta plantilla.

  9. También puedes especificar las siguientes propiedades para la plantilla de nodo (opcional):

    • Agrega un SSD local y un acelerador de GPU.
    • Selecciona Habilitar el exceso de compromiso de CPU para controlar los niveles de exceso de compromiso de CPU de cada VM programada en el nodo.
    • Agrega Etiquetas de afinidad de nodo. Las etiquetas de afinidad te permiten agrupar nodos y grupos de nodos de forma lógica y, luego, cuando aprovisionas VM, puedes especificar etiquetas de afinidad en las VM 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. Haz clic en Crear para terminar de crear tu plantilla de nodo.

  11. Para agregar una plantilla de nodos de usuario único nueva en una región diferente, repite los pasos anteriores (opcional).

Para ver las plantillas de nodos, haz clic en Plantillas de nodos en la página Nodos de usuario único.

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]

Reemplaza lo siguiente:

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

  • NODE_TYPE: Es el tipo de nodo para los nodos de usuario único que se crearon según esta plantilla. Usa el comando gcloud compute sole-tenancy node-types list para obtener una lista de los tipos de nodos disponibles en cada zona.

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

  • AFFINITY_LABELS: Son las claves y los valores, [KEY=VALUE,...], de las etiquetas de afinidad. Las etiquetas de afinidad te permiten agrupar nodos y grupos de nodos de forma lógica y, luego, cuando aprovisionas VM, puedes especificar etiquetas de afinidad en las VM 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: Es el tipo de GPU para cada nodo de usuario único que se creó según esta plantilla de nodo. Para obtener información sobre la disponibilidad zonal de las GPU, usa el comando gcloud compute accelerator-types list y elige una zona en la que esté disponible el tipo de nodo de usuario único n1, g2, a3-highgpu o a3-megagpu. Según la disponibilidad zonal, establece una de las siguientes opciones:

    • Para 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: Es la cantidad de GPU que se debe especificar según el tipo de GPU. Se establece en el valor especificado para el tipo de GPU, 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: Es la cantidad de discos SSD locales. Se establece en 16 o 24. Este parámetro no es obligatorio para los tipos de nodos A3 High y A3 Mega, ya que incluyen una cantidad fija de discos SSD locales.

  • DISK_SIZE: Es el valor opcional para el tamaño de partición del SSD local en GB. El único tamaño de partición admitido es 375 y, si no estableces este valor, el valor predeterminado será 375.

  • CPU_OVERCOMMIT_TYPE: Es el tipo de exceso de compromiso de las CPU en una VM. Se establece en 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
}

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.

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

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

  • NODE_TYPE: Es el tipo de nodo para los nodos de usuario único que se crearon según esta plantilla. Usa el método nodeTypes.list para obtener una lista de los tipos de nodos disponibles en cada zona.

  • KEY: Es el valor nodeAffinityLabels que especifica la porción de clave de una etiqueta de afinidad de nodo expresada como un par clave-valor. Las etiquetas de afinidad te permiten agrupar nodos y grupos de nodos de forma lógica y, luego, cuando aprovisionas VM, puedes especificar etiquetas de afinidad en las VM 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: Es el valor nodeAffinityLabels que especifica la porción del valor de una etiqueta de afinidad de nodo expresada como un par clave-valor.

  • GPU_TYPE: Es el tipo de GPU para cada nodo de usuario único que se creó según esta plantilla de nodo. Para obtener información sobre la disponibilidad zonal de las GPU, usa el comando gcloud compute accelerator-types list y elige una zona en la que esté disponible el tipo de nodo de usuario único n1, g2, a3-highgpu o a3-megagpu. Según la disponibilidad zonal, establece una de las siguientes opciones:

    • Para 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: La cantidad de GPU para cada nodo de usuario único que se creó según esta plantilla de nodo. Se establece en el valor especificado para el tipo de GPU, 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: Es el valor opcional para el tamaño de partición del SSD local en GB. El único tamaño de partición admitido es 375 y, si no estableces este valor, el valor predeterminado será 375.

  • DISK_COUNT: Es la cantidad de discos SSD locales. Se establece en 16 o 24. Este parámetro no es obligatorio para los tipos de nodos A3 High y A3 Mega, ya que incluyen una cantidad fija de discos SSD locales.

  • CPU_OVERCOMMIT_TYPE: Tipo de exceso de compromiso de CPU. Se establece en enabled, none o CPU_OVERCOMMIT_TYPE_UNSPECIFIED.

Borrar una plantilla de nodo

Puedes borrar una plantilla de nodo después de borrar todos los grupos de nodos que la usan.

Consola

  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 Plantillas de nodo.

  3. Selecciona el nombre de una plantilla de nodos sin usar.

  4. Haz clic en Borrar.

gcloud

Usa el comando gcloud compute sole-tenancy node-templates delete para borrar una plantilla de nodo sin usar:

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

Reemplaza lo siguiente:

  • TEMPLATE_NAME: el nombre de la plantilla de nodo que se borrará.

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

REST

Usa el método compute.nodeTemplates.delete para borrar una plantilla de nodos sin usar:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.

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

  • TEMPLATE_NAME: El nombre de la plantilla de nodo que se borrará

¿Qué sigue?