Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Manter o ambiente da Solução Bare Metal

Depois que o ambiente da Solução Bare Metal estiver em execução, use as informações incluídas neste guia para manter os servidores, o armazenamento e a rede da Solução Bare Metal.

Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution

A API Solução Bare Metal oferece muitas ferramentas para permitir que você monitore e mantenha o ambiente da solução Bare Metal. Normalmente, você só precisa usar esse procedimento na primeira vez que usar a API Bare Metal Solution. No entanto, reutilize essas instruções conforme necessário para fins de solução de problemas, caso a API não responda como esperado.

  1. Atribua o papel de IAM predefinido do Administrador da Solução Bare Metal ou do Editor da Solução Bare Metal aos principais. Para saber como mapear papéis do IAM, consulte Conceder um papel do IAM.

  2. Ative a API Bare Metal Solution no projeto do Cloud.

    Console

    1. Acesse a API de Solução Bare Metal no painel do Console do Google Cloud. Também é possível pesquisar a API Bare Metal Solution na biblioteca de APIs: APIs e serviços > Biblioteca.
    2. Na página da API Bare Metal Solution, clique em Ativar.
    3. Clique no botão "Voltar" do navegador. Se você vir uma marca de seleção verde ao lado das palavras API ativada, quer dizer que é possível usar a API.

    gcloud

    • Para ativar a API da Solução Bare Metal por meio de gcloud insira o ID do projeto do Google Cloud no comando a seguir, copie o comando, cole-o no prompt do Cloud Shell e pressione Entrar ouou a chave Retornar:

       gcloud services enable baremetalsolution.googleapis.com --project=PROJECT_ID
       

  3. Permita que a Google Cloud CLI funcione com seu projeto do Cloud.

    1. Na janela do Cloud Shell, digite o comando gcloud auth login.
      gcloud auth login
      
    2. Copie o URL resultante e cole-o em outra janela ou guia do navegador.
    3. Faça login na página usando seu nome de usuário associado ao projeto do Cloud.
    4. Clique em Permitir para ativar a CLI gcloud.
    5. Copie o código de autorização.
    6. Cole o código na linha de comando do cliente do Cloud Shell.
    7. Pressione a tecla Enter ou Retornar.

Para mais informações sobre as etapas gerais necessárias para configurar uma API no Google Cloud, consulte Primeiros passos com as APIs do Google Cloud.

Operar o servidor da Solução Bare Metal

É possível executar as seguintes operações no servidor da Solução Bare Metal:

  • Start: ativa o servidor.
  • "Stop": desliga o servidor.
  • Reset: reinicia o servidor.

Console

Para realizar essas operações no seu servidor, siga estas etapas:

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.

  2. No servidor que você quer iniciar, interromper ou redefinir, clique em .

  3. Faça o seguinte:

    • Para ligar o servidor, clique em Iniciar.
    • Para desligar o servidor, clique em Parar.
    • Para reiniciar o servidor, clique em Redefinir.

gcloud

  1. Para desligar a energia e reiniciar o servidor da Solução Bare Metal, siga as etapas abaixo.

    1. Siga as etapas de configuração da API.

      A reinicialização de um servidor requer a ativação da API Solução Bare Metal e da CLI gcloud. Você também precisa conceder o papel de administrador da Solução Bare Metal ou Editor da solução Bare Metal à sua principal. Para concluir as etapas de configuração, consulte Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution.

    2. Para desligar a energia e reiniciar um servidor da Solução Bare Metal, emita o comando gcloud bms instances reset:

      gcloud bms instances reset SERVER_NAME --project=PROJECT_ID --region=REGION
      

      A saída exibe o status da solicitação de reinicialização do servidor.

      Reset request issued for: [SERVER_NAME]

      Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.

      Depois de inserir o comando, o servidor da Solução Bare Metal será reiniciado. Ela pode levar de 15 a 60 minutos para ser concluída, dependendo da configuração do seu servidor.

      A saída desse comando fornece um ID de operações que pode ser usado para verificar o status da reinicialização. Para usar o ID das operações e visualizar o status, consulte Visualizar o status de uma operação de longa duração.

  2. Para ligar o servidor, use o comando gcloud bms instances start.

    gcloud bms instances start SERVER_NAME --project=PROJECT_ID --region=REGION
    

    A saída exibe o status da solicitação de reinicialização do servidor.

    Start request issued for: [SERVER_NAME]

    Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.

    Na maioria dos casos, a energia do servidor permanece ligada. Se você precisar desligar a energia, use as seguintes opções:

    • Use os comandos de desligamento do sistema operacional do seu servidor.
    • Alguns aplicativos desligam a energia do servidor automaticamente após uma nova imagem.
  3. Para desligar o servidor, use o comando gcloud bms instances stop.

    gcloud bms instances stop --project=PROJECT_ID --region=REGION SERVER_NAME
    

API

  1. Para desligar a energia e reiniciar o servidor da Solução Bare Metal, siga as etapas abaixo.

    1. Siga as etapas de configuração da API.

      A reinicialização de um servidor requer a ativação da API Solução Bare Metal e da CLI gcloud. Você também precisa garantir o papel de administrador ou de administrador da solução Bare Metal. Para concluir as etapas de configuração, consulte Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution.

    2. Fazer login no servidor da Solução Bare Metal para ver a reinicialização do servidor.

      • Abra uma janela do console do Google Cloud.
      • Navegue até a instância de VM do jump host: Compute Engine >Instâncias de VM
      • Clique no botão SSH para se conectar à instância de VM do host jump.
      • Para fazer login no servidor da Solução Bare Metal, insira o comando SSH na linha de comando do host de salto.

        [username@instance-jump-host ~]$ ssh customeradmin@bms-ip-address>
        customeradmin@bms-ip-address's password: bms-password
        Last login: Mon Mar 15 22:43:19 2022 from bms-ip-address
        [customeradmin@BMS_SERVER_NAME ~]$
        
      • Digite o comando toptop para verificar se o servidor está em execução. Use essa janela para monitorar o progresso da reinicialização.

    3. Executar o comando de reinicialização

      • Abra a janela do Cloud Shell.
      • Adicione o ID do projeto do Cloud, a região e o nome do servidor da Solução Bare Metal no comando a seguir.

        curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "X-Goog-User-Project: PROJECT_ID" \
        -H "Content-Type: application/json" \
        "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/BMS_SERVER_NAME:reset"
        
      • Copie e cole o comando na janela do Cloud Shell e pressione a tecla Enter ou Retornar.

        O servidor da Solução Bare Metal será reiniciado. Ela pode levar de 15 a 60 minutos para ser concluída, dependendo da configuração do seu servidor.

        A saída desse comando fornece um ID de operações que pode ser usado para verificar o status da reinicialização. Para usar o ID das operações e visualizar o status, consulte Visualizar o status de uma operação de longa duração.

        {
         "name": "operations/5c0c8b3f-5edc-4117-be9f-812af9740aaf"
        }
        

        Enquanto o servidor é reinicializado, não é possível fazer ping ou SSH da instância de VM do jump de salto para acessar o servidor da Solução Bare Metal. Depois de alguns minutos, o servidor da Solução Bare Metal volta a ficar on-line.

        Quando o servidor estiver on-line novamente, é possível emitir um ping ou usar SSH da instância de VM do host de salto para acessar o servidor da Solução Bare Metal.

    Para mais informações sobre como reiniciar o servidor da Solução Bare Metal, consulte a API Bare Metal Solution.

  2. Para ligar o servidor, insira o ID do projeto, a região e o nome do servidor. Em seguida, emita o seguinte comando curl.

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:start"
    

    Na maioria dos casos, a energia do servidor permanece ligada. Se você precisar desligar a energia, use as seguintes opções:

    • Use os comandos de desligamento do sistema operacional do seu servidor.
    • Alguns aplicativos desligam a energia do servidor automaticamente após uma nova imagem.
  3. Para desligar o servidor, insira o ID do projeto, a região e o nome do servidor e emita o comando curl a seguir.

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:stop"
    

Como iniciar, interromper e reiniciar um servidor leva algum tempo, é possível verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Verificar o status de um servidor

Um servidor faz a transição entre vários estados como parte do ciclo de vida. Quando você inicia um servidor, a Solução Bare Metal provisiona os recursos para ele. Em seguida, o servidor se prepara para a sequência de inicialização. Depois que o servidor for iniciado, ele será movido para o estado de execução. Durante a operação normal, é possível interromper e reiniciar um servidor em execução.

Uma servidor pode estar em um dos seguintes estados:

  • Provisionando : os recursos são alocados para o servidor. O servidor ainda não está em execução.
  • A partir de : os recursos serão adquiridos. O servidor está sendo inicializado.
  • Em execução : o servidor está em execução.
  • Parando : o servidor está sendo interrompido.
  • Encerramento de : o servidor foi interrompido e desligado.
  • excluído: o servidor foi excluído.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.

  2. Na coluna Status, veja o status do servidor.

gcloud

Para verificar o status de um servidor, emita o comando gcloud bms instances describe.

gcloud bms instances describe --project=PROJECT_ID --region=REGION SERVER_NAME

É possível ver o status do servidor no campo state na saída. Por exemplo:

state: RUNNING

API

