Visualiza los detalles del sistema operativo

En esta página, se describe cómo configurar y usar OS Inventory Management. Para obtener una descripción general de OS Inventory Management, consulta Administración del inventario del SO.

Usa OS Inventory Management a fin de recopilar y ver detalles del sistema operativo para las instancias de VM. Estos detalles del sistema operativo incluyen información 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 la sección 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:

1. Habilita los atributos de invitado y las claves de metadatos del inventario del SO en cada instancia o en todo el proyecto.
2. 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 en esta guía, haz lo siguiente:
  1. Instala o actualiza la versión más reciente de la herramienta de línea de comandos de gcloud.
  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

Para obtener una lista completa de los sistemas operativos y las versiones compatibles con OS Inventory Management, consulta Detalles de los sistemas operativos.

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:

1. En Google Cloud Console, ve a la página Instancias de VM.

   Ir a la página Instancias de VM

2. Haz clic en Crear instancia.
3. En la página Crear una instancia nueva, completa las propiedades que quieras para tu instancia.

4. 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.

5. 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:

1. Ve a la página Metadatos.

   Ir a la página de Metadatos

2. Haz clic en Editar.

3. Agrega las siguientes entradas de metadatos:

   • enable-guest-attributes y el valor es TRUE.
   • enable-os-inventory y el valor es TRUE.

4. Haz clic en Guardar para aplicar los cambios.

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

1. Ve a la página Instancias de VM.

   Ir a la página Instancias de VM

2. Haz clic en el nombre de la instancia en la que deseas configurar el valor de los metadatos.
3. 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.

4. 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.

5. 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 gcloud para habilitar los atributos de invitado y las claves de metadatos del inventario del SO.

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: Reemplaza project-id por el ID del proyecto.

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

Configura enable-guest-attributes y enable-os-inventory en los metadatos de una instancia existente. Reemplaza instance-name por el nombre de tu instancia.

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

Configura enable-guest-attributes y enable-os-inventory en los metadatos de la instancia cuando crees una instancia. Reemplaza instance-name por el nombre de tu instancia.

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

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.

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. Reemplaza instance-name por el nombre de tu instancia.

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

gcloud compute instances os-inventory describe instance-name

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

Genera una lista de instancias

Para ver la lista de instancias de VM configuradas en SO 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    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

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    e2-standard-2               192.0.2.2                RUNNING
instance-inventory2  asia-east2-b  e2-standard-2               192.0.2.3                RUNNING

Próximos pasos

• Obtén más información sobre Administración del inventario del SO.