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:
- 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.
- 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:
- Instale ou atualize a ferramenta de linha de comando gcloud para a versão mais recente.
- 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:
- No Console do Google Cloud, acesse a página "Instâncias de VM".
- Clique em Criar instância.
- Na página Criar uma nova instância, preencha as propriedades pretendidas da instância.
Na seção Metadados, adicione as seguintes entradas de metadados:
enable-guest-attributes
e o valor éTRUE
.enable-os-inventory
e o valor éTRUE
.
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:
- Acesse a página "Metadados".
- Clique em Editar.
Adicione as seguintes entradas de metadados:
enable-guest-attributes
e o valor éTRUE
.enable-os-inventory
e o valor éTRUE
.
Clique em Salvar para aplicar as alterações.
Defina enable-guest-attributes
e enable-os-inventory
nos metadados de uma instância atual:
- Acesse a página "Instâncias de VM".
- Clique no nome da instância em que você quer definir o valor dos metadados.
- Para editar as configurações da instância, clique em Editar na parte superior da página de detalhes da instância.
Em Metadados personalizados, adicione as seguintes entradas de metadados:
enable-guest-attributes
e o valor éTRUE
.enable-os-inventory
e o valor éTRUE
.
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
- Chave:
- Gerenciamento de inventário do SO:
- Chave:
enable-os-inventory
- Valor:
True
- Chave:
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.