Para verificar o status de um servidor, insira o ID do projeto, a região e o nome do servidor no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

É possível ver o status do servidor no campo state na saída. Por exemplo:

"state" : "RUNNING"

Gerenciar recursos no ambiente da Solução Bare Metal

As APIs de gerenciamento da Solução Bare Metal, os comandos gcloud e o Console do Google Cloud permitem visualizar o status dos recursos no ambiente da Solução Bare Metal, como servidores, rede e armazenamento.

Configure a API Bare Metal Solution

Para ver o status do recurso, você precisa ativar a API Solução Bare Metal e a CLI gcloud. Você também precisa garantir um dos papéis do IAM da Solução Bare Metal aos principais, como Administrador da Solução Bare Metal ou Editor da Solução Bare Metal. Para concluir as etapas de configuração da API antes de gerenciar seus recursos, consulte Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution.

Gerenciar servidores

É possível gerenciar os servidores no ambiente da Solução Bare Metal das seguintes maneiras:

Ver servidores no ambiente da Solução Bare Metal

Ao emitir comandos para chamar as APIs de gerenciamento da Solução Bare Metal, você pode aprender sobre o status dos dispositivos no ambiente da Solução Bare Metal. Para ver o status atual, escolha uma das seguintes opções de comando:

Console

Verifique o status dos servidores da Solução Bare Metal e dos componentes de rede e armazenamento associados no console do Google Cloud.

  1. Acesse Compute Engine > Solução Bare Metal > Servidores.

  2. Veja as informações disponíveis.

    Field Descrição Exemplo
    Status Indica a disponibilidade de um servidor. Um círculo verde com uma marca de seleção indica que o servidor está provisionado e disponível.
    ID Identificador atribuído ao seu servidor.
    • Clique nele para ver informações básicas sobre o servidor.
    • Compartilhe o código com o suporte do Google Cloud ao solucionar esse recurso.
    at-1234567-svr001
    Nome Nome do servidor Clique no nome para ver mais informações sobre o servidor.

    Observação: se você não tiver inserido um nome ao provisionar seu servidor, o ID aparecerá este campo.
    server-1
    Local Região da Solução Bare Metal asia-southeast1
    Tipo de servidor Especificações do servidor o2-standard-32-metal
    IP do cliente Endereço IP do servidor que se conecta à sua nuvem privada virtual do Google 10.200.0.5
    IP particular Endereço IP do servidor que se conecta a outros recursos do ambiente da Solução Bare Metal 192.168.2.5
    Marcadores Exibe os rótulos que você adicionou a este servidor.

    Para usar os rótulos e filtrar a saída do console, copie o texto de um rótulo e cole-o no Filtro logo acima do campo Status.
    environment:test
  3. Para ver mais informações sobre o servidor e os recursos de rede e de armazenamento dele, clique no Nome do servidor.

    • Em Informações básicas, é possível saber se o servidor é compatível com o hiperencadeamento.
    • Em Rede, é possível ver os nomes das interfaces de rede, tipos de interface (cliente ou particular), endereços IP e endereços MAC.
    • Em Armazenamento, você pode ver as informações do número de unidade lógica (LUN, na sigla em inglês), como estado, nome, volume, tamanho e tipo. Também é possível ver se a LUN é compartilhável e inicializável.

gcloud

  1. Para listar os servidores no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e emita o comando gcloud bms instances list:

    gcloud bms instances list --project=PROJECT_ID
    

    O exemplo de saída a seguir mostra informações sobre um servidor, como nome, tipo, endereços IP e estado do servidor.

    NAME               PROJECT              REGION           MACHINE_TYPE          IP_ADDRESSES             STATE
    SERVER_NAME      PROJECT_ID        REGION         o2-standard-32-metal  192.168.1.1,192.168.2.1  RUNNING
    

    Outras opções de comando incluem:

    • --region--region: exibe dispositivos em uma região específica do Google Cloud.
    • --limit--limit: limita a saída para mostrar um número específico de dispositivos
  2. Para informações de rede e armazenamento de um servidor específico no ambiente da Solução Bare Metal, digite o nome do servidor, o ID do projeto e a região e emita o comando gcloud bms instances describe:

    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
    

    O exemplo de saída a seguir mostra um servidor operacional com 12 LUNs, uma rede cliente de 192.168.1.1 e uma rede particular de 192.168.2.1.

    luns:
    - bootLun: true
      name: SERVER_NAME-lun000-b1
      sizeGb: '200'
      state: READY
      storageVolume: SERVER_NAME-vol000-b1
    - name: STORAGE_DEVICE_NAME-lun001
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun002
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun003
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun004
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun005
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun006
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun007
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun008
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun009
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun010
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun011
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun012
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    machineType: o2-standard-32-metal
    name: projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME
    networks:
    - ipAddress: 192.168.1.1
      macAddress:
      - 34:80:0D:52:AF:28
      - 34:80:0D:15:3E:0D
      network: STORAGE_DEVICE_NAME-vlan001
    - ipAddress: 192.168.2.1
      macAddress:
      - 34:80:0D:52:AF:38
      - 34:80:0D:15:3E:1D
      network: STORAGE_DEVICE_NAME-vlan002
    state: RUNNING
    

API

  1. Abra uma janela do terminal do Cloud Shell no Console do Google Cloud.

  2. Para listar os servidores no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e a região no comando curl a seguir, copie o comando, cole-o no prompt do Cloud Shell e pressione. use a tecla Enterou chave de Retorno

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"
    
  3. Para receber informações de rede e armazenamento de um servidor no ambiente da Solução Bare Metal, emita o seguinte comando:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"
    

Organizar servidores usando rótulos

Para organizar seus servidores, use rótulos. Os rótulos são pares de chave-valor que podem ser anexados a cada servidor e filtrados com base nos rótulos deles. Por exemplo, é possível usar rótulos para agrupar servidores por finalidade, ambiente, local, departamento e assim por diante. Os marcadores são opcionais.

Adicionar ou atualizar rótulos para servidores

É possível adicionar ou atualizar rótulos para os servidores atuais.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.

  2. No servidor que você quer rotular, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Clique em Adicionar rótulo e adicione o par de chave-valor.
    2. Para atualizar os rótulos, selecione-os e modifique os valores.
    3. Selecione Enviar.
  5. Depois disso, atualize a página Servidores para ver as alterações.

gcloud

Para adicionar ou atualizar rótulos de um servidor, use o comando gcloud bms instances update com a opção --update-labels.

O comando de amostra a seguir adiciona os rótulos environment = dev e location = branch:

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Se você fornecer um novo valor para um rótulo que já existe, o sistema atualizará a chave atual com o novo valor. Se você fornecer um novo rótulo, o sistema o adicionará à lista de rótulos.

API

Para adicionar ou atualizar rótulos de um servidor, insira o ID do projeto, a região, o nome do servidor e uma lista de rótulos no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return.

A amostra de comando a seguir atribui um rótulo de environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Remover rótulos dos servidores

Você pode remover rótulos dos servidores.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.

  2. Para um servidor com rótulos que você queira remover, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Para excluir um rótulo, clique em .
    2. Selecione Enviar.
  5. Depois disso, atualize a página Servidores para ver as alterações.

gcloud

Para remover rótulos de um servidor, use o comando gcloud bms instances update com as seguintes opções:

  • --remove-labels: remove o rótulo especificado.
  • --clear-labels: remove todos os rótulos.

A amostra de comando a seguir remove o rótulo department de um servidor:

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

A amostra de comando a seguir remove todos os rótulos de um servidor:

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Para remover rótulos de um servidor, insira o ID do projeto, a região e o nome do servidor no comando curl a seguir. Forneça uma lista vazia de rótulos para remover todos os rótulos ou forneça uma lista dos rótulos que você quer manter (omitindo aqueles a serem removidos). Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

O comando de exemplo a seguir remove todos os rótulos, exceto environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrar servidores usando rótulos

É possível pesquisar seus servidores e filtrar os resultados usando rótulos.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.

  2. Clique na barra Filtro acima da lista de servidores.

  3. Na lista Propriedades, selecione Rótulos.

  4. Insira a chave, o valor ou o par de chave-valor do seu rótulo.

    Por exemplo, para ver apenas servidores com o rótulo env:dev, é possível inserir qualquer uma das informações a seguir:

    • Digite a chave: env
    • Insira o valor: dev
    • Insira o par de chave-valor: env:dev
  5. Para aplicar o filtro de rótulo, clique em qualquer lugar fora da barra de filtro.

gcloud

Para filtrar os servidores usando rótulos, use o comando gcloud bms instances list com a opção --filter.

O valor da opção --filter precisa estar no formato labels.KEY=VALUE. Por exemplo, se você quiser filtrar um rótulo com env como a chave e dev como o valor, emita este comando:

gcloud bms instances list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Para mais informações sobre a sintaxe do filtro na CLI gcloud, consulte a documentação gcloud topic filters.

API

Para filtrar servidores usando rótulos, insira a região e o ID do projeto com filter=labels e um rótulo de par de chave-valor. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

O comando de exemplo a seguir limita a saída para encontrar servidores com o rótulo de par de chave-valor environment = test.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"?filter=labels.environment=test

Recuperar a senha inicial de um servidor

