Realiza el mantenimiento de autoservicio

El mantenimiento de autoservicio te permite aplicar actualizaciones de mantenimiento a tus instancias de Managed Lustre según demanda.

Cuando Managed Lustre lanza una nueva versión de software, esta se encuentra disponible de inmediato para el mantenimiento de autoservicio. Por lo general, esto ocurre varias semanas antes de que el mantenimiento automatizado llegue a tu instancia.

Puedes realizar el mantenimiento de autoservicio en cualquier momento una vez que haya una versión disponible. Si tu instancia tiene una política de mantenimiento, puedes realizar el mantenimiento de autoservicio hasta 1 hora antes de un período de mantenimiento programado.

Para obtener una descripción general del impacto y las políticas de mantenimiento, consulta Descripción general del mantenimiento.

Verifica las versiones de mantenimiento disponibles

Las instancias de Managed Lustre realizan un seguimiento de las versiones de mantenimiento con los siguientes campos de versión:

  • effectiveVersion: Solo salida. Es la versión de actualización de software que se ejecuta en tu instancia. Por ejemplo, Lustre_20260516.00_p00
  • availableVersion: Solo salida. Es una versión de actualización de software más reciente y calificada a la que tu instancia puede actualizarse. Si este campo está vacío, tu instancia ya ejecuta la versión más reciente disponible.
  • targetVersion: Solo entrada. Es el parámetro que se especifica en una solicitud de actualización para iniciar una actualización a una versión candidata o a latest.

Para verificar la versión actual de tu instancia y comprobar si hay una actualización disponible, sigue estos pasos:

Consola de Google Cloud

  1. En la consola de Google Cloud , ve a la página Managed Lustre:

    Ir a Managed Lustre

  2. En la lista de instancias, busca la tuya. Si hay una versión de mantenimiento más reciente disponible, aparecerá una insignia de Actualización disponible junto al estado ACTIVE.

  3. Haz clic en el nombre de la instancia para abrir la página Detalles de la instancia y ver la cadena de versión disponible.

gcloud CLI

Ejecuta el comando gcloud lustre instances describe con un filtro de formato:

gcloud lustre instances describe INSTANCE_ID \
  --location=LOCATION \
  --format="yaml(effectiveVersion, availableVersion, state)"

Reemplaza lo siguiente:

  • INSTANCE_ID: Es el ID de tu instancia de Managed Lustre.
  • LOCATION: La zona en la que se encuentra la instancia.

Si hay una versión más reciente disponible, el resultado será similar al siguiente:

availableVersion: Lustre_20260716.01_p00
effectiveVersion: Lustre_20260516.00_p00
state: ACTIVE

Si availableVersion está vacío, tu instancia ya ejecuta la versión más reciente disponible.

REST

Para verificar los detalles de la versión de una instancia, envía una solicitud GET al extremo de la instancia:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID
Authorization: Bearer ACCESS_TOKEN

Aquí:

  • PROJECT_ID es el ID del proyecto de Google Cloud .
  • LOCATION es la zona en la que reside la instancia.
  • INSTANCE_ID es el ID de la instancia de Managed Lustre.

Si hay una versión más reciente disponible, la respuesta contiene effectiveVersion y availableVersion:

{
  "name": "projects/my-project/locations/us-central1-a/instances/my-instance",
  "state": "ACTIVE",
  "effectiveVersion": "Lustre_20260516.00_p00",
  "availableVersion": "Lustre_20260716.01_p00"
}

Si se omite availableVersion o está vacío, tu instancia ya ejecuta la versión más reciente disponible.

Consulta la referencia de la API de instances.get para obtener más detalles.

Realiza una actualización de autoservicio

Para actualizar tu instancia a una versión de software disponible, sigue estos pasos:

gcloud CLI

Ejecuta el comando gcloud lustre instances update con la marca --target-version:

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=latest

Reemplaza lo siguiente:

  • INSTANCE_ID: Es el ID de tu instancia de Managed Lustre.
  • LOCATION: La zona en la que se encuentra la instancia.

