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

Há várias operações que você pode executar no servidor, como reiniciar e ligar. Use os seguintes comandos com seu servidor.

gcloud

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

    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 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 a energia do 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.

API

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

    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 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 a energia do 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.

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.

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 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.
    Código 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
    
  3. Para adicionar, atualizar ou remover rótulos de servidores, emita o comando gcloud bms instances update. Você pode usar as seguintes opções:

    • --update-labels: Adiciona rótulos aos recursos para que você possa filtrar a saída dos comandos de status. É necessário adicionar cada rótulo com um par de chave-valor, como environment = test.
    • --remove-labels: Remove rótulos específicos
    • --clear-labels: Remove todos os rótulos.

    Aqui está um comando de amostra que adiciona os rótulos environment = dev e location = branch e remove o rótulo department de

    gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch --remove-labels=department
    
    O comando a seguir remove todos os rótulos de um servidor:
    gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    Para ver as alterações dos rótulos do servidor, emita o seguinte comando:
    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
    
  4. Se quiser usar um rótulo para filtrar a saída de um comando gcloud bms instances list, adicione --filter labels.KEY=VALUE ao final do comando. No exemplo a seguir, limita a saída para um servidor rotulado com o par de chave-valor environment = dev.

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

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"
    
  4. Para adicionar rótulos a um servidor, digite o ID do projeto, a região e o nome do servidor no seguinte comando curl. No par de chave-valor neste exemplo, é atribuído um rótulo de environment = test. 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/instances/SERVER_NAME?updateMask=labels"
     -d "{
      'labels' : {'environment': 'test'}
    }"
    
  5. Para usar um rótulo para filtrar a saída de um comando GET curl de um servidor da Solução Bare Metal, insira o ID e a região do projeto e, em seguida, anexe ?filter=labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para encontrar servidores com o rótulo do par de chave-valor ambiente = teste.

    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
    

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.
    Código 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
    
  3. Para adicionar, atualizar ou remover rótulos de redes, emita o comando gcloud bms networks update. Você pode usar as seguintes opções:

    • --update-labels: Adiciona rótulos aos recursos para que você possa filtrar a saída dos comandos de status. É necessário adicionar cada rótulo com um par de chave-valor, como environment = test.
    • --remove-labels: Remove rótulos específicos
    • --clear-labels: Remove todos os rótulos.

    Aqui está um comando de amostra que adiciona os rótulos environment = dev e location = center e remove o rótulo cost-center de um network:

    gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=downtown --remove-labels=cost-center
    
    O comando a seguir remove todos os rótulos de uma rede:
    gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    Para ver as mudanças nos rótulos de rede, emita o seguinte comando:
    gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
    
  4. Se quiser usar um rótulo para filtrar a saída de um comando gcloud bms networks list, adicione --filter labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para uma rede rotulada com o par de chave-valor environment = dev.

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