Ao receber o servidor da Solução Bare Metal pela primeira vez ou mudar o sistema operacional, esse servidor começa no estado padrão e tem uma senha inicial. Use essa senha na primeira vez que acessar o servidor. Depois de usar essa senha, o servidor vai solicitar que você a altere.

Para encontrar a senha inicial, siga estas etapas:

gcloud

  1. Antes de recuperar uma senha, confira se você ativou a conta de serviço fornecida pelo Google Cloud.
  2. No projeto que contém os recursos da Solução Bare Metal, ative o Cloud Shell e emita o comando gcloud bms instances describe.

    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
    
  3. Na saída, procure o campo loginInfo e siga as instruções.

  4. Se o campo loginInfo contiver um comando gcloud beta secrets versions access, copie e cole o comando no prompt da linha de comando e pressione Enter ou Return.

  5. Recupere o nome de usuário, geralmente customeradmin, e a senha.

  6. Use essas credenciais para fazer login no servidor.

  7. Altere a senha.

API

  1. Antes de recuperar uma senha, confira se você ativou a conta de serviço fornecida pelo Google Cloud.
  2. No projeto que contém os recursos da Solução Bare Metal, acesse o Cloud Shell.
  3. Insira o ID do projeto, a região e o nome do servidor no comando curl a seguir, copie e cole o comando no prompt da linha de comando e pressione Enter ou Return.

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"
    
  4. Na saída, procure o campo loginInfo e siga as instruções.

  5. Se o campo loginInfo contiver um comando gcloud beta secrets versions access, copie e cole o comando no prompt da linha de comando e pressione Enter ou Return.

  6. Recupere o nome de usuário, geralmente customeradmin, e a senha.

  7. Use essas credenciais para fazer login no servidor.

  8. Altere a senha.

Alterar o sistema operacional de um servidor

É possível reimaginar um servidor da Solução Bare Metal com uma imagem de SO diferente. A alteração da imagem do SO leva muito tempo para ser concluída e requer um ciclo de energia do servidor. Para selecionar uma das imagens de SO disponíveis, acesse Sistemas operacionais.

Console

É possível restaurar a imagem do servidor da Solução Bare Metal pelo console do Google Cloud.

  1. Acesse Compute Engine > Solução Bare Metal > Servidores.
  2. Clique no menu para o servidor do qual você quer restaurar a imagem.
  3. Clique em Editar.
  4. Na página Editar servidor:
    • Marque a caixa de seleção Restaurar imagem de servidor.
    • Na lista Imagem do SO, selecione a imagem que você quer instalar.
    • Clique em Save.

gcloud

Execute o comando gcloud bms instances update para alterar a imagem do SO no seu servidor:

gcloud bms instances update SERVER_NAME --region REGION --os-image=OS_IMAGE

API

Para atualizar uma imagem do SO no servidor da Solução Bare Metal, insira o ID do projeto, a região, o nome do servidor e a imagem do SO e emita o seguinte comando curl.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=os_image"
 -d "{
  'osImage' : 'OS_IMAGE'
}"

Como essa mudança demora um pouco para ser concluída, é possível verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Ativar hyperthreading em um servidor

Você pode ativar ou desativar o hyperthreading nos seus servidores da Solução Bare Metal. Essa ação leva muito tempo para ser concluída e exige um ciclo de energia do servidor.

Console

É possível ativar ou desativar o hyperthreading no servidor da Solução Bare Metal, no console do Google Cloud.

  1. Acesse Compute Engine > Solução Bare Metal > Servidores.
  2. Clique no menu para o servidor em que você quer ativar/desativar o hyperthreading.
  3. Clique em Editar.
  4. Na página Editar servidor:
    • Para ativar o hyperthreading, marque a caixa de seleção Ativar hyperthreading.
    • Para desativar o hyperthreading, desmarque a caixa de seleção Ativar hyperthreading.
    • Clique em Save.

gcloud

Execute o comando gcloud bms instances update para ativar ou desativar o hyperthreading.

  • Inclua a opção –enable-hyperthreading para ativá-la.
  • Inclua a opção –no-enable-hyperthreading para desativá-la.
gcloud bms instances update SERVER_NAME --region REGION --enable-hyperthreading

API

Para mudar os recursos atuais de hyperthreading do seu servidor, insira o ID do projeto, a região e o nome do servidor no seguinte comando curl. Adicione true ao valor de hyperthreading se quiser ativá-lo ou false para desativá-lo.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=hyperthreading_enabled"
 -d "{
  'hyperthreadingEnabled' : 'HYPERTHREADING_VALUE'
}"

Como essa mudança demora um pouco para ser concluída, é possível verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Gerenciar redes

É possível gerenciar as redes no ambiente da Solução Bare Metal das seguintes maneiras:

Ver redes no ambiente da Solução Bare Metal

O monitoramento dos recursos de rede no ambiente da Solução Bare Metal permite saber como os servidores se conectam a outros recursos. Para ver o status da rede, escolha uma das seguintes opções:

Console

  1. No Console do Google Cloud, navegue para Compute Engine > Solução Bare Metal > Redes.

  2. Veja as informações disponíveis.

    Field Descrição Exemplo
    Status Indica a disponibilidade de uma rede. Um círculo verde com uma marca de seleção indica que a rede está provisionada e disponível.
    ID Identificador atribuído à sua rede.
    • Clique nele para ver informações básicas sobre a rede.
    • Compartilhe o código com o suporte do Google Cloud ao solucionar esse recurso.
    at-1234567-vlan001
    Nome Nome da rede. Clique no nome para ver mais informações sobre a rede.

    Observação: se você não tiver inserido um nome ao provisionar a rede, o ID aparecerá neste campo.
    network-1
    Local Região onde a rede está localizada asia-southeast1
    Tipo Cliente ou rede privada Client
    CIDR Intervalo de endereços IP da rede 192.168.1.0/24
    ID VLAN Identificador da VLAN atribuído pelo Google Cloud 100
    Marcadores Exibe os rótulos adicionados a esse recurso de rede.

    Para usar os rótulos e filtrar a saída do console, copie o texto de um rótulo e cole-o no Filtro logo acima do campo Status.
    environment:test

gcloud

  1. Para visualizar todas as redes no ambiente da Solução Bare Metal e ver o status delas, insira o ID do projeto e emita o comando gcloud bms networks list.

    gcloud bms networks list --project=PROJECT_ID
    
    O exemplo de saída a seguir mostra um nome da rede, região, intervalo de endereços IP, tipo de rede e ID da VLAN de cada rede.
    NAME                REGION           RANGE           TYPE     VLAN_ID
    at-1111111-vlan001  REGION         192.168.1.0/24  CLIENT   122
    at-1111111-vlan002  REGION         192.168.2.0/24  PRIVATE  123
    
  2. Para ver detalhes de uma única rede, insira o ID do projeto, a região e o nome da rede e emita o seguinte comando gcloud bms networks describe:

    gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
    
    O exemplo de saída a seguir mostra o intervalo de endereços IP, nome da rede, estado, tipo de rede, ID da VLAN e detalhes do roteamento virtual e de encaminhamento (VRF, na sigla em inglês).
    cidr: 192.168.1.0/24
    name: projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME
    state: PROVISIONED
    type: CLIENT
    vlanId: '122'
    vrf:
      autonomousSystemNumber: '65500'
      juniperAlias: g00000-at-1111111-ic001
      name: at-1111111-ic001
      routeTarget: '282'
      state: PROVISIONED
    

API

  1. Abra uma janela do terminal do Cloud Shell no console do Google Cloud.

  2. Para ver todas as redes no ambiente da Solução Bare Metal e ver o status delas, insira o ID do projeto e a região no comando curl a seguir, copie o comando, cole-o no prompt do Cloud Shell e pressione a tecla Enter ou Return:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks"
    
  3. Para ver detalhes de uma única rede, insira o ID do projeto, a região e o nome da rede e emita o seguinte comando:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME"
    

Organizar redes usando rótulos

Ajudar a organizar suas redes usando rótulos. Os rótulos são pares de chave-valor que podem ser anexados a cada rede e filtrados com base nos rótulos delas. Por exemplo, é possível usar rótulos para agrupar redes por finalidade, ambiente, local, departamento e assim por diante. Os marcadores são opcionais.

Adicionar ou atualizar rótulos para redes

É possível adicionar ou atualizar rótulos para as redes atuais.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Redes.

  2. Na rede em que você quer incluir um rótulo, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Clique em Adicionar rótulo e adicione o par de chave-valor.
    2. Para atualizar os rótulos, selecione-os e modifique os valores.
    3. Selecione Enviar.
  5. Depois disso, atualize a página Redes para ver as alterações.

gcloud

Para adicionar ou atualizar rótulos de uma rede, use o comando gcloud bms networks update com a opção --update-labels.

O comando de amostra a seguir adiciona os rótulos environment = dev e location = branch:

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Se você fornecer um novo valor para um rótulo que já existe, o sistema atualizará o rótulo atual com o novo valor. Se você fornecer um novo rótulo, o sistema o adicionará à lista de rótulos.

API

Para adicionar ou atualizar rótulos de uma rede, insira o ID do projeto, a região, o nome da rede e uma lista de rótulos no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return.

