Manter o ambiente da Solução Bare Metal

Depois que o ambiente da Solução Bare Metal estiver ativo e em execução, use as informações incluídas neste guia para a manutenção dos servidores dessa solução.

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.

   Observação: para ativar um serviço da API, você precisa ter um papel do IAM que conceda permissão para ativar serviços, como Proprietárioou Administrador do Service Usage. Consulte Controle de acesso para mais informações.

   Console

   1. Acesse a API Bare Metal Solution 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 da 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 ou a chave Retornar:

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

3. Permita que o SDK do Cloud funcione com seu projeto do Cloud.

   1. Na janela do Cloud Shell, insira 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 o SDK do Cloud.
   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.

Reiniciar um servidor da Solução Bare Metal

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

Siga as etapas de configuração da API

A reinicialização de um servidor requer a ativação da API da Solução Bare Metal e do SDK do Cloud. 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 Solução Bare Metal.

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

1. Abra uma janela do Console do Cloud.
2. Navegue até a instância de VM do jump host: Compute Engine (em inglês) >Instâncias de VM
3. Clique no botão SSH para se conectar à instância de VM do host jump.

4. 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 2021 from bms-ip-address
   [customeradmin@bms-server-name ~]$
    

5. Digite o comando top para verificar se o servidor está em execução. Use essa janela para monitorar o progresso da reinicialização.

Executar o comando de reinicialização

1. Abra a janela do Cloud Shell.

2. Adicione o ID do projeto do Cloud 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" \
    "https://baremetalsolution.googleapis.com/v1/projects/project-id/locations/loc/instances/bms-server-name:resetInstance" --header 'Content-Length: 0'
    

3. Copie e cole o comando na janela do Cloud Shell e pressione a tecla Enter ou Retornar.

   O servidor da Solução Bare Metal encerra e reinicia. Chaves abertas e fechadas {} aparecem como saída na janela do Cloud Shell. 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.

4. 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.

Observação: a operação de reinicialização é pausada por 30 minutos após a inserção do comando. Até que essa operação seja redefinida, não é possível reiniciar o servidor novamente. Você recebe uma mensagem de erro se tentar executar o comando. Aguarde e execute o comando novamente depois de 30 minutos.

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

Gerencie servidores no ambiente da Solução Bare Metal

As APIs de gerenciamento da Solução Bare Metal permitem que você veja o status dos dispositivos no ambiente da Solução Bare Metal. Para ver o status atual, siga estas etapas:

Configure a API Bare Metal Solution

A visualização do status do servidor requer a ativação da API Bare Metal Solution e do SDK do Cloud. 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 servidores, consulte Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution.

Execute comandos para visualizar os 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

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 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"
   

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"
   

gcloud

1. Para listar os servidores no ambiente da Solução Bare Metal e ver o status deles, emita o seguinte comando gcloud:

   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: exibe dispositivos em uma região específica do Google Cloud.
   • --limit: limita a saída para mostrar um número específico de dispositivos

2. Para receber informações de rede e armazenamento de um servidor no ambiente da Solução Bare Metal, emita o seguinte comando gcloud:

   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
   

   Observação: se você receber uma mensagem de erro informando que um comando gcloud bms não existe, tente atualizar o SDK do Cloud com o seguinte: comandos:

   • gcloud Components update (não funciona com o Cloud Shell) ou
   • sudo apt-get update && sudo apt-get --only-upgrade install google-cloud-sdk