El control de mantenimiento avanzado para inquilinos únicos le permite controlar los eventos de mantenimiento planificados para grupos de nodos de inquilinos únicos y minimizar las interrupciones relacionadas con el mantenimiento. Esta función solo está disponible para grupos de nodos de inquilino único. Para utilizar esta función con sus máquinas virtuales existentes, primero debe mover sus máquinas virtuales a grupos de nodos de inquilino único que tengan habilitado el control de mantenimiento avanzado.
La función de control de mantenimiento avanzado para propietarios únicos le permite:
- Verifique los eventos de mantenimiento programados para un nodo de único inquilino con 28 días de anticipación.
- Active el mantenimiento inmediatamente o prográmelo para más tarde. Tenga en cuenta que si activa el mantenimiento inmediatamente, el mantenimiento se realizará dentro de las 6 horas posteriores al momento en que activa la solicitud.
El siguiente es el proceso para crear un grupo de nodos de único inquilino con control de mantenimiento avanzado:
Opte por el control de mantenimiento avanzado en grupos de nodos de arrendamiento único compatibles. Esta función solo está disponible para grupos de nodos de inquilino único. Para utilizar esta característica con sus máquinas virtuales existentes o cargas de trabajo de inquilino único, primero debe mover sus máquinas virtuales a grupos de nodos de inquilino único con el control de mantenimiento avanzado habilitado.
Verifique el próximo mantenimiento de sus nodos de único inquilino. El mantenimiento de un nodo de único inquilino se realiza como máximo cada 28 días. Puede verificar el evento de mantenimiento de un nodo 28 días antes del inicio de la ventana de mantenimiento de 6 horas en la que está programado que se realice el mantenimiento para ese nodo.
Si el mantenimiento está programado para un nodo de único inquilino y antes de que comience el período de mantenimiento programado, puede:
Active el mantenimiento inmediatamente o prográmelo para más tarde . Si elige activar el mantenimiento inmediatamente, el mantenimiento se realizará dentro de las 6 horas siguientes al momento en que activa la solicitud. Tenga en cuenta que la fecha y hora programadas que elija deben ser anteriores a la hora de inicio del período de mantenimiento inicial.
Si no activa el mantenimiento inmediatamente ni lo programa para más tarde, el mantenimiento se realiza dentro del tiempo previsto en la ventana de mantenimiento inicial.
Puede optar por escalar automáticamente grupos de nodos de único inquilino con el control de mantenimiento avanzado habilitado. En todos los casos se generan registros de auditoría.
Familias de máquinas soportadas
El control de mantenimiento avanzado para nodos de único inquilino es compatible con las familias de máquinas C2, C3, C3D, C4, G2, H3, M1, M2 y M3 en disponibilidad general .
Limitaciones
Las siguientes son las limitaciones de la función de control de mantenimiento avanzado para inquilino único:
- SSD y GPU locales: esta función no admite SSD y GPU locales.
- 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 el lugar y migrar dentro del grupo de nodos.
- Nodos: esta función puede admitir un máximo de 20 nodos por proyecto, por zona.
- Control de mantenimiento avanzado para grupos de nodos de único inquilino existentes: no puede habilitar grupos de nodos de único inquilino existentes para el control de mantenimiento avanzado. Si desea ejecutar sus cargas de trabajo existentes en grupos de nodos de inquilino único con el control de mantenimiento avanzado habilitado, primero debe crear un nuevo grupo de nodos con el control de mantenimiento avanzado habilitado y luego migrar su carga de trabajo a este grupo. De manera similar, para optar por no participar en el control de mantenimiento avanzado, debe migrar sus nodos de único inquilino a grupos de nodos de único inquilino que no tengan el control de mantenimiento avanzado habilitado.
- Impacto en las políticas de mantenimiento actuales: cuando opta por esta función, anula cualquier ventana de mantenimiento existente asociada con los nodos de único inquilino.
Costos
No hay ningún costo adicional por utilizar el control de mantenimiento avanzado en nodos de único inquilino.
Antes de comenzar
- Antes de aprovisionar máquinas virtuales en un nodo de inquilino único, verifique su cuota . Dependiendo de la cantidad y el tamaño de los nodos que reserve, es posible que deba solicitar una cuota adicional .
- Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. 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
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
NODE_GROUP_NAME
: el nombre del grupo de nodos.NODE_TEMPLATE_NAME
: el nombre de la plantilla de nodo que se utilizará para crear este grupo.NODE_GROUP_SIZE
: la cantidad de nodos a crear en el grupo.NODE_GROUP_ZONE
: la zona en la que crear el grupo de nodos. Debe ser la misma región que la plantilla de nodo en la que basa el grupo de nodos.PROJECT_ID
: el nombre del proyecto en el que existe el grupo de nodos.NODE_GROUP_ZONE
: la zona del grupo de nodos.NODE_GROUP_NAME
: el nombre del grupo de nodos.NODE_TEMPLATE_URL
: la URL de la plantilla de nodo que se utilizará para crear este grupo.NODE_GROUP_SIZE
: la cantidad de nodos a crear en el grupo.En la consola de Google Cloud, vaya a la página Nodos de único inquilino .
Haga clic en Grupos de nodos para ver una lista de grupos de nodos de único inquilino.
Para cualquier grupo de nodos de inquilino único, puede ver las columnas Estado de mantenimiento y Tiempo de mantenimiento en la tabla para el próximo mantenimiento. Como el mantenimiento se establece a nivel de nodo, la información de mantenimiento que ve aquí es el próximo mantenimiento programado para cualquiera de los nodos dentro del grupo de nodos.
Para ver información de mantenimiento para cada nodo en un grupo de nodos de único inquilino, haga 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 Tiempo de mantenimiento de la tabla muestran información sobre el próximo mantenimiento.
PROJECT_ID
: el nombre del proyecto en el que existe el grupo de nodos.NODE_GROUP_ZONE
: la zona del grupo de nodos.NODE_GROUP_ID
: el ID del grupo de nodos.Activar el mantenimiento inmediatamente. Si elige activar el mantenimiento inmediatamente, el mantenimiento se realizará dentro de las 6 horas siguientes al momento en que activa la solicitud.
Programe el mantenimiento para más adelante según sus necesidades.
En la consola de Google Cloud, vaya a la página Nodos de único inquilino .
Haga clic en Grupos de nodos .
Haga clic en el nombre del grupo de nodos para abrir la página de detalles.
Seleccione el nodo para el que desea activar el mantenimiento inmediatamente y haga clic en Iniciar ahora .
En la consola de Google Cloud, vaya a la página Nodos de único inquilino .
Haga clic en Grupos de nodos para ver una lista de grupos de nodos de único inquilino.
Haga clic en el Nombre del grupo de nodos para abrir la página de detalles.
Seleccione el nodo para el que desea programar el mantenimiento y haga clic en Programar mantenimiento .
En el panel Programar mantenimiento que se muestra, seleccione una fecha y hora de su elección para el mantenimiento. Tenga en cuenta que puede programar el mantenimiento de un nodo en cualquier momento antes de la hora de inicio de la ventana de mantenimiento inicial.
NODE_GROUP_NAME
: el nombre del grupo de nodos.NODE_GROUP_ZONE
: la zona del grupo de nodos.NODE_NAMES
: el nombre del nodo cuyo mantenimiento desea realizar.WINDOW_START_TIME
: fecha y hora de inicio del mantenimiento. Si desea que el mantenimiento comience lo antes posible, omita esta bandera.PROJECT_ID
: el nombre del proyecto en el que existe el grupo de nodos.NODE_GROUP_ZONE
: la zona del grupo de nodos.NODE_GROUP_ID
: el ID del grupo de nodos.NODE_NAMES
: el nombre del nodo cuyo mantenimiento desea realizar.WINDOW_START_TIME
: fecha y hora de inicio del mantenimiento. Omita este campo si desea que el mantenimiento comience lo antes posible.- Pendiente: La operación de mantenimiento aún no ha iniciado, pero está programada.
- En curso : la ventana de mantenimiento ha comenzado. El evento de mantenimiento permanece en curso hasta que el mantenimiento se complete exitosamente para el nodo.
- El mantenimiento es exitoso: si el mantenimiento de un nodo de inquilino único es exitoso, se elimina la notificación de mantenimiento. Cuando consulta el nombre del grupo de nodos, la
upcomingMaintenance
sección Mantenimiento ya no estará presente para el nodo. - El mantenimiento ha fallado: si el mantenimiento no se completa en el período de 6 horas, el evento de mantenimiento permanece en curso hasta que el mantenimiento se complete exitosamente para el nodo. Una vez completado con éxito, se elimina la notificación de mantenimiento.
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.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .
Habilite el control de mantenimiento avanzado en un nodo de único inquilino
El control de mantenimiento avanzado para inquilinos únicos es una característica opcional y está disponible solo para grupos de nodos de inquilinos únicos. Para utilizar esta característica con sus máquinas virtuales existentes o cargas de trabajo de inquilino único, primero debe mover sus máquinas virtuales a grupos de nodos de inquilino único con el control de mantenimiento avanzado habilitado.
Consola
Puede optar por el control de mantenimiento avanzado cuando crea un grupo de nodos seleccionando la opción Optar por el mantenimiento avanzado de inquilino único en la sección Configurar ajustes de mantenimiento . Para obtener más información, consulte Crear un grupo de nodos de inquilino único .
nube de gcloud
Para crear un grupo de nodos de inquilino único con control de mantenimiento avanzado, usa el comando
gcloud compute sole-tenancy node-groups create
.El indicador
--maintenance-interval=RECURRENT
en el siguiente comando especifica que el nodo de único inquilino 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
Reemplace lo siguiente:
DESCANSAR
Para crear un grupo de nodos de único inquilino con control de mantenimiento avanzado basado en una plantilla de nodo creada previamente, utilice el método
nodeGroups.insert
.Para crear un grupo de nodos de único inquilino basado en una plantilla de nodo creada previamente para todos los demás nodos, utilice el método
nodeGroups.insert
.El parámetro
maintenanceInterval
en el siguiente comando especifica que el nodo de único inquilino 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" }
Reemplace lo siguiente:
El indicador de nivel de nodo anula cualquier indicador de VM asignado previamente. Por lo tanto, optar por el control de mantenimiento avanzado anula cualquier indicador de mantenimiento anterior.
Consultar próximos mantenimientos
El mantenimiento de un nodo de único inquilino se realiza como máximo cada 28 días. Puede verificar el evento de mantenimiento de un nodo 28 días antes del inicio de la ventana de mantenimiento de 6 horas, en la que está programado que se realice el mantenimiento para ese nodo.
Consola
Después de habilitar un grupo de nodos de inquilino único para el control de mantenimiento avanzado, verá los próximos eventos de mantenimiento de la siguiente manera:
nube de gcloud
Para enumerar los nodos de un grupo de nodos de inquilino único con control de mantenimiento avanzado junto con su 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)"
Reemplace
NODE_GROUP_NAME
con el nombre del grupo de nodos.DESCANSAR
Para enumerar los nodos de un grupo de nodos de único inquilino con control de mantenimiento avanzado junto con su información de mantenimiento, utilice el método
nodeGroups.listNodes
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/listNodes
Reemplace lo siguiente:
La siguiente es 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 }, … }, … ], … }
Los siguientes son los detalles del evento de mantenimiento para el grupo de nodos:
Nombre del parámetro Descripción windowStartTime
Hora de inicio de la ventana de mantenimiento. windowEndTime
Hora de finalización de la ventana de mantenimiento. latestWindowStartTime
Hora de inicio de la ventana de mantenimiento inicial. Puede optar por activar el mantenimiento inmediatamente o programarlo para una fecha y hora posteriores solo antes del latestWindowStartTime
.maintenanceType
El tipo de mantenimiento que se realizará:
- Programado : el mantenimiento está programado para este nodo.
- No programado : el mantenimiento representa actualizaciones críticas para las cuales se avisa con mucha menos antelación.canReschedule
Si el mantenimiento se puede reprogramar. maintenanceStatus
Estado de la operación de mantenimiento actual:
- Pendiente : La operación de mantenimiento aún no ha comenzado, pero está programada.
- En curso : la ventana de mantenimiento ha comenzado.Si no ve ningún evento de mantenimiento, significa que no hay mantenimiento próximo para ningún nodo del grupo de nodos.
Activar el mantenimiento inmediatamente o programar el mantenimiento de un nodo
Una vez que sepa qué nodos de un grupo de nodos de único inquilino están programados para mantenimiento, puede realizar una de las siguientes acciones:
Si no activa el mantenimiento inmediatamente ni lo programa para una fecha y hora posteriores, el mantenimiento se produce dentro de la ventana de mantenimiento inicial. Una vez que comienza el mantenimiento de un nodo, no puede pausarlo ni reprogramarlo.
Consola
Para activar el mantenimiento de un nodo inmediatamente , haga lo siguiente:
Verá un mensaje de confirmación y el mantenimiento se realizará dentro de las 6 horas posteriores al momento en que active la solicitud.
Para programar el mantenimiento de un nodo , haga lo siguiente:
Verá un mensaje de confirmación y el mantenimiento se realizará dentro de las 6 horas siguientes al momento de activar la solicitud.
nube de gcloud
Para iniciar o programar el mantenimiento de un nodo de inquilino único con control de mantenimiento avanzado, usa el comando
gcloud compute sole-tenancy node-groups perform-maintenance
.gcloud compute sole-tenancy node-groups perform-maintenance NODE_GROUP_NAME \ --zone=NODE_GROUP_ZONE \ --nodes=NODE_NAMES \ --window-start-time=WINDOW_START_TIME
Reemplace lo siguiente:
DESCANSAR
Utilice el método
nodeGroups.performMaintenance
para iniciar o programar el mantenimiento de un nodo de único inquilino con control de mantenimiento avanzado.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 }
Reemplace lo siguiente:
El campo Estado de mantenimiento de un nodo muestra el siguiente estado durante el proceso de mantenimiento:
Compruebe si el mantenimiento está completo.
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étodonodeGroups.listNodes
.Para obtener más información, consulte consultar el estado de mantenimiento .
A veces, la solicitud de activación de mantenimiento para la fecha y hora de su elección puede ser rechazada si Google Cloud Se han excedido los límites internos sobre el control de mantenimiento avanzado para nodos de arrendamiento único para la fecha y hora especificadas. En este caso deberás 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 exitosamente.
Cambiar la fecha y hora del mantenimiento programado
Puede modificar la fecha y hora del mantenimiento programado para un nodo de arrendamiento único utilizando el mismo procedimiento que utiliza para activar o programar el mantenimiento de un nodo .
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-04-17 (UTC).
-