A amostra de comando a seguir atribui um rótulo de environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Remover rótulos das redes

Você pode remover rótulos das redes.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Redes.

  2. Para uma rede com rótulos que você quer remover, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Para excluir um rótulo, clique em .
    2. Selecione Enviar.
  5. Depois disso, atualize a página Redes para ver as alterações.

gcloud

Para remover rótulos de uma rede, use o comando gcloud bms networks update com as seguintes opções:

  • --remove-labels: remove o rótulo especificado.
  • --clear-labels: remove todos os rótulos.

A amostra de comando a seguir remove o rótulo department de uma rede:

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

A amostra de comando a seguir remove todos os identificadores de uma rede:

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Para remover rótulos de uma rede, insira o ID do projeto, a região e o nome da rede no comando curl a seguir. Forneça uma lista vazia de rótulos para remover todos os rótulos ou forneça uma lista dos rótulos que você quer manter (omitindo aqueles a serem removidos). Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

O comando de exemplo a seguir remove todos os rótulos, exceto environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrar redes usando rótulos

Você pode pesquisar suas redes e filtrar resultados usando rótulos.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Redes.

  2. Clique na barra Filtro acima da lista de redes.

  3. Na lista Propriedades, selecione Rótulos.

  4. Insira a chave, o valor ou o par de chave-valor do seu rótulo.

    Por exemplo, para ver apenas redes com o rótulo env:dev, insira uma das seguintes opções:

    • Digite a chave: env
    • Insira o valor: dev
    • Insira o par de chave-valor: env:dev
  5. Para aplicar o filtro de rótulo, clique em qualquer lugar fora da barra de filtro.

gcloud

Para filtrar redes usando rótulos, use o comando gcloud bms networks list com a opção --filter.

O valor da opção --filter precisa estar no formato labels.KEY=VALUE. Por exemplo, se você quiser filtrar um rótulo com env como a chave e dev como o valor, emita este comando:

gcloud bms networks list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Para mais informações sobre a sintaxe do filtro na CLI gcloud, consulte a documentação gcloud topic filters.

API

Para filtrar redes usando rótulos, insira a região e o ID do projeto com filter=labels e um rótulo de par de chave-valor. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

O comando de exemplo a seguir limita a saída para encontrar redes com o rótulo de par de chave-valor environment = test.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks"?filter=labels.environment=test

Adicionar e anexar uma rede a um servidor

A Solução Bare Metal permite adicionar uma rede de duas maneiras:

Criar e anexar uma nova rede a um servidor

Criar e anexar uma nova rede

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.

  2. Clique no nome do servidor.

  3. Na página Detalhes do servidor, clique em Anexar rede.

  4. Na página Anexar uma rede, selecione Nova rede.

  5. No campo Nome, insira um nome para a rede.

  6. Selecione o tipo de rede:

    1. Para criar uma rede cliente, selecione Cliente.
    2. Para criar uma rede particular, selecione Particular.
  7. Aplicável apenas se você tiver selecionado o tipo de rede Cliente. Para adicionar um anexo da VLAN, clique em Adicionar um item.

    1. Para adicionar um anexo da VLAN do projeto atual:
      1. Marque a opção Selecionar anexos da VLAN no projeto atual.
      2. Na lista de anexo da VLAN, selecione o anexo da VLAN que você quer adicionar.
    2. Para adicionar um anexo da VLAN de outro projeto, siga estas etapas:

      1. Desmarque a caixa de seleção Selecione anexos da VLAN no seu projeto atual.
      2. No campo Chave de pareamento do anexo da VLAN, insira uma chave de pareamento.

        Para informações sobre chaves de pareamento, consulte Criar anexos da VLAN para a conexão do Cloud Interconnect.

    3. Na lista Largura de banda, selecione a quantidade de largura de banda que você quer alocar para o anexo da VLAN.

    4. Clique em Concluído.

  8. No campo Intervalo de endereços IP da rede, insira o intervalo de endereços IP da rede.

  9. (Opcional) No campo Intervalo de endereços IP do serviço, insira o intervalo de endereços IP do serviço da rede.

  10. Selecione a MTU para a rede:

    1. 1.500: para frames de tamanho padrão.
    2. 9.000: para frames grandes.
  11. Defina a configuração da interface:

    1. Na lista Interface, selecione uma interface de vinculação para essa rede.

      Na maioria dos casos, selecione bond0 para uma rede do cliente e bond1 para uma rede particular.

    2. No campo Endereço IP, insira um endereço IP da rede que você está anexando.

  12. (Opcional) Para tornar essa rede o gateway padrão, marque a caixa de seleção Default gateway.

  13. Clique em Anexar rede.

O status do servidor muda para "Provisioning". Como a anexação de uma rede leva algum tempo para ser concluída, você pode verificar o status seguindo as etapas em Ver o status de uma operação de longa duração. Quando a operação é concluída, o status do servidor muda para "Em execução".

Anexar uma rede atual a um servidor

É possível anexar uma rede a um servidor nas duas condições a seguir:

  • A rede não está conectada ao servidor.
  • O intervalo de endereços IP da rede não se sobrepõe a outra rede anexada ao servidor.

Para anexar uma rede:

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.
  2. Clique no nome do servidor.
  3. Na página Detalhes do servidor, clique em Anexar rede.
  4. Na página Anexar uma rede, selecione Rede atual.
  5. Selecione uma rede:

    1. Para selecionar uma rede do projeto:
      1. Verifique se a opção Selecionar redes de outros projetos na sua organização não está marcada.
      2. Na lista Selecione uma rede, escolha uma rede para anexar ao servidor.
    2. Para selecionar uma rede de outros projetos na organização:
      1. Selecione a opção Selecionar redes de outros projetos na sua organização.
      2. Na lista Selecione uma rede, escolha uma rede para anexar ao servidor.
  6. Defina a configuração da interface:

    1. Na lista Interface, selecione uma interface de vinculação para essa rede.

      Na maioria dos casos, selecione bond0 para uma rede do cliente e bond1 para uma rede particular.

    2. No campo Endereço IP, insira um endereço IP da rede que você está anexando.

  7. (Opcional) Para tornar essa rede o gateway padrão, marque a caixa de seleção Default gateway.

  8. Clique em Anexar rede.

O status do servidor muda para "Provisioning". Como a anexação de uma rede leva algum tempo para ser concluída, você pode verificar o status seguindo as etapas em Ver o status de uma operação de longa duração. Quando a operação é concluída, o status do servidor muda para "Em execução".

Remover uma rede de um servidor

É possível remover apenas uma rede por vez de um servidor, e o servidor pode estar em execução ou desligado.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.
  2. Clique no nome do servidor.
  3. Na página Detalhes do servidor, selecione a rede que você quer remover
  4. Clique em Remover rede.
  5. Quando solicitado, clique em Confirmar.

O status do servidor muda para "Provisioning". Como a remoção de uma rede leva algum tempo para ser concluída, você pode verificar o status seguindo as etapas em Ver o status de uma operação de longa duração. Quando a operação é concluída, o status do servidor muda para "Em execução".

Excluir uma rede

Para excluir uma rede, faça o seguinte:

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Redes.
  2. Selecione a rede que você quer excluir.
  3. Clique em Excluir.
  4. Quando solicitado, clique em Confirmar.

Como a exclusão de uma rede leva algum tempo para ser concluída, você pode verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Gerenciar anexos da VLAN

É possível gerenciar os anexos da VLAN das seguintes maneiras:

Adicionar um anexo da VLAN

É possível adicionar um ou mais anexos da VLAN à sua rede cliente.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Redes.
  2. Clique no nome da rede.
  3. Na página Detalhes da rede, na seção Anexos da VLAN, clique em Anexar.
  4. Na página Anexar novas VLANs à rede:

    1. Clique em Adicionar um item.
    2. Para adicionar um anexo da VLAN do projeto atual:
      1. Marque a opção Selecionar anexos da VLAN no projeto atual.
      2. Na lista de anexo da VLAN, selecione um anexo da VLAN que você quer adicionar.
    3. Para adicionar um anexo da VLAN de outro projeto, siga estas etapas:

      1. Desmarque a caixa de seleção Selecione anexos da VLAN no seu projeto atual.
      2. No campo Chave de pareamento do anexo da VLAN, insira uma chave de pareamento.

        Para informações sobre chaves de pareamento, consulte Criar anexos da VLAN para a conexão do Cloud Interconnect.

    4. Na lista Largura de banda, selecione a quantidade de largura de banda que você quer alocar para o anexo da VLAN.

    5. Para adicionar outro anexo da VLAN para redundância e alta disponibilidade, clique em Adicionar um item e repita as etapas acima.

    6. Clique em Concluído.

  5. Clique em Criar.

Como a criação de um anexo da VLAN leva um tempo, é possível verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Atualizar um anexo da VLAN

É possível atualizar a largura de banda de um anexo da VLAN.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Redes.
  2. Clique no nome da rede.
  3. Na página Detalhes da rede, selecione o anexo da VLAN que você quer atualizar.
  4. Clique em Atualizar.
  5. Na página Atualizar anexos da VLAN:
    1. Expanda o anexo da VLAN que você quer atualizar.
    2. Modifique a largura de banda.
    3. Clique em Concluído.
  6. Clique em Atualizar.