Para actualizar a una versión de actualización calificada específica en lugar de latest, pasa la cadena de versión:

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=TARGET_VERSION

Reemplaza TARGET_VERSION por la cadena de versión de availableVersion. Por ejemplo, Lustre_20260716.01_p00.

REST

Para actualizar una instancia con la API de REST, envía una solicitud PATCH al extremo de la instancia y especifica targetVersion en el parámetro de consulta updateMask:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=targetVersion
Authorization: Bearer ACCESS_TOKEN

{
  "targetVersion": "latest"
}

Aquí:

  • PROJECT_ID es el ID del proyecto de Google Cloud .
  • LOCATION es la zona en la que reside la instancia.
  • INSTANCE_ID es el ID de la instancia de Managed Lustre.

Para actualizar a una versión de actualización calificada específica en lugar de latest, especifica la cadena de versión en el cuerpo de la solicitud, como "targetVersion": "Lustre_20260716.01_p00".

Consulta la referencia de la API de instances.patch para obtener más detalles.

Cómo hacer un seguimiento del progreso del mantenimiento

La actualización se ejecuta como una operación asíncrona de larga duración. El mantenimiento de autoservicio no activa las notificaciones automáticas por correo electrónico.

Para hacer un seguimiento del progreso en tiempo real, sigue estos pasos:

gcloud CLI

Sondea el estado de la operación con el comando gcloud lustre operations describe:

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

Reemplaza lo siguiente:

  • OPERATION_ID: Es el ID de la operación que devuelve el comando de actualización.
  • LOCATION: La zona en la que se encuentra la instancia.

El estado de la instancia muestra UPGRADING mientras la actualización está en curso y vuelve a ACTIVE una vez que se completa.

REST

Envía una solicitud GET al extremo operations.get:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
Authorization: Bearer ACCESS_TOKEN

Aquí:

  • PROJECT_ID es el ID del proyecto de Google Cloud .
  • LOCATION es la zona en la que reside la instancia.
  • OPERATION_ID es el ID de la operación que devuelve la solicitud de actualización.

Consulta la referencia de la API de operations.get para obtener más detalles.

Cuando la actualización se complete correctamente, ocurrirá lo siguiente:

  1. La instancia vuelve al estado ACTIVE.
  2. effectiveVersion refleja la cadena de versión aplicada recientemente.
  3. availableVersion se borra y se omite de las respuestas de la API.

Interacción con el mantenimiento programado

Si tu instancia tiene un mantenimiento programado próximo, completar correctamente una actualización de autoservicio cancela de forma automática ese mantenimiento programado próximo. Si estás suscrito a las notificaciones de mantenimiento, recibirás una notificación automática por correo electrónico con el asunto Mantenimiento cancelado.

Si falla una actualización de autoservicio, no se cancela el período de mantenimiento programado pendiente. La instancia vuelve al estado ACTIVE en su versión actual y se conserva el período de mantenimiento programado.

No puedes activar una actualización de autoservicio en un plazo de 1 hora antes de un próximo período de mantenimiento programado. Si intentas iniciar una actualización durante este período, se muestra un error 409 CONFLICT para evitar que se superponga con el próximo mantenimiento programado.

Mensajes de error

Entre los posibles errores de mantenimiento de autoservicio, se incluyen los siguientes:

  • Instance is already running version "<CURRENT>": Se produce si intentas actualizar a la versión de software que ya se ejecuta en la instancia.
  • Downgrading to a lower version is not supported.: Se produce si intentas cambiar a una versión de software anterior.
  • Version "<TARGET>" is not a valid update version.: Ocurre si la versión especificada no coincide con la cadena availableVersion o latest de la instancia.
  • Instance must be in ACTIVE state to update version: Se produce si se inicia una actualización mientras la instancia no está en el estado ACTIVE.
  • Cannot trigger self-service update within 1 hour of a scheduled maintenance window: Se produce si se inicia una actualización de autoservicio menos de 1 hora antes de un próximo período de mantenimiento programado.