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:
- Habilita los atributos de invitado y las claves de metadatos del inventario del SO en cada instancia o en todo el proyecto.
- 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
- Si deseas usar los ejemplos de línea de comandos de esta guía, haz lo siguiente:
- Instala la última versión de la herramienta de línea de comandos de gcloud.
- Configura una región y una zona predeterminadas.
- Si quieres usar los ejemplos de la 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 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:
- En Google Cloud Platform Console, ve 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 esTRUE
.enable-os-inventory
y el valor esTRUE
.
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:
- Ve a la página de Metadatos.
- Haz clic en Editar.
Agrega las siguientes entradas de metadatos:
enable-guest-attributes
y el valor esTRUE
.enable-os-inventory
y el valor esTRUE
.
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 de instancias de VM.
- Haz clic en el nombre de la instancia en la que deseas establecer 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 esTRUE
.enable-os-inventory
y el valor esTRUE
.
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
- 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 huésped:
- Clave:
enable-guest-attributes
- Valor:
True
- Clave:
- Administración del inventario del SO:
- Clave:
enable-os-inventory
- Valor:
True
- Clave:
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.
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 -
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.
- 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
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'
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
- Obtén más información sobre la Administración de inventario del SO.