Como a atualização de um anexo da VLAN leva um tempo, é possível verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Excluir um anexo da VLAN

É possível excluir um anexo da VLAN.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Redes.
  2. Clique no nome da rede.
  3. Na página Detalhes da rede, selecione o anexo da VLAN que você quer excluir.
  4. Clique em Excluir.

Como a exclusão de um anexo da VLAN leva um tempo, é possível verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Veja informações avançadas de rede de um ambiente da Solução Bare Metal

Se você selecionou a opção de rede avançada para implantações complexas no seu ambiente da Solução Bare Metal, poderá ver essas informações usando os comandos do servidor a seguir.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.

  2. Clique no nome do servidor.

  3. Na página Detalhes do servidor, você pode ver as seguintes informações:

    1. Veja os detalhes básicos no modelo de rede.
    2. Na seção Redes, você pode ver as seguintes informações:
      • Nome da rede
      • Tipo de rede
      • Endereço IP
      • Gateway padrão
      • Nome da interface

gcloud

Execute o comando gcloud bms instances describe para ver as configurações avançadas de rede do servidor.

gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

API

Para visualizar configurações avançadas de rede do seu servidor, insira o ID do projeto, a região e o nome do servidor. Em seguida, emita o seguinte comando curl. Na seção de redes da saída, é possível ver o modelo de rede, interfaces lógicas, interfaces vinculadas e tipo de rede atribuído a cada interface.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

Implementar o gerenciamento de endereços IP em um ambiente da Solução Bare Metal

Conseguir gerenciar a topologia de rede dentro do ambiente da Solução Bare Metal é importante. O gerenciamento de endereços IP ajuda a criar, ver e excluir endereços IP dos seus recursos. É possível usar essas informações para evitar a sobreposição de endereços IP e resolver conflitos ao solicitar novos recursos.

Ver reservas de endereços IP

Para ver os endereços IP de reservas existentes, faça o seguinte:

gcloud

Execute o comando gcloud bms networks list-ip-reservations:

gcloud bms networks list-ip-reservations --project=PROJECT_ID --region REGION

API

Para ver reservas de endereços IP de recursos, insira o ID do projeto, a região e o nome da rede e execute o seguinte comando curl. A seção de reservas na saída mostra intervalos de endereços IP reservados.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME"

Criar e atualizar uma reserva de endereço IP

Para criar uma nova reserva de endereço IP ou atualizar uma existente:

gcloud

Execute o comando gcloud bms networks update para gerenciar reservas de endereços IP:

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --add-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS,note="NOTE"
  • Para remover todas as reservas de endereço IP, adicione a opção --clear-ip-range-reservations.
  • Para excluir um dos blocos de endereços reservados, adicione a opção --remove-ip-range-reservation e especifique os endereços de início e término do bloco de endereços IP reservado que quer remover.
gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --remove-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS

API

Para criar uma nova reserva de endereço IP ou atualizar uma existente, insira o ID do projeto, a região e o nome da rede no comando a seguir. Adicione um endereço de início, um endereço final e uma observação para cada bloco de endereços IP que você quer reservar. Em seguida, emita o comando curl.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=reservations"
 -d "{
  'reservations' : [
    {
      'startAddress' : 'START_ADDRESS_1',
      'endAddress' : 'END_ADDRESS_1',
      'note' : 'NOTES_1'
    },
    {
      'startAddress' : 'START_ADDRESS_2',
      'endAddress' : 'END_ADDRESS_2',
      'note' : 'NOTES_2'
    }
  ]
}"
  • Os blocos de reserva de endereço IP precisam estar dentro do intervalo CIDR da rede de destino.
  • Não use .1 (o endereço IP do gateway) em um bloco de reserva.
  • Cada vez que você executa esse comando curl, ele substitui o conjunto de reservas anterior. Se você precisar fazer atualizações, inclua todos os conjuntos de blocos de reserva antes de emitir o comando.
  • Para limpar todas as reservas, substitua o final do comando pelo seguinte:

    -d "{
    'reservations' : []
    }"
    

Gerenciar armazenamento

É possível gerenciar o armazenamento no ambiente da Solução Bare Metal das seguintes maneiras:

Ver o armazenamento no ambiente da Solução Bare Metal

Prestar atenção aos recursos de armazenamento no ambiente da Solução Bare Metal ajuda a determinar se os servidores têm capacidade de armazenamento suficiente para aplicativos e cargas de trabalho. Para ver o status do armazenamento, escolha uma das seguintes opções:

Console

  1. No console do Google Cloud, acesse Compute Engine > Solução Bare Metal > Volumes.

  2. Veja as informações disponíveis.

    Field Descrição Exemplo
    Status Indica a disponibilidade de um volume de armazenamento. Um círculo verde com uma marca de seleção indica que o volume de armazenamento está pronto.
    ID Identificador atribuído ao seu volume de armazenamento.
    • Clique nele para ver informações básicas sobre o volume de armazenamento, incluindo LUNs e snapshots.
    • Compartilhe o ID com o suporte do Google Cloud ao solucionar problemas desse recurso.
    • Volume de inicialização:
      at-1234567-svr001-vol000-b1
    • Volume do canal de fibra:
      at-1111111-vol001
    • Compartilhamento de NFS:
      at-2222222-nfs001-vol000
    Nome Nome do volume de armazenamento. Clique no nome para ver mais informações sobre o volume de armazenamento, incluindo LUNs e snapshots.

    Observação: se você não tiver inserido um nome ao provisionar seu volume de armazenamento, o ID será exibido. nesse campo.
    • Volume de inicialização:
      boot-volume-1
    • Volume do canal de fibra:
      fibre-channel-volume-5
    • Compartilhamento de NFS:
      nfs-share-7
    Local Região em que o volume de armazenamento está localizado asia-southeast1
    Tipo Disco rígido ou disco de estado sólido HDD - Hard drive
    Marcadores Exibe os rótulos adicionados ao recurso de armazenamento.

    Para usar os rótulos e filtrar a saída do console, copie o texto de um rótulo e cole-o no Filtro logo acima do campo Status.
    environment:test

gcloud

  1. Para visualizar todos os volumes de armazenamento no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e emita o comando gcloud bms volumes list:

    gcloud bms volumes list --project=PROJECT_ID
    
    O exemplo de saída a seguir mostra três volumes de armazenamento: ID do projeto, região, tamanho do volume e tipo de armazenamento.
    NAME                         PROJECT              REGION           REQUESTED_SIZE_GIB  STORAGE_TYPE  STATE
    at-1234567-svr001-vol000-b1  PROJECT_ID         REGION         200                 SSD           READY
    at-1111111-vol001            PROJECT_ID         REGION         1024                SSD           READY
    at-2222222-nfs001-vol000     PROJECT_ID         REGION         400                 HDD           READY
    
  2. Para visualizar um único volume de armazenamento, digite o nome do volume de armazenamento, o ID do projeto e a região e emita o comando gcloud bms volumes describe:

    gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
    
    O exemplo de saída a seguir mostra o tamanho do volume de armazenamento, o nome, a política de exclusão automática de snapshots, o estado e o tipo de armazenamento.
    currentSizeGib: '250'
    name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME
    requestedSizeGib: '250'
    snapshotAutoDeleteBehavior: OLDEST_FIRST
    snapshotReservationDetail:
      reservedSpaceGib: '50'
      reservedSpaceRemainingGib: '50'
    state: READY
    storageType: SSD
    
  3. Para visualizar todas as LUNs do volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento e emita o comando gcloud bms volumes luns list:

    gcloud bms volumes luns list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
    
    O exemplo de saída a seguir mostra os nomes das LUNs, a região, o nome do volume de armazenamento, o tamanho do volume e o estado.
    NAME                         REGION           VOLUME       SIZE_GB  STATE
    at-11111111-vol001-lun000    REGION        VOLUME_NAME 200      READY
    
  4. Para ver detalhes de uma única LUN, digite o ID do projeto, a região e o nome da LUN e emita o comando gcloud bms volumes luns describe:

    gcloud bms volumes luns describe LUN_NAME --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
    
    O exemplo de saída a seguir mostra o nome LUN e as informações de volume de armazenamento, como tamanho, estado, tipo de armazenamento, nome e ID.
    bootLun: true
    name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME
    sizeGb: '200'
    state: READY
    storageType: SSD
    storageVolume: VOLUME_NAME
    wwid: 600a09803831434434244f774d616b94
    

API

  1. Abra uma janela do terminal do Cloud Shell no console do Google Cloud.

  2. Para ver todos os servidores no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e a região no comando curl. A seguir, copie o comando, cole-o no prompt do Cloud Shell e pressione a tecla Enter ou Return:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"
    
  3. Para visualizar um único volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento e execute o seguinte comando:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME"
    
  4. Para ver todos os números de unidades lógicas (LUNs, na sigla em inglês) do volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento e execute o seguinte comando:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns
    
  5. Para ver detalhes de uma única LUN, digite o código do seu projeto, a região, o nome do volume de armazenamento e o nome da LUN, além do seguinte comando:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME"
    

Organizar volumes de armazenamento usando rótulos

