Gerenciar instâncias do Google Cloud Managed Lustre

Depois de criar uma instância, o Google Cloud Managed Lustre permite listar, receber, atualizar e excluir instâncias.

Estados de instância

Uma instância do Managed Lustre pode estar em qualquer um dos seguintes estados:

Estado Descrição
CREATING A instância está sendo criada e ainda não está pronta para uso.
ACTIVE A instância está disponível para uso.
REPAIRING A instância está sendo reparada.
MAINTENANCE ou UPGRADING A instância está em manutenção. Consulte Eventos e políticas de manutenção para mais informações.
SUSPENDED A instância foi suspensa, geralmente devido a um problema com uma chave de criptografia gerenciada pelo cliente (CMEK).
DELETING A instância está sendo excluída.

Listar instâncias

Para listar todas as instâncias em um projeto:

Console do Google Cloud

  1. Acesse a página Managed Lustre no console do Google Cloud .

    Acessar o Managed Lustre

    As instâncias do seu projeto são listadas.

CLI da gcloud

Use o comando gcloud lustre instances list:

gcloud lustre instances list --location=LOCATION

Substitua LOCATION por uma zona específica para listar todas as instâncias nesse local. Para ver projetos em todos os locais, insira - como o valor. Exemplo:

gcloud lustre instances list --location=-

REST

Para listar instâncias usando a API REST, envie uma solicitação para o seguinte endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Em que os seguintes valores precisam ser especificados:

  • PROJECT_ID é o ID do projeto Google Cloud .

  • ZONE é a zona em que todas as instâncias serão listadas. Para listar instâncias de todas as zonas, use - como o valor.

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

Acessar uma instância

Para conferir os detalhes de uma instância:

Console do Google Cloud

  1. Acesse a página Managed Lustre no console do Google Cloud .

    Acessar o Managed Lustre

  2. Clique no nome da instância para ver detalhes sobre uma instância específica.

CLI da gcloud

Use o comando gcloud lustre instances describe:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Para receber detalhes sobre uma instância específica usando a API REST, envie uma solicitação para o seguinte endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Em que os seguintes valores precisam ser especificados:

  • PROJECT_ID é o ID do projeto Google Cloud .

  • ZONE precisa ser uma Google Cloud zona válida compatível com o Managed Lustre. Consulte Locais disponíveis para conferir uma lista completa.

  • INSTANCE_NAME é o nome da instância do Managed Lustre a ser retornada.

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

Atualizar uma instância

É possível atualizar as seguintes propriedades de uma instância:

  • Descrição
  • Rótulos
  • Capacidade de armazenamento
  • Política de manutenção

Para saber como aumentar a capacidade de armazenamento de uma instância, consulte Aumentar a capacidade de uma instância.

Para informações sobre como configurar políticas de manutenção, consulte Eventos e políticas de manutenção.

Para atualizar uma instância:

Console do Google Cloud

  1. Acesse a página Managed Lustre no console do Google Cloud .

    Acessar o Managed Lustre

  2. Clique no Nome da instância da instância que você quer atualizar. A página de visão geral da instância é exibida.

  3. Clique em Editar.

  4. Insira os novos valores.

  5. Clique em Enviar.

CLI da gcloud

Use o comando gcloud lustre instances update:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION \
  --maintenance-policy-weekly-windows=dayOfWeek=DAY,startTime={START_TIME}

Em que:

  • INSTANCE_NAME é a instância a ser atualizada.
  • LOCATION é a zona em que a instância reside.
  • NEW_CAPACITY é a nova capacidade de armazenamento para essa instância em gibibytes (GiB). O valor não pode exceder a capacidade máxima permitida e precisa ser um múltiplo da taxa de incremento. Consulte Aumentar a capacidade de uma instância para mais detalhes.

  • NEW_DESCRIPTION é um novo valor para o campo de descrição, que substitui qualquer descrição atual.

  • DAY: o dia da semana da janela de manutenção (por exemplo, TUESDAY).

  • START_TIME: o horário de início UTC da janela de manutenção no formato de dicionário (por exemplo, {hours=1,minutes=0}).

Para atualizar rótulos, consulte os comandos disponíveis na documentação de gcloud lustre instances update.

REST

Para atualizar uma instância usando a API REST, envie uma solicitação PATCH ao endpoint específico dela:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  },
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}

Em que os seguintes valores precisam ser especificados:

  • PROJECT_ID é o ID do projeto Google Cloud .
  • ZONE é a Google Cloud zona da instância.
  • INSTANCE_NAME é o nome da instância do Managed Lustre a ser atualizada.
  • UPDATE_MASK é uma lista separada por vírgulas de campos a serem atualizados. Um campo só será substituído se estiver na máscara.

O corpo da solicitação precisa conter um ou mais dos seguintes campos:

  • capacityGiB é a nova capacidade de armazenamento para essa instância em gibibytes (GiB). O valor não pode exceder a capacidade máxima permitida e precisa ser um múltiplo da taxa de incremento. Consulte Aumentar a capacidade de uma instância para mais detalhes.
  • description é a nova descrição da instância.
  • labels é o novo conjunto de rótulos para esta instância. O valor de labels é um objeto JSON que contém um ou mais pares chave:valor.
  • maintenancePolicy é a política de manutenção da instância. Consulte Eventos e políticas de manutenção para mais detalhes.

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

Não foi possível enfileirar a operação

Se você encontrar um erro semelhante ao seguinte ao tentar atualizar uma instância:

ERROR: (gcloud.lustre.instances.update) ABORTED: unable to queue the operation

Esse erro ocorre quando você tenta iniciar uma operação enquanto outra operação do mesmo tipo já está em andamento na mesma instância. O Managed Lustre permite uma atualização ativa por instância por vez e permite que outra operação de atualização seja enfileirada.

Para resolver esse problema, aguarde a conclusão da operação atual antes de iniciar uma nova.

Excluir uma instância

Para excluir uma instância:

Console do Google Cloud

  1. Acesse a página Managed Lustre no console do Google Cloud .

    Acessar o Managed Lustre

  2. Selecione o menu de três pontos ao lado da instância que você quer excluir.

  3. Selecione Excluir instância. Confirme a exclusão clicando em Excluir novamente.

CLI da gcloud

Use o comando gcloud lustre instances delete:

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Será preciso confirmar a exclusão. Digite Y ou pressione Enter para continuar.

REST

Para excluir uma instância usando a API REST, envie uma solicitação para o seguinte endpoint:

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Em que os seguintes valores precisam ser especificados:

  • PROJECT_ID é o ID do projeto Google Cloud .

  • ZONE é a Google Cloud zona em que a instância está localizada.

  • INSTANCE_NAME é o nome da instância do Managed Lustre a ser excluída.

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

As solicitações de exclusão são de longa duração e retornam um ID de operação que pode ser consultado para verificar o status da operação. Consulte a referência operations.get para mais detalhes.