Visualiza los detalles del sistema operativo

Usa OS Inventory Management a fin de recopilar y ver detalles del sistema operativo para las instancias de VM. Estos detalles incluyen información del sistema operativo, como el nombre de host, el sistema operativo y la versión de kernel, así como los paquetes instalados y las actualizaciones de paquetes disponibles para el sistema operativo. Si quieres obtener una lista de situaciones comunes para usar OS Inventory Management, consulta Cuándo usar OS Inventory Management.

Antes de poder usar OS Inventory Management, debes configurar las instancias de VM para usar la característica. A fin de configurar las instancias de VM para usar OS Inventory Management, debes completar los siguientes procedimientos:

Habilita los atributos de invitado y las claves de metadatos de OS Inventory en cada instancia o en todo el proyecto.
Instala el agente de configuración del SO en cada instancia.

Después de configurar OS Inventory Management en tus instancias de VM, podrás ver los detalles del sistema operativo.

Antes de comenzar

Si deseas usar los ejemplos de línea de comandos de esta guía, haz lo siguiente:
1. Instala la herramienta de línea de comandos de gcloud o actualízala a la última versión.
2. Configura una región y una zona predeterminadas.
Si deseas usar los ejemplos de API de esta guía, configura el acceso a la API.

Sistemas operativos compatibles

La Administración de inventario del SO es compatible con los siguientes sistemas operativos:

Debian 9
Ubuntu 16.04 y 18.04
CentOS 6 y 7
Red Hat Enterprise Linux 6, 7 y 8
Windows Server 2008R2, 2012R2, 2016, 2019 y versiones semestrales 1803 y 1809

Habilita atributos de invitado y OS Inventory Management

Para habilitar los atributos de invitado y OS Inventory Management, debes configurar algunas claves de metadatos específicas.

A fin de establecer metadatos personalizados para una instancia o proyecto, puedes usar Google Cloud Console, la herramienta de línea de comandos de gcloud o la API de Compute Engine. Puedes establecer estos atributos a nivel de instancia o de proyecto.

Console

Puedes aplicar los valores de metadatos en tus proyectos o instancias mediante una de las siguientes opciones:

Configura enable-guest-attributes y enable-os-inventory en los metadatos de la instancia cuando crees una instancia:

En Google Cloud Console, ve a la página Instancias de VM.
Ir a la página Instancias de VM
Haz clic en Crear instancia.
En la página Crear una instancia nueva, completa las propiedades que quieras para tu instancia.
En la sección Metadatos, agrega las siguientes entradas de metadatos:
- enable-guest-attributes y el valor es TRUE.
- enable-os-inventory y el valor es TRUE.
Haz clic en Crear para crear la instancia.

Configura enable-guest-attributes y enable-os-inventory en los metadatos de todo el proyecto para que se apliquen a todas las instancias del proyecto:

Ve a la página Metadatos.
Ir a la página de Metadatos
Haz clic en Editar.
Agrega las siguientes entradas de metadatos:
- enable-guest-attributes y el valor es TRUE.
- enable-os-inventory y el valor es TRUE.
Haz clic en Guardar para aplicar los cambios.

Configura enable-guest-attributes y enable-os-inventory en los metadatos de una instancia existente:

Ve a la página Instancias de VM.
Ir a la página Instancias de VM
Haz clic en el nombre de la instancia en la que deseas configurar el valor de los metadatos.
En la parte superior de la página de detalles de la instancia, haz clic en Editar para editar la configuración de la instancia.
En Metadatos personalizados, agrega las siguientes entradas de metadatos:
- enable-guest-attributes y el valor es TRUE.
- enable-os-inventory y el valor es TRUE.
En la parte inferior de la página de detalles de la instancia, haz clic en Guardar para aplicar los cambios en la instancia.

gcloud

Usa el comando project-info add-metadata de gcloud para habilitar los atributos de huésped y las claves de metadatos de OS Inventory.

Puedes aplicar los valores de metadatos enable-guest-attributes y enable-os-inventory en tus proyectos o instancias mediante una de las siguientes opciones:

Configura enable-guest-attributes y enable-os-inventory en los metadatos de todo el proyecto para que se apliquen a todas las instancias del proyecto:

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

