Habilitar el control de mantenimiento avanzado para nodos de único cliente

El control avanzado del mantenimiento de único propietario te permite controlar los eventos de mantenimiento programados de los grupos de nodos de único propietario y minimizar las interrupciones relacionadas con el mantenimiento. Esta función solo está disponible para grupos de nodos de un solo inquilino. Para usar esta función con tus máquinas virtuales, primero debes moverlas a grupos de nodos de un solo inquilino que tengan habilitado el control de mantenimiento avanzado.

La función de control de mantenimiento avanzado para único cliente te permite hacer lo siguiente:

• Comprueba si hay eventos de mantenimiento programados para un nodo de un solo inquilino con 28 días de antelación.
• Activa el mantenimiento inmediatamente o prográmalo para más adelante. Ten en cuenta que, si activas el mantenimiento inmediatamente, se llevará a cabo en un plazo de 6 horas a partir del momento en que envíes la solicitud.

A continuación, se describe el proceso para crear un grupo de nodos de único cliente con control de mantenimiento avanzado:

1. Habilita el control de mantenimiento avanzado en grupos de nodos de único cliente compatibles. Esta función solo está disponible para grupos de nodos de un solo inquilino. Para usar esta función con tus máquinas virtuales o cargas de trabajo de único cliente, primero debes mover tus máquinas virtuales a grupos de nodos de único cliente con el control de mantenimiento avanzado habilitado.

2. Consulta el mantenimiento programado de tus nodos de un solo inquilino. El mantenimiento de un nodo de un solo inquilino se realiza como máximo cada 28 días. Puedes consultar el evento de mantenimiento de un nodo 28 días antes del inicio del periodo de mantenimiento de 6 horas en el que se ha programado el mantenimiento de ese nodo.

3. Si se ha programado el mantenimiento de un nodo de un solo inquilino y, antes de que empiece el periodo de mantenimiento programado, puedes hacer lo siguiente:

   • Activa el mantenimiento inmediatamente o prográmalo para más adelante. Si decides activar el mantenimiento de inmediato, se llevará a cabo en un plazo de 6 horas desde el momento en que actives la solicitud. Ten en cuenta que la fecha y la hora programadas que elijas deben ser anteriores a la hora de inicio de la ventana de mantenimiento inicial.

   • Si no activas el mantenimiento inmediatamente ni lo programas para más adelante, se realizará en el plazo indicado en la ventana de mantenimiento inicial.

Puedes autoescalar grupos de nodos de un solo inquilino con el control de mantenimiento avanzado habilitado. Los registros de auditoría se generan en todos los casos.

Familias de máquinas admitidas

El control avanzado del mantenimiento de nodos de un solo cliente está disponible para las familias de máquinas C2, C3, C3D, C4, G2, H3, M1, M2, M3 y M4 en disponibilidad general.

Limitaciones

Estas son las limitaciones del control de mantenimiento avanzado de la función de arrendamiento exclusivo:

• SSDs locales y GPUs: esta función no es compatible con los SSDs locales ni con las GPUs.
• Políticas de mantenimiento: esta función admite la política de mantenimiento predeterminada (migración en tiempo real). No se admiten otras políticas de mantenimiento, como la de reinicio in situ y la de migración dentro del grupo de nodos.
• Nodos: esta función admite un máximo de 20 nodos por proyecto y zona.
• Control de mantenimiento avanzado para grupos de nodos de un solo inquilino: no puedes habilitar el control de mantenimiento avanzado en grupos de nodos de un solo inquilino que ya tengas. Si quieres ejecutar tus cargas de trabajo en grupos de nodos de un solo inquilino con el control de mantenimiento avanzado habilitado, primero debes crear un grupo de nodos con el control de mantenimiento avanzado habilitado y, a continuación, migrar tu carga de trabajo a este grupo. Del mismo modo, para inhabilitar el control de mantenimiento avanzado, debes migrar tus nodos de único propietario a grupos de nodos de único propietario que no tengan habilitado el control de mantenimiento avanzado.
• Impacto en las políticas de mantenimiento actuales: si habilitas esta función, se anularán las ventanas de mantenimiento asociadas a los nodos de único cliente.

Costes

El uso del control de mantenimiento avanzado en nodos de un solo inquilino no tiene ningún coste adicional.

Antes de empezar

• Antes de aprovisionar VMs en un nodo de único cliente, consulta tu cuota. En función del número y el tamaño de los nodos que reserves, es posible que tengas que solicitar cuota adicional.
• Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:

     gcloud init

     Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  2. Set a default region and zone.

  REST

  Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

  Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:

  gcloud init

  Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Habilitar el control de mantenimiento avanzado en un nodo de único propietario

El control de mantenimiento avanzado para el aislamiento de inquilino es una función opcional y solo está disponible para los grupos de nodos de aislamiento de inquilino. Para usar esta función con tus VMs o cargas de trabajo de único cliente, primero debes mover tus VMs a grupos de nodos de único cliente con el control de mantenimiento avanzado habilitado.

