Visualiza los detalles del sistema operativo

Usa la Administración de inventario del SO 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 la Administración del inventario del SO, revisa la página sobre cuándo usar la Administración del inventario del SO.

Antes de poder usar la Administración de inventario del SO, debes configurar las instancias de VM para usar la función. A fin de configurar las instancias de VM para usar la Administración de inventario del SO, 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 la Administración de inventario del SO en tus instancias de VM, podrás ver los detalles del sistema operativo.

Antes de comenzar

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 los atributos de invitado y la administración de inventario del SO

Para habilitar los atributos de invitado y la administración de inventario del SO, debes configurar algunas claves de metadatos específicas.

A fin de establecer metadatos personalizados para una instancia o proyecto, puedes usar Google Cloud Platform Console, la herramienta de línea de comandos 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 Platform 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 aplique a todas las instancias del proyecto:

  1. Ve a la página de 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 de instancias de VM.

    Ir a la página Instancias de VM

  2. Haz clic en el nombre de la instancia en la que deseas establecer 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 huésped y las claves de metadatos del inventario del SO.

Puedes aplicar el valor de metadatos enable-oslogin en los 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 aplique 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 la que [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 que [INSTANCE_NAME] es el nombre de la instancia.

API

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

  • Atributos de huésped:
    • Clave: enable-guest-attributes
    • Valor: True
  • Administración del inventario del SO:
    • 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

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:

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

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

    1. Configura el repositorio de 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. 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
    

    Si recibes un mensaje de error Unable to locate package, debes configurar el repositorio de Debian. Para configurar el repositorio de Debian, ejecuta el siguiente 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 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.

  1. Copia los comandos manuales de tu sistema operativo.
  2. Proporciona la secuencia de comandos de inicio al método de creación de instancias.

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

    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. Comprueba que la secuencia de comandos de inicio se complete. Para verificar que la secuencia de comandos de inicio se complete, 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 la Administración de inventario del SO.

Genera una lista de instancias

Para ver la lista de instancias de VM que tienen configurada la Administración de inventario del SO, 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 la Administración de inventario del SO 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

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Compute Engine