Habilita el control de mantenimiento avanzado para nodos de usuario único

Con el control de mantenimiento avanzado de usuario único puedes controlar los eventos de mantenimiento planificados de grupos de nodos de usuario único y minimizar las interrupciones relacionadas con el mantenimiento. Esta función sólo está disponible para grupos de nodos de usuario único. Para usar esta función con tus máquinas virtuales existentes, primero debes mover las VM a grupos de nodos de usuario único que tienen habilitado el control de mantenimiento avanzado.

Con el control de mantenimiento avanzado de la función de usuario único puedes hacer lo siguiente:

  • Verifica los eventos de mantenimiento programados para un nodo de usuario único con 28 días de anticipación.
  • Activa el mantenimiento de inmediato o prográmalo para más adelante. Ten en cuenta que si activas el mantenimiento de inmediato, el mantenimiento se realiza en un plazo de 6 horas desde el momento en que activas la solicitud.

El siguiente es el proceso para crear un grupo de nodos de usuario único con control de mantenimiento avanzado:

  1. Habilita el control de mantenimiento avanzado en los grupos de nodos de usuario único compatibles. Esta función sólo está disponible para grupos de nodos de usuario único. Para usar esta función con tus VM o cargas de trabajo de usuario único existentes, primero debes mover tus VM a grupos de nodos de usuario único con el control de mantenimiento avanzado habilitado.

  2. Verifica el próximo mantenimiento de tus nodos de usuario único. El mantenimiento de un nodo de usuario único se realiza como máximo cada 28 días. Puedes verificar el evento de mantenimiento de un nodo 28 días antes del inicio del período de mantenimiento de 6 horas en el que está programado el mantenimiento para ese nodo.

  3. Si el mantenimiento está programado para un nodo de usuario único y antes de que comience el período de mantenimiento programado, puedes hacer lo siguiente:

    • Activa el mantenimiento de inmediato o prográmalo para más adelante. Si eliges activar el mantenimiento de inmediato, el mantenimiento se realiza en un plazo de 6 horas desde el momento en que activas la solicitud. Ten en cuenta que la fecha y hora programadas que elijas deben ser anteriores a la hora de inicio del período de mantenimiento inicial.

    • Si no activas el mantenimiento de inmediato ni lo programas para más adelante, el mantenimiento se realiza dentro del tiempo proporcionado en el período de mantenimiento inicial.

Puedes habilitar el ajuste de escala automático de los grupos de nodos de usuario único con el control de mantenimiento avanzado habilitado. Los registros de auditoría se generan en todos los casos.

Familias de máquinas compatibles

El control de mantenimiento avanzado de los nodos de usuario único es compatible con las siguientes familias de máquinas:

Limitaciones

Las siguientes son las limitaciones del control de mantenimiento avanzado de la función de usuario único:

  • SSD y GPU locales: Las SSD y GPU locales no son compatibles con esta característica.
  • Políticas de mantenimiento: Esta función admite la política de mantenimiento predeterminada (migración en vivo). No se admiten otras políticas de mantenimiento, como reiniciar en su lugar (BYOLv1) y migrar dentro del grupo de nodos (BYOLv2).
  • Nodos: Esta función puede admitir un máximo de 20 nodos por proyecto y por zona.
  • Control de mantenimiento avanzado para grupos de nodos de usuario único existentes: No puedes habilitar grupos de nodos de usuario único existentes para obtener un control de mantenimiento avanzado. Si deseas ejecutar tus cargas de trabajo existentes en grupos de nodos de usuario único con el control de mantenimiento avanzado habilitado, primero debes crear un grupo de nodos nuevo con el control de mantenimiento avanzado habilitado y, luego, migrar tu carga de trabajo a este grupo. Del mismo modo, para inhabilitar el control de mantenimiento avanzado, debes migrar tus nodos de usuario único a grupos de nodos de usuario único que no tengan habilitado el control de mantenimiento avanzado.
  • Impacto en las políticas de mantenimiento actuales Cuando habilitas esta función, se anulan los períodos de mantenimiento existentes asociados con los nodos de usuario único.

Costos

No se aplican costos adicionales por usar el control de mantenimiento avanzado en nodos de usuario único.

Antes de comenzar

  • Antes de aprovisionar las VM en un nodo de usuario único, verifica tu cuota. Según la cantidad y el tamaño de los nodos que reservas, es posible que debas solicitar una cuota adicional.

  • Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar código o muestras 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

Habilita el control de mantenimiento avanzado en un nodo de usuario único

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

Console

