Realizar manutenção de autoatendimento

A manutenção de autoatendimento permite aplicar upgrades de manutenção às instâncias do Managed Lustre sob demanda.

Quando o Managed Lustre lança uma nova versão do software, ela fica disponível imediatamente para manutenção de autoatendimento. Isso geralmente ocorre várias semanas antes de a manutenção automatizada chegar à sua instância.

É possível realizar a manutenção de autoatendimento a qualquer momento, desde que uma versão esteja disponível. Se a instância tiver uma política de manutenção, será possível realizar a manutenção de autoatendimento até uma hora antes de uma janela de manutenção programada.

Para uma visão geral do impacto e das políticas de manutenção, consulte Visão geral da manutenção.

Verificar as versões de manutenção disponíveis

As instâncias do Managed Lustre rastreiam as versões de manutenção usando os seguintes campos 'Version':

  • effectiveVersion: somente saída. A versão de lançamento do software em execução na instância. Por exemplo, Lustre_20260516.00_p00.
  • availableVersion: somente saída. Uma versão de lançamento de software mais recente e qualificada para a qual sua instância pode fazer upgrade. Se esse campo estiver vazio, sua instância já está executando a versão mais recente disponível.
  • targetVersion: somente entrada. O parâmetro especificado em uma solicitação de atualização para iniciar um upgrade para uma versão candidata ou para latest.

Para verificar a versão atual da instância e se há um upgrade disponível:

Console do Google Cloud

  1. No console do Google Cloud , acesse a página Managed Lustre:

    Acessar o Managed Lustre

  2. Na lista de instâncias, localize a sua. Se uma versão de manutenção mais recente estiver disponível, um selo Atualização disponível vai aparecer ao lado do status ACTIVE.

  3. Clique no nome da instância para abrir a página Detalhes da instância e ver a string de versão disponível.

CLI da gcloud

Execute o comando gcloud lustre instances describe com um filtro de formato:

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

Substitua:

  • INSTANCE_ID: o ID da instância do Managed Lustre.
  • LOCATION: a zona em que a instância está localizada.

Se uma versão mais recente estiver disponível, a saída será semelhante a esta:

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

Se availableVersion estiver vazio, sua instância já está executando a versão mais recente disponível.

REST

Para verificar os detalhes da versão de uma instância, envie uma solicitação GET para o endpoint da instância:

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

Em que:

  • PROJECT_ID é o ID do projeto do Google Cloud .
  • LOCATION é a zona em que a instância reside.
  • INSTANCE_ID é o ID da instância do Managed Lustre.

Se uma versão mais recente estiver disponível, a resposta vai conter effectiveVersion e availableVersion:

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

Se availableVersion for omitido ou estiver vazio, sua instância já estará executando a versão mais recente disponível.

Consulte a referência da API instances.get para mais detalhes.

Fazer um upgrade de autoatendimento

Para fazer upgrade da instância para uma versão de software disponível:

CLI da gcloud

Execute o comando gcloud lustre instances update com a flag --target-version:

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

Substitua:

  • INSTANCE_ID: o ID da instância do Managed Lustre.
  • LOCATION: a zona em que a instância está localizada.

Para fazer upgrade para uma versão de lançamento qualificada específica em vez de latest, transmita a string de versão:

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

Substitua TARGET_VERSION pela string de versão de availableVersion. Por exemplo, Lustre_20260716.01_p00.

REST

Para fazer upgrade de uma instância usando a API REST, envie uma solicitação PATCH ao endpoint da instância, especificando targetVersion no 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"
}

Em que:

  • PROJECT_ID é o ID do projeto do Google Cloud .
  • LOCATION é a zona em que a instância reside.
  • INSTANCE_ID é o ID da instância do Managed Lustre.

Para fazer upgrade para uma versão de lançamento qualificada específica em vez de latest, especifique a string de versão no corpo da solicitação, como "targetVersion": "Lustre_20260716.01_p00".

Consulte a referência da API instances.patch para mais detalhes.

Acompanhar o progresso da manutenção

O upgrade é executado como uma operação assíncrona de longa duração. A manutenção de autoatendimento não aciona e-mails de notificação automatizados.

Para acompanhar o progresso em tempo real:

CLI da gcloud

Consulte o status da operação usando o comando gcloud lustre operations describe:

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

Substitua:

  • OPERATION_ID: o ID da operação retornado pelo comando de atualização.
  • LOCATION: a zona em que a instância está localizada.

O estado da instância exibe UPGRADING enquanto o upgrade está em andamento e retorna para ACTIVE quando ele é concluído.

REST

Envie uma solicitação GET para o endpoint operations.get:

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

Em que:

  • PROJECT_ID é o ID do projeto do Google Cloud .
  • LOCATION é a zona em que a instância reside.
  • OPERATION_ID é o ID da operação retornado pela solicitação de atualização.

Consulte a referência da API operations.get para mais detalhes.

Quando o upgrade for concluído:

  1. A instância retorna ao estado ACTIVE.
  2. effectiveVersion reflete a string de versão recém-aplicada.
  3. availableVersion é limpo e omitido das respostas da API.

Interação com a manutenção programada

Se a instância tiver uma manutenção programada, a conclusão de um upgrade de autoatendimento cancelará automaticamente essa manutenção. Se você se inscreveu para receber notificações de manutenção, vai receber uma notificação automática por e-mail de Manutenção cancelada.

Se um upgrade de autoatendimento falhar, a janela de manutenção programada pendente não será cancelada. A instância retorna ao estado ACTIVE na versão atual, e a janela de manutenção programada é mantida.

Não é possível acionar um upgrade de autoatendimento até uma hora antes de uma janela de manutenção programada. Tentar iniciar um upgrade durante esse período retorna um erro 409 CONFLICT para evitar sobreposição com a próxima manutenção programada.

Mensagens de erro

Os possíveis erros de manutenção de autoatendimento incluem:

  • Instance is already running version "<CURRENT>": ocorre se você tentar fazer upgrade para a versão do software que já está em execução na instância.
  • Downgrading to a lower version is not supported.: ocorre se você tentar fazer downgrade para uma versão anterior do software.
  • Version "<TARGET>" is not a valid update version.: ocorre se a versão especificada não corresponder à string availableVersion ou latest da instância.
  • Instance must be in ACTIVE state to update version: ocorre se um upgrade é iniciado enquanto a instância não está no estado ACTIVE.
  • Cannot trigger self-service update within 1 hour of a scheduled maintenance window: ocorre se um upgrade de autoatendimento for iniciado menos de uma hora antes de uma janela de manutenção programada.