Para ajudar a organizar os volumes de armazenamento, é possível usar rótulos. Os identificadores são pares de chave-valor que podem ser anexados a cada volume de armazenamento e filtrados com base nos rótulos. Por exemplo, é possível usar rótulos para agrupar volumes de armazenamento por finalidade, ambiente, local, departamento e assim por diante. Os marcadores são opcionais.

Adicionar ou atualizar rótulos para volumes de armazenamento

É possível adicionar ou atualizar rótulos para os volumes de armazenamento.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.

  2. Para o volume de armazenamento que você quer rotular, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Clique em Adicionar rótulo e adicione o par de chave-valor.
    2. Para atualizar os rótulos, selecione-os e modifique os valores.
    3. Selecione Enviar.
  5. Depois disso, atualize a página Volumes para ver as alterações.

gcloud

Para adicionar ou atualizar rótulos de um volume de armazenamento, use o comando gcloud bms volumes update com a opção --update-labels.

O comando de amostra a seguir adiciona os rótulos environment = dev e location = branch:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Se você fornecer um novo valor para um rótulo que já existe, o sistema atualizará o rótulo atual com o novo valor. Se você fornecer um novo rótulo, o sistema o adicionará à lista de rótulos.

API

Para adicionar ou atualizar rótulos de um volume de armazenamento, insira o ID do projeto, a região, o nome do volume e uma lista de rótulos no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return.

A amostra de comando a seguir atribui um rótulo de environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Remover rótulos dos volumes de armazenamento

Você pode remover rótulos dos volumes de armazenamento.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.

  2. Para um volume de armazenamento com rótulos que você quer remover, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Para excluir um rótulo, clique em .
    2. Selecione Enviar.
  5. Depois disso, atualize a página Volumes para ver as alterações.

gcloud

Para remover rótulos de um volume de armazenamento, use o comando gcloud bms volumes update com as seguintes opções:

  • --remove-labels: remove o rótulo especificado.
  • --clear-labels: remove todos os rótulos.

A amostra de comando a seguir remove o rótulo department de um volume de armazenamento:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

O exemplo de comando a seguir remove todos os rótulos de um volume de armazenamento:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Para remover rótulos de um volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento no comando curl a seguir. Forneça uma lista vazia de rótulos para remover todos os rótulos ou forneça uma lista dos rótulos que você quer manter (omitindo aqueles a serem removidos). Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

O comando de exemplo a seguir remove todos os rótulos, exceto environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrar volumes de armazenamento usando rótulos

Você pode pesquisar volumes de armazenamento e filtrar resultados usando rótulos.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.

  2. Clique na barra Filtro acima da lista de volumes de armazenamento.

  3. Na lista Propriedades, selecione Rótulos.

  4. Insira a chave, o valor ou o par de chave-valor do seu rótulo.

    Por exemplo, para ver apenas volumes de armazenamento com o rótulo env:dev, é possível inserir qualquer um dos seguintes itens:

    • Digite a chave: env
    • Insira o valor: dev
    • Insira o par de chave-valor: env:dev
  5. Para aplicar o filtro de rótulo, clique em qualquer lugar fora da barra de filtro.

gcloud

Para filtrar volumes de armazenamento usando rótulos, use o comando gcloud bms volumes list com a opção --filter.

O valor da opção --filter precisa estar no formato labels.KEY=VALUE. Por exemplo, se você quiser filtrar um rótulo com env como a chave e dev como o valor, emita este comando:

gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Para mais informações sobre a sintaxe do filtro na CLI gcloud, consulte a documentação gcloud topic filters.

API

Para filtrar volumes de armazenamento usando rótulos, insira o ID do projeto e a região com filter=labels e um rótulo de par de chave-valor. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

A amostra de comando a seguir limita a saída para encontrar volumes de armazenamento com o rótulo de par de chave-valor environment = test.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"?filter=labels.environment=test

Provisionar recursos de volume de armazenamento no ambiente da Solução Bare Metal

Depois de solicitar recursos de armazenamento para o ambiente da Solução Bare Metal, é possível provisionar os recursos quando eles estiverem disponíveis. É possível provisionar as seguintes opções de autoatendimento:

  • Criar um novo volume de armazenamento do canal Fibre
  • Criar LUNs em um volume
  • Selecione e anexe os LUNs recém-criados aos seus servidores

Criar um novo volume de armazenamento

Para criar um novo volume de armazenamento, siga estas etapas:

Console

  1. No console do Google Cloud, acesse o menu Compute Engine > Solução Bare Metal > Volumes.

  2. Clique em Criar.

  3. Digite as seguintes informações:

    Campo Descrição Exemplo
    Região Região do Google Cloud mais próxima do ambiente da Solução Bare Metal. us-central1
    Nome Crie um nome para seu volume de armazenamento. volume-1
    Tipo Selecione o tipo de armazenamento:
    • SSD: unidade de estado sólido
    • HDD: disco rígido
    SSD
    Tamanho Selecione o tamanho da unidade em GiB, em que 1.024 GiB = 1 TiB. O tamanho varia de, no mínimo, 100 GiB até 16 TiB. Se você precisar de mais de 16 TiB, crie volumes adicionais conforme necessário. 16384
    Snapshot ativado Salva uma cópia de backup do seu volume de armazenamento uma vez por dia. Opção obrigatória para snapshots personalizados, mas desativada por padrão. Caixa de seleção selecionada para ativar snapshots
    Configuração Selecione o tipo de configuração de LUN necessária:
    • Configuração padrão: crie LUNs de tamanho igual (recomendado).
    • Configuração personalizada: crie LUNs com tamanhos diferentes.
    Default configuration
    Servidor de destino Selecione um servidor e anexe o volume de armazenamento. server-1
  4. Clique em Criar.

  5. O console verifica se há espaço suficiente disponível para o volume de armazenamento solicitado. O console implementará a alteração se houver espaço disponível ou enviará um alerta se não for possível realizar a operação. Se a solicitação de volume de armazenamento for bem-sucedida, o faturamento do armazenamento adicional começará automaticamente.

  6. Depois de provisionar o volume de armazenamento, será possível compartilhá-lo com outros servidores.

Criar LUNs para um volume de armazenamento

Para criar LUNs para um volume de armazenamento:

Console

  1. No console do Google Cloud, acesse o menu Compute Engine > Solução Bare Metal > Volumes.

  2. Ao lado da seção LUNs, clique em Criar.

  3. Digite as seguintes informações:

    Campo Descrição Exemplo
    Número de LUNs Número total de LUNs que você quer criar com um tamanho específico. 4
    Tamanho Selecione o tamanho da unidade em GiB, em que 1.024 GiB = 1 TiB. 1024
  4. Clique em Adicionar item se você precisar criar mais de um conjunto de LUNs.

  5. Clique em Criar para implantar os novos LUNs.

Anexar volumes de armazenamento aos servidores

Para anexar volumes de armazenamento existentes a servidores atuais, faça o seguinte:

Console

  1. Navegue até a página Compute Engine > Solução Bare Metal > Servidores.

  2. Clique no nome do servidor que precisa de volume de armazenamento.

  3. Clique em Anexar volume ao lado da seção LUNs.

  4. Selecione o volume de armazenamento no menu e clique em Anexar.

  5. Para anexar o mesmo volume de armazenamento a outros servidores, volte à página Detalhes do servidor e repita esse procedimento.

Remover recursos de volume de armazenamento em um ambiente da Solução Bare Metal

Quando não precisar mais de recursos específicos de volume de armazenamento, você poderá removê-los. As opções são estas:

  • Remover um volume de armazenamento de um servidor
  • Como excluir LUNs de um volume de armazenamento
  • Como excluir um volume de armazenamento

Remover um volume de armazenamento de um servidor

Para desanexar um volume de armazenamento de um servidor, faça o seguinte:

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores e clique no servidor com os volumes de armazenamento anexados.

  2. Role para baixo até a seção LUNs e clique em Desconectar volume.

  3. No menu, selecione o volume de armazenamento que você quer remover e clique em Desconectar.

    O servidor é reiniciado e remove o volume de armazenamento e as LUNs dele.

Excluir LUNs de um volume de armazenamento

Para excluir LUNs de um volume de armazenamento, faça o seguinte:

Console

  1. Navegue até a página Compute Engine > Solução Bare Metal > Volumes.

  2. Clique no nome do volume de armazenamento que contém os LUNs que você quer remover.

  3. Na seção LUNs, marque as caixas dos LUNs que você quer remover e clique em Excluir.

Excluir um volume de armazenamento

Para excluir um volume de armazenamento, faça o seguinte:

Console

  1. Navegue até a página Compute Engine > Solução Bare Metal > Volumes.

  2. Marque as caixas dos volumes de armazenamento que você quer remover e clique em Excluir.

Gerenciar snapshots de volume de inicialização

É possível gerenciar os snapshots de volume de inicialização das seguintes maneiras:

Ver snapshots de volume de inicialização e os detalhes

É possível ver a lista de snapshots de um volume de inicialização e os respectivos detalhes, incluindo o seguinte:

  • ID
  • Nome
  • Descrição
  • Horário da criação
  • Volume associado
  • Tipo

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.
  2. Clique no nome do volume.
  3. Na página Detalhes do volume, na seção Snapshots, é possível visualizar a lista de snapshots e os detalhes deles.