Puedes habilitar el control de mantenimiento avanzado cuando creas un grupo de nodos si seleccionas el Habilita el mantenimiento avanzado de usuario único opción en el Establecer la configuración de mantenimiento. Para obtener más información, consulta Crea un grupo de nodos de usuario único.

gcloud

Para crear un grupo de nodos de usuario único M2, usa el comando gcloud compute sole-tenancy node-groups create.

Para crear un grupo de nodos de usuario único de cualquier otra familia de máquinas compatible, usa el comando gcloud beta compute sole-tenancy node-groups create.

La marca --maintenance-interval=RECURRENT en el siguiente comando especifica que el nodo de usuario único está habilitado para el control de mantenimiento avanzado.

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

Reemplaza lo siguiente:

  • NODE_GROUP_NAME: Es el nombre del grupo de nodos

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

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

  • NODE_GROUP_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.

REST

Para crear un grupo de nodos de usuario único M2 basado en una plantilla de nodo creada antes, usa el método nodeGroups.insert.

Para crear un grupo de nodos de usuario único basado en una plantilla de nodo creada antes para todos los otros nodos, usa el método nodeGroups.insert.

El parámetro maintenanceInterval en el siguiente comando especifica que el nodo de usuario único está habilitado para el control de mantenimiento avanzado.

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"
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el nombre del proyecto en el que existe el grupo de nodos

  • NODE_GROUP_ZONE: Es la zona del grupo de nodos

  • NODE_GROUP_NAME: Es el nombre del grupo de nodos

  • NODE_TEMPLATE_URL: Es la URL de la plantilla de instancias que se usará para crear este grupo.

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

La marca a nivel de nodo anula las marcas de VM asignadas previamente. Por lo tanto, habilitar el control de mantenimiento avanzado anula las marcas de mantenimiento anteriores.

Consulta el próximo mantenimiento

El mantenimiento de un nodo de usuario único se realiza como máximo cada 28 días. Puedes verificar el evento de mantenimiento de un nodo 28 días antes del inicio del período de mantenimiento de 6 horas en el que está programado el mantenimiento para ese nodo.

Console

Después de habilitar un grupo de nodos de usuario único para el control de mantenimiento avanzado, verás los próximos eventos de mantenimiento de la siguiente manera:

  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 Grupos de nodos para ver una lista de grupos de nodos de usuario único.

  3. Para cualquier grupo de nodos de usuario único, puedes ver las columnas Estado de mantenimiento y Hora de mantenimiento en la tabla para el próximo mantenimiento. A medida que el mantenimiento se establece a nivel de nodo, la información de mantenimiento que ves aquí es el siguiente mantenimiento programado para cualquiera de los nodos dentro del grupo de nodos.

  4. Si quieres ver información de mantenimiento de cada nodo en un grupo de nodos de usuario único, haz clic en el nombre del grupo de nodos para abrir la página de detalles. Para cada nodo del grupo de nodos, las columnas Estado de mantenimiento y Hora de mantenimiento de la tabla muestran la próxima información de mantenimiento.

gcloud

Para enumerar los nodos de un grupo de nodos de usuario único M2 junto con la información de mantenimiento, usa el comando gcloud compute sole-tenancy node-groups list-nodes.

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

Reemplaza NODE_GROUP_NAME por el nombre del conjunto de datos.

REST

Para enumerar los nodos de un grupo de nodos de usuario único M2 junto con la información de mantenimiento, usa el método nodeGroups.listNodes.

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el nombre del proyecto en el que existe el grupo de nodos

  • NODE_GROUP_ZONE: Es la zona del grupo de nodos

  • NODE_GROUP_ID: Es el ID del grupo de nodos

A continuación, se muestra la respuesta del método nodeGroups.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
      },
      …
    },
    …
  ],
  …
}

A continuación, se presentan los detalles del evento de mantenimiento del grupo de nodos:

Nombre del parámetro Descripción
windowStartTime Hora de inicio del período de mantenimiento.
windowEndTime Hora de finalización del período de mantenimiento
latestWindowStartTime Hora de inicio del período de mantenimiento inicial. Puedes activar el mantenimiento de inmediato o programarlo para una fecha y hora posterior antes del latestWindowStartTime.
maintenanceType El tipo de mantenimiento que se realizará:
Programados: el mantenimiento está programado para este nodo.
Sin programar: El mantenimiento representa las actualizaciones críticas para las que se proporciona mucho menos aviso.
canReschedule Si se puede reprogramar el mantenimiento.
maintenanceStatus El estado de la operación de mantenimiento actual:
Pendiente: La operación de mantenimiento aún no se inició, pero está programada.
En curso: el período de mantenimiento se inició.