gcloud compute sole-tenancy node-groups create NODE_GROUP_NAME \
--node-template=NODE_TEMPLATE_NAME \
--zone=NODE_GROUP_ZONE \
--target-size=NODE_GROUP_SIZE \
--maintenance-interval=RECURRENT

POST https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups
{
"name": "NODE_GROUP_NAME",
"nodeTemplate": "NODE_TEMPLATE_URL",
"zone": "NODE_GROUP_ZONE",
"size": "NODE_GROUP_SIZE",
"maintenanceInterval": "RECURRENT"
}

Consultar el próximo mantenimiento

El mantenimiento de un nodo de un solo inquilino se realiza como máximo cada 28 días. Puedes consultar el evento de mantenimiento de un nodo 28 días antes del inicio del periodo de mantenimiento de 6 horas, en el que se ha programado el mantenimiento de ese nodo.

gcloud compute sole-tenancy node-groups list-nodes NODE_GROUP_NAME \
--format "table(name, status, node_type, instances, server_id, upcoming_maintenance)"

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/listNodes

{
  …
  "items": [
    …
    {
      "name": string,
      "status": string,
      …
      "upcomingMaintenance": {
        "canReschedule": boolean,
        "maintenanceType": enum, // SCHEDULED | UNSCHEDULED
        "windowStartTime": string, // RFC 3339 timestamp string
        "windowEndTime": string, // RFC 3339 timestamp string
        "latestWindowStartTime": string, // RFC 3339 timestamp string
        "maintenanceStatus": enum // PENDING | ONGOING
      },
      …
    },
    …
  ],
  …
}

Si no ves ningún evento de mantenimiento, significa que no hay ningún mantenimiento programado para los nodos del grupo de nodos.

Activar el mantenimiento inmediatamente o programarlo para un nodo

Una vez que sepas qué nodos de un grupo de nodos de un solo inquilino están programados para mantenimiento, puedes hacer lo siguiente:

• Activa el mantenimiento inmediatamente. Si decides activar el mantenimiento inmediatamente, se llevará a cabo en un plazo de 6 horas desde el momento en que actives la solicitud.

• Programa el mantenimiento para más adelante según tus requisitos.

Si no activas el mantenimiento inmediatamente ni lo programas para una fecha y hora posteriores, se realizará en la ventana de mantenimiento inicial. Una vez que empieza el mantenimiento de un nodo, no puedes pausarlo ni reprogramarlo.

gcloud compute sole-tenancy node-groups perform-maintenance NODE_GROUP_NAME \
--zone=NODE_GROUP_ZONE \
--nodes=NODE_NAMES \
--window-start-time=WINDOW_START_TIME

POST
https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/performMaintenance
{
"nodes": "NODE_NAMES" // [Required] The user needs to list at least 1 node
"windowStartTime":  "WINDOW_START_TIME" // [Optional] RFC 3339 timestamp string
}

El campo Estado de mantenimiento de un nodo muestra el siguiente estado durante el proceso de mantenimiento:

• Pendiente: la operación de mantenimiento aún no ha empezado, pero está programada.
• En curso: la ventana de mantenimiento ha empezado. El evento de mantenimiento sigue en curso hasta que se complete correctamente en el nodo.

Comprobar si el mantenimiento se ha completado

Para consultar el estado de mantenimiento de un nodo con control de mantenimiento avanzado, usa el comando gcloud compute sole-tenancy node-groups list-nodes o el método nodeGroups.listNodes.

Para obtener más información, consulta el estado del mantenimiento.

• Mantenimiento correcto: si el mantenimiento de un nodo de un solo inquilino se realiza correctamente, se elimina la notificación de mantenimiento. Cuando consultes el nombre del grupo de nodos, la sección upcomingMaintenance ya no estará presente en el nodo.
• Mantenimiento fallido: si el mantenimiento no se completa en el plazo de 6 horas, el evento de mantenimiento seguirá en curso hasta que se complete correctamente en el nodo. Una vez completada, se elimina la notificación de mantenimiento.

A veces, la solicitud de activación del mantenimiento para la fecha y la hora que elijas se puede rechazar si se han superado los límites internos del mantenimiento avanzado de los nodos de un solo inquilino para la fecha y la hora especificadas. Google Cloud En ese caso, debes seleccionar otra fecha y hora para el mantenimiento del nodo. El estado del mantenimiento de este nodo es En curso y seguirá así hasta que se complete correctamente.

Cambiar la fecha y la hora del mantenimiento programado

Puedes modificar la fecha y la hora de mantenimiento programadas de un nodo de tenencia exclusiva siguiendo el mismo procedimiento que usas para activar o programar el mantenimiento de un nodo.