en la que [PROJECT_ID] es el ID del proyecto.

Configura enable-guest-attributes y enable-os-inventory en los metadatos de una instancia existente:

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

En el ejemplo anterior, [INSTANCE_NAME] es el nombre de la instancia.

Configura enable-guest-attributes y enable-os-inventory en los metadatos de la instancia cuando crees una instancia:

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

En el ejemplo anterior, [INSTANCE_NAME] es el nombre de la instancia.

API

Si quieres obtener instrucciones para configurar metadatos en todo el proyecto, sigue las instrucciones de la API sobre cómo configurar metadatos personalizados en todo el proyecto.
Si quieres obtener instrucciones para configurar los metadatos de la instancia, sigue las instrucciones de la API sobre cómo configurar los metadatos de la instancia.

Los siguientes pares clave-valor son necesarios como valores de metadatos:

Atributos de invitado:
- Clave: enable-guest-attributes
- Valor: True
OS Inventory Management:
- Clave: enable-os-inventory
- Valor: True

Instala el agente de configuración del SO

En cada instancia, instala el agente de configuración del SO. Puedes instalar el agente de configuración del SO mediante una de las siguientes opciones:

Instala el agente de forma manual a través de la terminal.
Usa una secuencia de comandos de inicio en las instancias.

Instala el agente de forma manual

Usa esta opción para instalar el agente de configuración del SO en una instancia existente.

Para instalar el agente, completa los siguientes pasos:

Conéctate a la instancia en la que deseas instalar el agente de configuración del SO.

Instala el agente de configuración del SO.

Windows Server

Para instalar el agente de configuración del SO en un servidor de Windows, ejecuta el siguiente comando:

googet -noconfirm install google-osconfig-agent

Ubuntu

Configura el repositorio de Ubuntu.

En Ubuntu 16.04, ejecuta el siguiente comando:

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

En Ubuntu 18.04, ejecuta el siguiente comando:

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

Instala el agente de configuración del SO.

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

Debian

Para instalar el agente de configuración del SO en una instancia de Debian, ejecuta el siguiente comando:

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

RHEL/CENTOS

Para instalar el agente de configuración del SO en una instancia de RHEL o CentOS, ejecuta el siguiente comando:

sudo yum -y install google-osconfig-agent

Instala el agente mediante una secuencia de comandos de inicio

También puedes usar los comandos de instalación manual para crear una secuencia de comandos de inicio que instale el agente de configuración del SO durante la creación de la instancia.

Copia los comandos manuales de tu sistema operativo.

Proporciona la secuencia de comandos de inicio al método de creación de instancias.

Por ejemplo, si usas el comando de gcloud compute instances create para crear una nueva instancia de VM de Debian 9, tu comando será similar al siguiente:

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'

Verifica que la secuencia de comandos de inicio se complete. Para verificar si la secuencia de comandos de inicio se completa, puedes revisar los registros o comprobar la consola en serie.

Visualiza los detalles del sistema operativo

Visualiza datos de inventario

Para ver los datos de inventario de la instancia, usa el comando instances os-inventory describe.

A fin de ver los datos de inventario recopilados de una VM, ejecuta el siguiente comando:

gcloud compute instances os-inventory describe [INSTANCE_NAME]

en el que [INSTANCE_NAME] es el nombre de la instancia.

Para ver los tipos de detalles de salida que se muestran, revisa la Información proporcionada por OS Inventory Management.

Genera una lista de instancias

Para ver la lista de instancias de VM que tienen configurada OS Inventory Management, ejecuta el comando instances os-inventory list-instances.

Por ejemplo, para generar una lista de todas las instancias que tienen datos de inventario, ejecuta el siguiente comando:

gcloud compute instances os-inventory list-instances

El resultado debería ser similar al siguiente:

    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

También puedes usar filtros para reducir los resultados. Por ejemplo, puedes generar una lista de todas las instancias que tienen configurada OS Inventory Management y cuyo nombre de host coincide con la regex instance-* mediante la ejecución del siguiente comando:

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

El resultado debería ser similar al siguiente:

    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

Próximos pasos

Obtén más información sobre OS Inventory Management.