API

  1. Abra uma janela do terminal do Cloud Shell no Console do 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/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"
    
  4. Para adicionar rótulos a uma rede, insira a ID do projeto, a região e o nome da rede, em seguida, execute o seguinte comando curl. No par de chave-valor neste exemplo, é atribuído 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'}
    }"
    
  5. Para usar um rótulo para filtrar a saída de um comando GET curl de uma rede da Solução Bare Metal, digite o ID e a região do projeto e, em seguida, anexe ?filter=labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para encontrar redes com o rótulo de par de chave-valor ambiente = teste.

    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
    

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 Cloud, navegue até 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.
    Código 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 adicionar, atualizar ou remover rótulos de volumes de armazenamento, emita o comando gcloud bms volumes update. É possível usar as seguintes opções:

    • --update-labels: Adiciona rótulos aos recursos para que você possa filtrar a saída dos comandos de status. É necessário adicionar cada rótulo com um par de chave-valor, como environment = production.
    • --remove-labels: Remove rótulos específicos
    • --clear-labels: Remove todos os rótulos.

    Veja um exemplo de comando que adiciona os rótulosambiente = produção elocal = q e removerá o rótulo.rack de um volume de armazenamento:

    gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=production,location=hq --remove-labels=rack
    
    O seguinte comando remove todos os rótulos de um volume de armazenamento:
    gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    Para ver as alterações dos rótulos de volume de armazenamento, execute o seguinte comando:
    gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
    
  4. Se quiser usar um rótulo para filtrar a saída de um comando gcloud bms volumes list, adicione --filter labels.KEY=VALUE ao final do comando. No exemplo a seguir, limita a saída para um volume de armazenamento rotulado com o par de chave-valor ambiente = produção.

    gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=production
    
  5. 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
    
  6. 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 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"
    
  6. Para adicionar rótulos a um volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento e, em seguida, emita o comando curl a seguir. O par de chave-valor neste exemplo 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'}
    }"
    
  7. Para usar um rótulo para filtrar a saída de umDOWNLOAD curl comando para um volume de armazenamento da Solução Bare Metal, digite o ID e a região do projeto e anexe?filter=labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para encontrar volumes de armazenamento com o rótulo do par de chave-valor ambiente = teste.

    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
    

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 Cloud, navegue até Compute Engine > Solução Bare Metal > Compartilhamentos de 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.
    Código 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
    
  3. Para adicionar, atualizar ou remover rótulos do armazenamento de arquivos NFS, emita o comando gcloud bms nfs-shares update. É possível usar as seguintes opções:

    • --update-labels: Adiciona rótulos aos recursos para que você possa filtrar a saída dos comandos de status. É necessário adicionar cada rótulo com um par de chave-valor, como environment = test.
    • --remove-labels: Remove rótulos específicos
    • --clear-labels: Remove todos os rótulos.

    Aqui está um comando de amostra que adiciona os rótulos environment = test e location = centro, além de remover o rótulo cost-center de um Dispositivo de armazenamento de arquivos NFS:

    gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --update-labels environment=test,location=downtown --remove-labels=cost-center
    
    O seguinte comando remove todos os rótulos de um dispositivo de armazenamento de arquivos NFS:
    gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --clear-labels
    

    Para ver as alterações nos rótulos de armazenamento de arquivos NFS, emita o seguinte comando:

    gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION
    
  4. Se quiser usar um rótulo para filtrar a saída de um comando gcloud bms nfs-shares list, adicione --filter labels.KEY=VALUE ao final do comando. No exemplo a seguir, limita a saída para um dispositivo de armazenamento de arquivos NFS rotulado com o par de chave-valor environment = test.

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

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"
    
  3. Para adicionar rótulos a um dispositivo de armazenamento de arquivos NFS, insira o ID do projeto, a região e o nome ou ID do servidor NFS no seguinte comando curl. Os pares de chave-valor neste exemplo atribuem três rótulos: user = test, env = staging e purpose = new_hardware_cert. } 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_SHARE?updateMask=labels"
     -d "{
      'labels' : {
         'user': 'test',
         'env': 'staging',
         'purpose': 'new_hardware_cert'
       }
    }"
    
    • 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'
       }
      
  4. Para usar um rótulo para filtrar a saída de um comando GET curl de um dispositivo de armazenamento de arquivos NFS da Solução Bare Metal, digite o ID e a região do projeto e, em seguida, anexe ?filter=labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para encontrar dispositivos de armazenamento de arquivos NFS com o rótulo do par de chave-valor env = staging.

    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.env=staging
    

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

Alguns comandos "gcloud" ou chamadas de API, como uma redefinição do servidor, podem levar muito tempo para serem concluídos. Se você quiser verificar o status de uma operação de longa duração, use as seguintes opções de comando:

gcloud

  1. 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 operations/OPERATION_ID
    

API

  1. Abra uma janela do terminal do Cloud Shell no Console do 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/v1/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
    }