gcloud

Para listar todos os snapshots de um volume de inicialização, emita o comando gcloud bms volumes snapshots list.

gcloud bms volumes snapshots list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME

Para ver detalhes de um snapshot específico de volume de inicialização, emita o comando gcloud bms volumes snapshots describe.

gcloud bms volumes snapshots describe --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot-name=SNAPSHOT_NAME

API

Para listar todos os snapshots de volume de inicialização, insira o ID do projeto, a região e o nome do volume no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots"

Para visualizar detalhes de um snapshot de volume de inicialização, insira o ID do projeto, a região, o nome do volume e o nome do snapshot no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"

Criar um snapshot de volume de inicialização

Crie snapshots para volumes de inicialização.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.
  2. Clique no nome do volume.
  3. Na página Detalhes do volume, na seção Snapshots, clique em Criar.
  4. Na página Criar um novo snapshot de volume:
    1. No campo Nome, insira um nome exclusivo para o snapshot.
    2. No campo Descrição, insira uma descrição para o snapshot.
  5. Clique em Criar.

gcloud

Para criar um snapshot de volume de inicialização, emita o comando gcloud bms volumes snapshot.

gcloud bms volumes snapshot --project=PROJECT_ID --region=REGION VOLUME_NAME --snapshot-name=SNAPSHOT_NAME --description=DESCRIPTION

API

Para criar um snapshot de volume de inicialização, insira o ID do projeto, a região, o nome do volume, o nome e a descrição do snapshot no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots"
 -d \
'{\''name\'':
\''projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME\'', \''description\'': \''DESCRIPTION\''}' \

Excluir um snapshot de volume de inicialização

Você pode excluir os snapshots de volume de inicialização.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.
  2. Clique no nome do volume.
  3. Na página Detalhes do volume, na seção Snapshots, selecione o snapshot que você quer excluir.
  4. Clique em Excluir.
  5. Quando solicitado, clique em Confirmar.

gcloud

Para excluir um snapshot de volume de inicialização, emita o comando gcloud bms volumes snapshots delete.

gcloud bms volumes snapshots delete --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME SNAPSHOT_NAME

Quando solicitado, digite "Y" e pressione a tecla Enter ou Return.

API

Para excluir um snapshot de volume de inicialização, insira o ID do projeto, a região, o nome do volume e o nome do snapshot no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"

Restaurar um snapshot de volume de inicialização

É possível restaurar um volume de inicialização a partir de um snapshot.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Servidores.
  2. Interrompa o servidor anexado ao volume que você quer restaurar. Consulte Operar o servidor da Solução Bare Metal.

    Aguarde a conclusão do encerramento antes de seguir para a próxima etapa.

  3. Acesse a página Compute Engine > Solução Bare Metal > Volumes.

  4. Clique no nome do volume que você quer restaurar.

  5. Na página Detalhes do volume, faça o seguinte:

    1. No snapshot que você quer restaurar, clique em .
    2. Clique em Restaurar.
    3. Quando solicitado, clique em Confirmar.

gcloud

Para restaurar um snapshot de volume de inicialização, emita o comando gcloud bms volumes restore.

gcloud bms volumes restore --project=PROJECT_ID --region=REGION VOLUME_NAME --snapshot-name=SNAPSHOT_NAME

API

Para restaurar um snapshot de volume de inicialização, insira o ID do projeto, a região, o nome do volume e o nome do snapshot no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
-H "Content-Length:0" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME:restoreVolumeSnapshot"

Como a restauração de um volume de inicialização leva um tempo para ser concluída, é possível verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Gerenciar armazenamento de arquivos NFS

É possível gerenciar o armazenamento de arquivos NFS das seguintes maneiras:

Ver o armazenamento de arquivos NFS no ambiente da Solução Bare Metal

Depois de solicitar e provisionar o NFS para Solução Bare Metal, você poderá ver o status do armazenamento de arquivos NFS e confirmar se o Google Cloud implementou as configurações definidas como esperado. Para ver o status atual, escolha uma das seguintes opções de comando:

Console

  1. No console do Google Cloud, acesse Compute Engine > Solução Bare Metal > Cotas do NFS.

  2. Veja as informações disponíveis.

    Field Descrição Exemplo
    Status Indica a disponibilidade de um volume NFS. Um círculo verde com uma marca de seleção indica que o volume NFS foi provisionado.
    ID Identificador atribuído ao seu dispositivo de armazenamento NFS que hospeda seu volume.
    • Clique no ID para ver mais informações sobre o volume de armazenamento, incluindo os clientes e as propriedades NFS permitidos.
    • Compartilhe o ID com o suporte do Google Cloud ao solucionar problemas desse recurso.
    at-2222222-nfs001
    Nome Nome do dispositivo de armazenamento NFS que hospeda seu volume. Clique no nome para ver mais informações sobre o volume de armazenamento, incluindo os clientes e as propriedades NFS permitidos.

    Observação: se você não tiver inserido um nome ao provisionar o dispositivo de armazenamento NFS, o ID aparecerá neste campo.
    nfs-share-7
    Local Região do volume de armazenamento NFS asia-southeast1
    Volume Nome do volume de armazenamento NFS. Clique no nome para ver mais informações sobre o volume de armazenamento do NFS, como snapshots. at-2222222-nfs001-vol000
    Marcadores Exibe os rótulos adicionados ao recurso de armazenamento de arquivos NFS

    Para usar os rótulos e filtrar a saída do console, copie o texto de um rótulo e cole-o no Filtro logo acima do campo Status.
    environment:test

gcloud

  1. Para ver o status do armazenamento de arquivos NFS no ambiente da Solução Bare Metal, emita o comando gcloud bms nfs-shares list:

    gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION
    

    Outras opções de comando incluem:

    • --limit:--limit: limita a saída para mostrar um número específico de dispositivos
    • --filter: Limite a saída para mostrar dispositivos com um rótulo específico ou outro parâmetro de filtro.

    A saída fornece detalhes sobre o armazenamento de arquivos NFS, incluindo nome, ID, volume e clientes permitidos.

    NAME: nfs-share-7
    ID: at-2222222-nfs001
    PROJECT: PROJECT_ID
    REGION: REGION
    VOLUME_NAME: at-2222222-nfs001-vol000
    STATE: PROVISIONED
    ALLOWED_CLIENTS: [{"allowedCidr": "192.168.1.1/32", "networkName": "at-1111111-vlan001", "shareIp": "192.168.1.240"}]
    

  2. Para ver o status de um dispositivo de armazenamento de arquivos NFS específico, emita o comando gcloud bms nfs-shares describe. É possível usar o nome ou o ID de compartilhamento do NFS como a variável NFS_SHARE:

    gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION
    
    A saída fornece detalhes sobre os clientes permitidos, as configurações de NFS, o servidor NFS e seu estado, além do volume de armazenamento.
    allowedClients:
    – allowDev: true
      allowedClientsCidr: 192.168.1.1/32
      mountPermissions: READ_WRITE
      network: projects/PROJECT_ID/locations/REGION/networks/at-1111111-vlan001
      noRootSquash: true
      shareIp: 192.168.1.240
    name: projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE
    nfsShareId: at-2222222-nfs001
    state: PROVISIONED
    volume: projects/PROJECT_ID/locations/REGION/volumes/at-2222222-nfs001-vol000
    

API

  1. Para ver o status do armazenamento de arquivos NFS no ambiente da Solução Bare Metal, incluindo clientes permitidos e propriedades NFS, insira o ID e a região do projeto no seguinte comando curl. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"
    
  2. Para ver o status de um dispositivo de armazenamento de arquivos NFS específico, digite o ID do projeto, a região e o nome ou ID do servidor NFS. Em seguida, emita o seguinte comando:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE"
    

Organizar o armazenamento de arquivos NFS usando marcadores

Para ajudar a organizar o armazenamento de arquivos NFS, use rótulos. Os identificadores são pares de chave-valor que podem ser anexados a cada volume NFS e filtrados com base nos rótulos. Por exemplo, é possível usar rótulos para agrupar volumes NFS por finalidade, ambiente, local, departamento e assim por diante. Os marcadores são opcionais.

Adicionar ou atualizar rótulos para volumes NFS

É possível adicionar ou atualizar rótulos para os volumes NFS.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Compartilhamentos do NFS.

  2. Para o volume NFS que você quer rotular, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Clique em Adicionar rótulo e adicione o par de chave-valor.
    2. Para atualizar os rótulos, selecione-os e modifique os valores.
    3. Selecione Enviar.
  5. Depois que você voltar à página Compartilhamentos do NFS, atualize a página para visualizar as alterações.

gcloud

Para adicionar ou atualizar rótulos de um volume NFS, use o comando gcloud bms nfs-shares update com a opção --update-labels.

O comando de amostra a seguir adiciona os rótulos environment = dev e location = branch:

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Se você fornecer um novo valor para um rótulo que já existe, o sistema atualizará o rótulo atual com o novo valor. Se você fornecer um novo rótulo, o sistema o adicionará à lista de rótulos.

API

