Como ver detalhes do sistema operacional

Nesta página, explicamos como configurar e usar o Gerenciamento de inventário do SO. Para uma visão geral do gerenciamento de inventário do sistema operacional, consulte Gerenciamento de inventário do SO.

Use o Gerenciamento de inventário do SO para coletar e visualizar detalhes do sistema operacional para as instâncias de VM. Esses detalhes incluem informações como nome do host, sistema operacional e versão do kernel, além de pacotes instalados e atualizações de pacotes disponíveis para o sistema operacional. Consulte Quando usar o Gerenciamento de inventário do SO para ver uma lista de cenários comuns para usá-lo.

Antes de usar esse recurso, é necessário configurar as instâncias de VM. Siga os procedimentos abaixo para configurar as instâncias de VM para usar o Gerenciamento de inventário do SO:

1. Ative os atributos de convidado e as chaves de metadados do inventário do sistema operacional em cada instância ou em todo o projeto.
2. Instale o agente de configuração do SO em cada instância.

Depois que o Gerenciamento de inventário do SO estiver configurado nas instâncias de VM, será possível visualizar os detalhes do sistema operacional.

Antes de começar

• Para usar os exemplos de linha de comando deste guia, siga estas etapas:
  1. Instale ou atualize a ferramenta de linha de comando gcloud para a versão mais recente.
  2. Defina uma região e uma zona padrão.
• Para usar os exemplos de API deste guia, configure o acesso à API.

Sistemas operacionais compatíveis

Para ver a lista completa de sistemas operacionais e versões compatíveis com o gerenciamento de inventário do SO, consulte Detalhes do sistema operacional.

Ativar atributos de convidado e o OS Inventory Management

Para ativar atributos de guest e o Gerenciamento de inventário do SO, é preciso configurar algumas chaves de metadados específicas.

Para definir metadados personalizados para uma instância ou um projeto, use o Console do Google Cloud, a ferramenta de linha de comando gcloud ou a API Compute Engine. Esses atributos podem ser definidos no nível da instância ou para envolvidos no projeto.

Console

É possível aplicar os valores de metadados em projetos ou instâncias usando uma das seguintes opções:

Defina enable-guest-attributes e enable-os-inventory nos metadados de uma instância ao criá-la:

1. No Console do Google Cloud, acesse a página "Instâncias de VM".

   Acessar a página "Instâncias de VM"

2. Clique em Criar instância.
3. Na página Criar uma nova instância, preencha as propriedades pretendidas da instância.

4. Na seção Metadados, adicione as seguintes entradas de metadados:

   • enable-guest-attributes e o valor é TRUE.
   • enable-os-inventory e o valor é TRUE.

5. Clique em Criar para criar a instância.

Defina enable-guest-attributes e enable-os-inventory nos metadados de todo o projeto para que sejam aplicáveis a todas as instâncias no projeto:

1. Acesse a página "Metadados".

   Acessar a página "Metadados"

2. Clique em Editar.

3. Adicione as seguintes entradas de metadados:

   • enable-guest-attributes e o valor é TRUE.
   • enable-os-inventory e o valor é TRUE.

4. Clique em Salvar para aplicar as alterações.

Defina enable-guest-attributes e enable-os-inventory nos metadados de uma instância atual:

1. Acesse a página "Instâncias de VM".

   Acessar a página "Instâncias de VM"

2. Clique no nome da instância em que você quer definir o valor dos metadados.
3. Para editar as configurações da instância, clique em Editar na parte superior da página de detalhes da instância.

4. Em Metadados personalizados, adicione as seguintes entradas de metadados:

   • enable-guest-attributes e o valor é TRUE.
   • enable-os-inventory e o valor é TRUE.

5. Na parte inferior da página de detalhes da instância, clique em Salvar para aplicar as alterações à instância.

gcloud

Use o comando gcloud de project-info add-metadata para ativar atributos de guest e chaves de metadados do inventário do SO.

É possível aplicar os valores de metadados enable-guest-attributes e enable-os-inventory em projetos ou instâncias usando uma das seguintes opções:

Defina enable-guest-attributes e enable-os-inventory nos metadados de todo o projeto para que sejam aplicáveis a todas as instâncias no projeto. Substitua project-id pelo ID do projeto.

gcloud compute project-info add-metadata \
    --project project-id \
    --metadata=enable-guest-attributes=true,enable-os-inventory=true

Defina enable-guest-attributes e enable-os-inventory nos metadados de uma instância atual. Substitua instance-name pelo nome da instância.

gcloud compute instances add-metadata instance-name \
    --metadata=enable-guest-attributes=true,enable-os-inventory=true

Defina enable-guest-attributes e enable-os-inventory nos metadados de uma instância ao criá-la. Substitua instance-name pelo nome da instância.

gcloud compute instances create instance-name \
    --metadata=enable-guest-attributes=true,enable-os-inventory=true

API

• Siga as instruções da API sobre Como configurar metadados personalizados para todo o projeto para saber mais.
• Siga as instruções da API sobre Como configurar metadados da instância para saber mais.

Estes pares de chave-valor são obrigatórios como valores de metadados:

• Atributos de guest:
  • Chave: enable-guest-attributes
  • Valor: True
• Gerenciamento de inventário do SO:
  • Chave: enable-os-inventory
  • Valor: True

Instalar o agente de configuração do SO

Em cada instância, instale o agente de configuração do SO.

Como ver os detalhes do sistema operacional

Como ver dados do inventário

Para visualizar os dados de inventário da instância, use o comando instances os-inventory describe. Substitua instance-name pelo nome da instância.

Para ver os dados do inventário coletados para uma VM, execute o comando a seguir:

gcloud compute instances os-inventory describe instance-name

Para visualizar os tipos de detalhes de saída retornados, consulte Informações fornecidas pelo Gerenciamento de inventário do SO.

Como listar instâncias

Para visualizar a lista de instâncias de VM que têm o Gerenciamento de inventário do SO configurado, execute o comando instances os-inventory list-instances.

Por exemplo, para listar todas as instâncias que têm dados de inventário, execute o comando a seguir:

gcloud compute instances os-inventory list-instances

A resposta será parecida com esta:

NAME                  ZONE        MACHINE_TYPE   PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP  STATUS
inventory-instance   us-east1-b    e2-standard-2               192.0.2.1                RUNNING
instance-inventory1  us-west1-b    e2-standard-2               192.0.2.2                RUNNING
instance-inventory2  asia-east2-b  e2-standard-2               192.0.2.3                RUNNING

Também é possível usar filtros para restringir os resultados. Por exemplo, execute o comando a seguir para listar todas as instâncias que têm o Gerenciamento de inventário do SO configurado e o nome do host correspondente ao regex instance-*:

gcloud compute instances os-inventory list-instances --inventory-filter="Hostname~instance-*"

A resposta será parecida com esta:

NAME                  ZONE        MACHINE_TYPE   PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP  STATUS
instance-inventory1  us-west1-b    e2-standard-2               192.0.2.2                RUNNING
instance-inventory2  asia-east2-b  e2-standard-2               192.0.2.3                RUNNING

A seguir

• Saiba mais sobre o Gerenciamento de inventário do SO.