Como ver detalhes do sistema operacional

Use o gerenciamento de inventário do SO para coletar e visualizar detalhes do sistema operacional para suas instâncias de VM. Esses detalhes incluem informações do sistema operacional, como nome do host, sistema operacional e versão do kernel, bem como 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 o Gerenciamento de inventário do sistema operacional, configure suas instâncias de VM para utilizá-lo. 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 SO em cada instância ou no projeto inteiro.
  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

Sistemas operacionais compatíveis

O gerenciamento de inventário do SO é compatível com os sistemas operacionais a seguir:

  • Debian 9
  • Ubuntu 16.04 e 18.04
  • CentOS 6 e 7
  • Red Hat Enterprise Linux 6, 7 e 8
  • Windows Server 2008R2, 2012R2, 2016, 2019 e versões semestrais 1803 e 1809

Ativar atributos de convidado e o gerenciamento de inventário do SO

Para ativar atributos de convidado 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 Platform, a ferramenta de linha de comando da 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 Platform, acesse a página "Instâncias de VMs".

    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 project-info add-metadatagcloud para ativar atributos de convidado e chaves de metadados do inventário do SO.

É possível aplicar o valor de metadados enable-oslogin a projetos ou instâncias usando uma destas 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:

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

em que [PROJECT_ID] é o ID do projeto.

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

gcloud compute instances add-metadata [INSTANCE_NAME] \
    --metadata=enable-guest-attributes=true,enable-os-inventory=true

em que [INSTANCE_NAME] é o nome da instância.

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

gcloud compute instances create [INSTANCE_NAME] \
    --metadata=enable-guest-attributes=true,enable-os-inventory=true

em que [INSTANCE_NAME] é o nome da instância.

API

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

  • Atributos de convidado:
    • 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 sistema operacional. É possível instalar o agente de configuração do SO usando uma destas opções:

Como instalar o agente manualmente

Use essa opção para instalar o agente de configuração do sistema operacional em uma instância atual.

Para instalar o agente, siga estas etapas:

  1. Conecte-se à instância em que você quer instalar o agente de configuração do SO.

  2. Instale o agente de configuração do SO.

    Windows Server

    Para instalar o agente de configuração do SO em um servidor Windows, execute o seguinte comando:

    googet -noconfirm install google-osconfig-agent
    

    Ubuntu

    1. Configure o repositório do Ubuntu.

      sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-osconfig-agent-stretch-stable main' > \
      /etc/apt/sources.list.d/google-osconfig-agent.list"
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
      
    2. Instale o agente de configuração do SO.

      sudo apt-get update
      sudo apt-get install -y google-osconfig-agent
      

    Debian

    Para instalar o agente de configuração do SO em uma instância do Debian, execute o seguinte comando:

    sudo apt-get update
    sudo apt-get install -y google-osconfig-agent
    

    Se você receber uma mensagem de erro Unable to locate package, precisará configurar o repositório do Debian. Para configurar o repositório do Debian, execute o seguinte comando:

    sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-osconfig-agent-stretch-stable main' > \
    /etc/apt/sources.list.d/google-osconfig-agent.list"
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
    

    RHEL/CENTOS

    Para instalar o agente de configuração do SO em uma instância do RHEL ou do CentOS, execute o seguinte comando:

    sudo yum -y install google-osconfig-agent
    

Como instalar o agente usando um script de inicialização

Também é possível usar os comandos de instalação manual para criar um script de inicialização que instale o agente de configuração do SO durante a criação da instância.

  1. Copie os comandos manuais relativos ao seu sistema operacional.
  2. Forneça o script de inicialização ao método de criação de instância.

    Por exemplo, se você estiver usando o comando gcloud compute instances create para criar uma nova instância de VM do Debian 9, seu comando terá esta aparência:

    gcloud compute instances create INSTANCE_NAME \
        --image-family=debian-9 --image-project=debian-cloud \
        --metadata startup-script='#! /bin/bash
        sudo apt-get update
        sudo apt-get install -y google-osconfig-agent'
    
  3. Verifique se o script de inicialização foi concluído. Para isso, analise os registros ou confira o console serial.

Como ver 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.

Para visualizar os dados de inventário coletados para uma VM, execute o seguinte comando:

gcloud compute instances os-inventory describe [INSTANCE_NAME]

em que [INSTANCE_NAME] é o nome da instância.

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 ver 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    n1-standard-1               192.0.2.1                RUNNING
instance-inventory1  us-west1-b    n1-standard-1               192.0.2.2                RUNNING
instance-inventory2  asia-east2-b  n1-standard-1               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 de SO configurado e o nome de 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    n1-standard-1               192.0.2.2                RUNNING
instance-inventory2  asia-east2-b  n1-standard-1               192.0.2.3                RUNNING

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Compute Engine