Para adicionar ou atualizar rótulos de um volume NFS, insira o ID do projeto, a região, o nome do volume NFS e uma lista de rótulos no seguinte comando curl. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return.

A amostra de comando a seguir atribui um rótulo de environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Remover rótulos de volumes NFS

É possível remover rótulos dos volumes NFS.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Compartilhamentos do NFS.

  2. Para o volume NFS com rótulos que você quer remover, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Para excluir um rótulo, clique em .
    2. Selecione Enviar.
  5. Depois que você voltar à página Compartilhamentos do NFS, atualize a página para visualizar as alterações.

gcloud

Para remover rótulos de um volume NFS, use o comando gcloud bms nfs-shares update com as seguintes opções:

  • --remove-labels: remove o rótulo especificado.
  • --clear-labels: remove todos os rótulos.

A amostra de comando a seguir remove o rótulo department de um volume NFS:

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

O exemplo de comando a seguir remove todos os rótulos de um volume NFS:

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Para remover rótulos de um volume NFS, insira o ID do projeto, a região e o nome do volume NFS no comando curl a seguir. Forneça uma lista vazia de rótulos para remover todos os rótulos ou forneça uma lista dos rótulos que você quer manter (omitindo aqueles a serem removidos). Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

O comando de exemplo a seguir remove todos os rótulos, exceto environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Se você emitir o comando curl sem rótulos ou valores, limpará todos os rótulos.

'labels' : {
}

Se você emitir o comando curl com novos valores para um rótulo, o novo valor substituirá o anterior.

'labels' : {
     'user': 'production',
     'env': 'production',
     'purpose': 'shared_data_store'
}

Filtrar volumes NFS usando rótulos

É possível pesquisar volumes NFS e filtrar resultados usando rótulos.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Compartilhamentos do NFS.

  2. Clique na barra Filtro acima da lista de volumes NFS.

  3. Na lista Propriedades, selecione Rótulos.

  4. Insira a chave, o valor ou o par de chave-valor do seu rótulo.

    Por exemplo, para ver apenas volumes NFS com o rótulo env:dev, é possível inserir qualquer um dos seguintes itens:

    • Digite a chave: env
    • Insira o valor: dev
    • Insira o par de chave-valor: env:dev
  5. Para aplicar o filtro de rótulo, clique em qualquer lugar fora da barra de filtro.

gcloud

Para filtrar volumes NFS usando rótulos, use o comando gcloud bms nfs-shares list com a opção --filter.

O valor da opção --filter precisa estar no formato labels.KEY=VALUE. Por exemplo, se você quiser filtrar um rótulo com env como a chave e dev como o valor, emita este comando:

gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Para mais informações sobre a sintaxe do filtro na CLI gcloud, consulte a documentação gcloud topic filters.

API

Para filtrar volumes NFS usando rótulos, insira o ID do projeto e a região com filter=labels e um rótulo de par de chave-valor. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

A amostra de comando a seguir limita a saída para encontrar volumes NFS com o rótulo de par de chave-valor environment = test.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"?filter=labels.environment=test

Criar um volume NFS

É possível criar um volume NFS com um ou mais clientes permitidos.

gcloud

Para criar um volume NFS, emita o comando gcloud bms nfs-shares create. Use a opção --allowed-client para especificar um cliente permitido. Para especificar vários clientes permitidos, repita a opção --allowed-client.

Digite os seguintes valores antes de emitir o comando:

  • NFS_VOLUME_NAME: nome do volume NFS.
  • REGION: região do volume NFS.
  • SIZE_GIB: tamanho do volume NFS em GiB.
  • STORAGE_TYPE: tipo de armazenamento do volume subjacente.
  • NETWORK_NAME: nome da rede para permissão.
  • (Opcional) PROJECT_ID: ID do projeto da rede do cliente permitido. Se você não fornecer um ID do projeto, o padrão será o projeto a que o volume NFS pertence.
  • IP_ADDRESS_RANGE: sub-rede dos endereços IP com permissão para acessar o volume NFS. Geralmente é a rede do cliente.
  • MOUNT_PERMISSIONS: ative as permissões para a rede de cliente permitida.
  • ALLOW_DEV: permitir a criação de dispositivos (sim/não).
  • ALLOW_SUID: permitir SUID (sim/não).
  • ENABLE_ROOT_SQUASH: ativa o root squash (sim/não).
gcloud bms nfs-shares create --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME \
--size-gib=SIZE_GIB --storage-type=STORAGE_TYPE \
--allowed-client=network=NETWORK_NAME,\
network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE,\
mount-permissions=MOUNT_PERMISSIONS,allow-dev=ALLOW_DEV,allow-suid=ALLOW_SUID,\
enable-root-squash=ENABLE_ROOT_SQUASH \

API

Para criar um volume NFS, insira os valores das variáveis no seguinte comando curl. É possível usar a lista allowedClients para especificar os clientes permitidos.

Digite os seguintes valores antes de emitir o comando:

  • NFS_VOLUME_NAME: nome do volume NFS.
  • REGION: região do volume NFS.
  • SIZE_GIB: tamanho do volume NFS em GiB.
  • STORAGE_TYPE: tipo de armazenamento do volume subjacente.
  • NETWORK_NAME: nome da rede para permissão.
  • (Opcional) PROJECT_ID: ID do projeto da rede do cliente permitido. Se você não fornecer um ID do projeto, o padrão será o projeto a que o volume NFS pertence.
  • IP_ADDRESS_RANGE: sub-rede dos endereços IP com permissão para acessar o volume NFS. Geralmente é a rede do cliente.
  • MOUNT_PERMISSIONS: ative as permissões para a rede de cliente permitida.
  • ALLOW_DEV: permitir a criação de dispositivos (sim/não).
  • ALLOW_SUID: permitir SUID (sim/não).
  • ENABLE_ROOT_SQUASH: ativa o root squash (sim/não).

Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "nfsKey1": "some_value",
    "key2": "another_value",
  },
  "requestedSizeGib": "SIZE_GIB",
  "storageType": "STORAGE_TYPE",
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

Como a criação de um volume NFS leva algum tempo para ser concluída, você pode verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Atualizar um volume NFS

É possível atualizar a lista de clientes permitidos para um volume NFS e os atributos deles.

gcloud

Para atualizar a lista de clientes permitidos para um volume NFS, use as seguintes opções com o comando gcloud bms nfs-shares update:

  • --add-allowed-client: adicione um cliente permitido. Repita esta opção para adicionar vários clientes permitidos.
  • --remove-allowed-client: remove um cliente permitido. É necessário fornecer os valores para NETWORK_NAME e IP_ADDRESS_RANGE com essa opção. Repita esta opção para remover vários clientes permitidos.
  • --clear-allowed-client: remova todos os clientes permitidos.

Para atualizar um volume NFS, emita o comando gcloud bms nfs-shares update com as opções apropriadas. Exemplo:

gcloud bms nfs-shares update --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME --remove-allowed-client=network=NETWORK_NAME,network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE

Para atualizar os atributos de um cliente permitido, remova-o usando a opção --remove-allowed-client e, em seguida, adicione-o novamente com atributos atualizados usando a opção --add-allowed-client.

API

Para atualizar um volume NFS, insira os valores das variáveis no seguinte comando curl. Para ver uma lista completa de variáveis, consulte Criar um volume NFS. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=allowed_clients%2Clabels"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "newKey": "newVal",
  },
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NFS_VOLUME_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

Como a atualização de um volume NFS leva algum tempo para ser concluída, você pode verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Excluir um volume NFS

É possível excluir um volume NFS.

gcloud

Para excluir um volume NFS, emita o comando gcloud bms nfs-shares delete.

gcloud bms nfs-shares delete --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME

API

Para excluir um volume NFS, insira o ID do projeto, a região e o nome do volume NFS no seguinte comando curl. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME"

Como a exclusão de um volume NFS leva algum tempo para ser concluída, você pode verificar o status seguindo as etapas em Ver o status de uma operação de longa duração.

Ver o status de uma operação de longa duração

Alguns comandos do gcloud ou da API, como uma redefinição de servidor, podem demorar bastante para serem concluídos. Um comando que produz uma operação de longa duração também gera uma saída que contém um ID de operação. Use o ID da operação para verificar o status da operação de longa duração.

No campo name da saída, você encontra o ID da operação, localizado após o diretório operations. Por exemplo, a saída a seguir do comando reset da API mostra o ID da operação como eb0056e2-b6f6-4792-8255-59cd79d5c686.

{
"name": "projects/PROJECT_ID/locations/REGION/operations/eb0056e2-b6f6-4792-8255-59cd79d5c686",
"done": true
}

Para verificar o status de uma operação de longa duração, use as seguintes opções:

gcloud

Para visualizar o status de uma operação de longa duração, use o comando gcloud bms operations describe.

gcloud bms operations describe --project=PROJECT_ID --region=REGION OPERATION_ID

API

  1. Abra uma janela do terminal do Cloud Shell no console do Google Cloud.

  2. Para ver o status de uma operação de longa duração no ambiente da Solução Bare Metal, insira o ID do projeto e o ID da operação no seguinte comando curl. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID"
    
    Quando a operação for concluída, o campo done será exibido como true na saída.
    {
      "name": "operations/OPERATION_ID",
      "done": true
    }