Si no ves ningún evento de mantenimiento, significa que no hay mantenimiento próximo para ningún nodo en el grupo de nodos.

Activa el mantenimiento de inmediato o programa el mantenimiento de un nodo

Después de saber qué nodos de un grupo de nodos de usuario único están programados para mantenimiento, puedes realizar una de las siguientes acciones:

  • Activar el mantenimiento de inmediato Si eliges activar el mantenimiento de inmediato, el mantenimiento se realiza en un plazo de 6 horas desde el momento en que activas la solicitud.

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

Si no activas el mantenimiento de inmediato ni lo programas para una fecha y hora posteriores, el mantenimiento se produce dentro del período de mantenimiento inicial. Una vez que comienza el mantenimiento de un nodo, no puedes pausarlo ni reprogramarlo.

Console

Para activar el mantenimiento de un nodo de inmediato, haz lo siguiente:

  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 Grupos de nodos.

  3. Haz clic en el nombre del grupo de nodos para abrir la página de detalles.

  4. Selecciona el nodo para el que deseas activar el mantenimiento de inmediato y haz clic en Comenzar ahora.

Verás un mensaje de confirmación y el mantenimiento se realizará en un plazo de 6 horas desde el momento en que activas la solicitud.

A fin de programar el mantenimiento de un nodo, haz lo siguiente:

  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 Grupos de nodos para ver una lista de grupos de nodos de usuario único.

  3. Haz clic en el Nombre del grupo de nodos para abrir la página de detalles.

  4. Selecciona el nodo para el que deseas programar el mantenimiento y haz clic en Programar mantenimiento.

  5. En el panel Programar mantenimiento que se muestra, selecciona una fecha y una hora para tu mantenimiento. Ten en cuenta que puedes programar el mantenimiento de un nodo en cualquier momento antes de la hora de inicio del período de mantenimiento inicial.

Verás un mensaje de confirmación y el mantenimiento se realizará en el plazo de 6 horas posteriores a la activación de la solicitud.

gcloud

Usa el comando gcloud compute sole-tenancy node-groups perform-maintenance para iniciar o programar el mantenimiento de un nodo de usuario único M2.

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

Reemplaza lo siguiente:

  • NODE_GROUP_NAME: Es el nombre del grupo de nodos

  • NODE_GROUP_ZONE: Es la zona del grupo de nodos

  • NODE_NAMES: Es el nombre del nodo para el que deseas realizar mantenimiento.

  • WINDOW_START_TIME: Es la fecha y la hora de inicio del mantenimiento. Si deseas que el mantenimiento comience lo antes posible, omite esta marca.

REST

Usa el método nodeGroups.performMaintenance para iniciar o programar el mantenimiento de un nodo de usuario único M2.

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
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el nombre del proyecto en el que existe el grupo de nodos

  • NODE_GROUP_ZONE: Es la zona del grupo de nodos

  • NODE_GROUP_ID: Es el ID del grupo de nodos

  • NODE_NAMES: Es el nombre del nodo para el que deseas realizar mantenimiento.

  • WINDOW_START_TIME: Es la fecha y la hora de inicio del mantenimiento. Omite este campo si deseas que el mantenimiento comience lo antes posible.

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 se inició, pero está programada.
  • En curso: Se inició el período de mantenimiento. El evento de mantenimiento permanece En curso hasta que el mantenimiento se complete de forma correcta para el nodo.

Comprueba si se completó el mantenimiento

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

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

  • El mantenimiento se realizó de forma correcta: Si el mantenimiento de un nodo de usuario único se realiza de forma correcta, se quita la notificación de mantenimiento. Cuando consultas el nombre del grupo de nodos, la sección upcomingMaintenance no estará presente para el nodo.
  • Falló el mantenimiento: Si el mantenimiento no se completa en el período de 6 horas, el evento de mantenimiento permanece como En curso hasta que se completa correctamente el mantenimiento del nodo. Cuando se completa de forma correcta, se quita la notificación de mantenimiento.

A veces, es posible que se rechace la solicitud de activador de mantenimiento para la fecha y hora de tu elección si los límites internos de Google Cloud en el control de mantenimiento avanzado de nodos de usuario único se excedieron para la fecha y hora especificadas. En este caso, debes seleccionar otra fecha y hora para el mantenimiento del nodo. El Estado de mantenimiento de este nodo es En curso y permanece así hasta que el mantenimiento se complete de forma correcta.

Cambia la fecha y hora de mantenimiento programado

Puedes modificar la fecha y la hora de mantenimiento programado de un nodo de usuario único con el mismo procedimiento que usas para activar o programar el mantenimiento de un nodo.