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.
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.
Ative a API Bare Metal Solution no projeto do Cloud.
Console
- 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.
- Na página da API Bare Metal Solution, clique em Ativar.
- 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
Permita que a Google Cloud CLI funcione com seu projeto do Cloud.
- Na janela do Cloud Shell, digite o comando
gcloud auth login
.gcloud auth login
- Copie o URL resultante e cole-o em outra janela ou guia do navegador.
- Faça login na página usando seu nome de usuário associado ao projeto do Cloud.
- Clique em Permitir para ativar a CLI gcloud.
- Copie o código de autorização.
- Cole o código na linha de comando do cliente do Cloud Shell.
- Pressione a tecla Enter ou Retornar.
- Na janela do Cloud Shell, digite o comando
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
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 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.
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]
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.Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
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.
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]
Na maioria dos casos, a energia do servidor permanece ligada. Se você precisar desligar a energia, use as seguintes opções:Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
- 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
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 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.
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
top
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
- 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.
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.
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
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
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
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
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
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
Abra uma janela do terminal do Cloud Shell no Console do Google Cloud.
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 Retornocurl -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"
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"
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'} }"
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
No Console do Google Cloud, navegue para Compute Engine > Solução Bare Metal > Redes.
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
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
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
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
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
Abra uma janela do terminal do Cloud Shell no Console do Cloud.
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"
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"
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'} }"
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
No Console do Cloud, navegue até Compute Engine > Solução Bare Metal > Volumes.
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
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
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
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
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
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
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
Abra uma janela do terminal do Cloud Shell no Console do Cloud.
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"
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"
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
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"
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'} }"
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
No Console do Cloud, navegue até Compute Engine > Solução Bare Metal > Compartilhamentos de NFS.
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
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"}]
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
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
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
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"
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"
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' }
- Se você emitir o comando
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
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
Abra uma janela do terminal do Cloud Shell no Console do Cloud.
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 comotrue
na saída.{ "name": "operations/OPERATION_ID", "done": true }