Cette page explique comment configurer et utiliser OS Inventory Management. Pour en savoir plus sur OS Inventory Management, consultez la page OS Inventory Management.
L'outil de gestion de l'inventaire du système d'exploitation permet de collecter et d'afficher les informations du système d'exploitation de vos instances de machine virtuelle (VM). Ces informations détaillées sur le système d'exploitation incluent par exemple le nom d'hôte, le système d'exploitation et la version du noyau. Vous pouvez également obtenir des informations sur les packages du système d'exploitation installés, les mises à jour disponibles, ainsi que les failles du système d'exploitation. Pour obtenir la liste des scénarios courants d'utilisation d'OS Inventory Management, consultez la section Cas d'utilisation d'OS Inventory Management.
Avant de commencer
- Consultez les quotas d'OS Config.
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud.
Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :
Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :
Console
Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init - Définissez une région et une zone par défaut.
REST
Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init -
Systèmes d'exploitation compatibles
Pour obtenir la liste complète des systèmes d'exploitation et des versions compatibles avec OS Inventory Management, consultez la page Détails des systèmes d'exploitation.
Rôles et autorisations requis
Pour obtenir les autorisations dont vous avez besoin pour répertorier et décrire les données d'inventaire, demandez à votre administrateur de vous attribuer le rôle IAM Lecteur d'inventaire d'OS(roles/osconfig.inventoryViewer) sur le projet.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Configurez votre VM.
Avant de pouvoir utiliser OS Inventory Management, vous devez configurer vos VM pour qu'elles exploitent cette fonctionnalité. Pour configurer vos VM afin qu'elles utilisent OS Inventory Management, configurez VM Manager.
Après avoir configuré VM Manager sur vos VM, vous pouvez afficher les données d'inventaire du système d'exploitation et les rapports de failles.
Afficher les données d'inventaire du système d'exploitation
Pour afficher les données d'inventaire du système d'exploitation, utilisez l'une des méthodes suivantes :
- Utiliser la console Google Cloud, gcloud CLI ou l'API OS Config
- Utiliser l'inventaire des éléments cloud
Afficher les données d'inventaire du système d'exploitation pour une VM
Vous pouvez utiliser la console Google Cloud, gcloud CLI ou l'API OS Config pour afficher les informations d'OS pour une VM spécifique.
Console
Pour afficher les failles du système d'exploitation et les informations sur les packages installés sur une VM à l'aide de la console Google Cloud, procédez comme suit :
- Dans Google Cloud Console, accédez à la page Instances de VM.
- Cliquez sur le nom de l'instance pour laquelle vous souhaitez afficher les informations du système d'exploitation. La page Détails de l'instance s'affiche.
- Cliquez sur l'onglet Informations du système d'exploitation.
Pour afficher les données d'inventaire du système d'exploitation, vous devez activer VM Manager. Si la console Google Cloud vous invite à activer VM Manager, sélectionnez l'une des options suivantes :- Activer pour le projet en cours : active VM Manager pour toutes les VM du projet sélectionné.
- Activer pour cette VM : active VM Manager uniquement pour la VM sélectionnée.
- Consultez la liste des failles du système d'exploitation et des packages installés dans l'onglet Informations sur le système d'exploitation.
- Facultatif : Si des mises à jour sont disponibles pour certains des packages installés, sélectionnez les noms de packages et cliquez sur Appliquer les mises à jour.
La page Correctif s'affiche. Pour en savoir plus sur l'utilisation de la fonctionnalité de correctif dans VM Manager, consultez la section Créer des jobs d'application de correctifs.
gcloud
Pour afficher les détails de l'inventaire pour une VM spécifique, exécutez la commande os-config inventories describe :
gcloud compute os-config inventories describe VM_NAME \
--location=ZONE \
--view=VIEW
Remplacez les éléments suivants :
VM_NAME: nom de votre VMZONE: zone où se trouve l'instance de VM.VIEW: type d'informations de sortie requis. Les types de vue suivants sont disponibles :basic: affiche uniquement les informations sur l'OSfull: affiche les informations sur l'OS et les packagesSi non spécifié, la valeur par défaut est
basic.
Exemple (affichage standard)
gcloud compute os-config inventories describe vm1-centos \ --location=us-central1-c
Exemple de résultat :
architecture: x86_64 hostname: vm1-centos kernelRelease: 3.10.0-1160.92.1.el7.x86_64 kernelVersion: '#1 SMP Tue Jun 20 11:48:01 UTC 2023' longName: CentOS Linux 7 (Core) osconfigAgentVersion: 20230504.00-g1.el7 shortName: centos updateTime: '2023-07-26T17:03:50Z' version: '7'
Exemple (affichage complet)
gcloud compute os-config inventories describe vm1-centos \ --location=us-central1-c \ --view=full
Exemple de résultat Linux
┌─────────────────────────────────────────────────────────────────────────────────────┐ │ Installed Packages (Yum) │ ├─────────────────────────────────────┬──────────────┬────────────────────────────────┤ │ PACKAGE_NAME │ ARCHITECTURE │ VERSION │ ├─────────────────────────────────────┼──────────────┼────────────────────────────────┤ │ GeoIP │ x86_64 │ 1.5.0-13.el7 │ │ NetworkManager │ x86_64 │ 1:1.12.0-8.el7_6 │ │ NetworkManager-libnm │ x86_64 │ 1:1.12.0-8.el7_6 │ │ NetworkManager-team │ x86_64 │ 1:1.12.0-8.el7_6 │ │ NetworkManager-tui │ x86_64 │ 1:1.12.0-8.el7_6 │ │ acl │ x86_64 │ 2.2.51-14.el7 │ │ yum-cron │ all │ 3.4.3-161.el7.centos │ │ yum-metadata-parser │ x86_64 │ 1.1.4-10.el7 │ │ yum-plugin-fastestmirror │ all │ 1.1.31-50.el7 │ │ zlib │ x86_64 │ 1.2.7-18.el7 │ └─────────────────────────────────────┴──────────────┴────────────────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────────┐ │ Package Updates Available (Yum) │ ├───────────────────────────────┬──────────────┬────────────────────────────────┤ │ PACKAGE_NAME │ ARCHITECTURE │ VERSION │ ├───────────────────────────────┼──────────────┼────────────────────────────────┤ │ GeoIP │ x86_64 │ 1.5.0-14.el7 │ │ NetworkManager │ x86_64 │ 1:1.18.8-2.el7_9 │ │ NetworkManager-libnm │ x86_64 │ 1:1.18.8-2.el7_9 │ │ NetworkManager-team │ x86_64 │ 1:1.18.8-2.el7_9 │ │ yum-cron │ all │ 3.4.3-168.el7.centos │ │ yum-plugin-fastestmirror │ all │ 1.1.31-54.el7_8 │ │ zlib │ x86_64 │ 1.2.7-19.el7_9 │ └───────────────────────────────┴──────────────┴────────────────────────────────┘ architecture: x86_64 hostname: vm1-centos kernelRelease: 3.10.0-957.1.3.el7.x86_64 kernelVersion: '#1 SMP Thu Nov 29 14:49:43 UTC 2018' longName: CentOS Linux 7 (Core) osconfigAgentVersion: 20230504.00-g1.el7 shortName: centos updateTime: '2021-05-11T22:21:52.323Z' version: '7'
Exemple de résultat Windows
┌───────────────────────────────────────────────────────────┐ │ Installed Packages (GooGet) │ ├───────────────────────┬──────────────┬────────────────────┤ │ PACKAGE_NAME │ ARCHITECTURE │ VERSION │ ├───────────────────────┼──────────────┼────────────────────┤ │ google-osconfig-agent │ x86_64 │ 20210415.4.0+win@1 │ └───────────────────────┴──────────────┴────────────────────┘ ┌───────────────────────────────────────────────────┐ │ Installed Packages (Windows Update Agent) │ ├───────┬────────────┬────────────────┬─────────────┤ │ TITLE │ CATEGORIES │ KB_ARTICLE_IDS │ SUPPORT_URL │ ├───────┼────────────┼────────────────┼─────────────┤ │ title │ C1, C2 │ 4589208 │ url.com │ └───────┴────────────┴────────────────┴─────────────┘ ┌───────────────────────────────────────────────────────────────┐ │ Installed Packages (Quick Fix Engineering) │ ├─────────┬─────────────────┬────────────┬──────────────────────┤ │ CAPTION │ DESCRIPTION │ HOT_FIX_ID │ INSTALL_TIME │ ├─────────┼─────────────────┼────────────┼──────────────────────┤ │ caption │ Security Update │ KB4470788 │ 2019-03-12T00:00:00Z │ └─────────┴─────────────────┴────────────┴──────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────┐ │ Installed Packages (Windows Application) │ ├──────────────────┬─────────────────┬───────────────────────┬──────────────┤ │ DISPLAY_NAME │ DISPLAY_VERSION │ PUBLISHER │ INSTALL_DATE │ ├──────────────────┼─────────────────┼───────────────────────┼──────────────┤ │ PowerShell 7-x64 │ 7.0.2.0 │ Microsoft Corporation │ 2021-06-08 │ └──────────────────┴─────────────────┴───────────────────────┴──────────────┘ ┌───────────────────────────────────────────────────────────┐ │ Package Updates Available (GooGet) │ ├───────────────────────┬──────────────┬────────────────────┤ │ PACKAGE_NAME │ ARCHITECTURE │ VERSION │ ├───────────────────────┼──────────────┼────────────────────┤ │ google-osconfig-agent │ x86_64 │ 20210415.4.0+win@1 │ └───────────────────────┴──────────────┴────────────────────┘ ┌───────────────────────────────────────────────────┐ │ Package Updates Available (Windows Update Agent) │ ├───────┬────────────┬────────────────┬─────────────┤ │ TITLE │ CATEGORIES │ KB_ARTICLE_IDS │ SUPPORT_URL │ ├───────┼────────────┼────────────────┼─────────────┤ │ title │ C1, C2 │ 4589208 │ url.com │ └───────┴────────────┴────────────────┴─────────────┘ ┌───────────────────────────────────────────────────────────────┐ │ Package Updates Available (Quick Fix Engineering) │ ├─────────┬─────────────────┬────────────┬──────────────────────┤ │ CAPTION │ DESCRIPTION │ HOT_FIX_ID │ INSTALL_TIME │ ├─────────┼─────────────────┼────────────┼──────────────────────┤ │ caption │ Security Update │ KB4470788 │ 2019-03-12T00:00:00Z │ └─────────┴─────────────────┴────────────┴──────────────────────┘ architecture: x86_64 hostname: vm3-windows kernelRelease: 10.0.17763.1817 kernelVersion: 10.0.17763.1817 (WinBuild.160101.0800) longName: Microsoft Windows Server 2019 Datacenter osconfigAgentVersion: 20210901.00.0+win@1 shortName: windows updateTime: '2021-09-12T22:14:35Z' version: 10.0.17763
REST
Pour afficher les détails de l'inventaire pour une VM spécifique, envoyez une requête GET à la méthode projects.locations.instances.inventories.get.
GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE/inventory
Remplacez l'élément suivant :
PROJECT_ID: ID de votre projet.ZONE: zone où se trouve l'instance de VM.INSTANCE: spécifiez l'ID d'instance ou le nom de votre VM.
Afficher les données d'inventaire du système d'exploitation pour les VM dans une zone spécifique
Vous pouvez afficher les informations sur le système d'exploitation des VM d'une zone spécifique à l'aide de gcloud CLI ou de l'API OS Config.
gcloud
Pour afficher la liste des données d'inventaire pour les VM d'une zone spécifique, exécutez la commande os-config inventories list.
gcloud compute os-config inventories list \
--location=ZONE \
--view=VIEW
Remplacez les éléments suivants :
ZONE: zone où se trouve la VMVIEW: type d'informations de sortie requis. Les types de vue suivants sont disponibles :basic: affiche uniquement les informations sur l'OSfull: affiche les informations sur l'OS et les packagesSi non spécifié, la valeur par défaut est
basic.
Exemple (affichage standard)
gcloud compute os-config inventories list \ --location=us-central1-c
Le résultat ressemble à ce qui suit :
INSTANCE_ID INSTANCE_NAME OS OSCONFIG_AGENT_VERSION UPDATE_TIME 29255009728795105 vm1-centos CentOS Linux 7 (Core) 20230504.00-g1.el7 2023-07-26T16:53:49Z 5138980234596718741 vm2-rhel8 Red Hat Enterprise Linux 8.8 (Ootpa) 20230504.00-g1.el8 2023-07-26T16:55:33Z 7127836223366142250 vm3-windows Microsoft Windows Server 2022 Datacenter 20230403.00.0+win@1 2023-07-26T16:49:16Z
Exemple (affichage complet)
gcloud compute os-config inventories list \ --location=us-central1-c \ --view=full
Le résultat ressemble à ce qui suit :
INSTANCE_ID INSTANCE_NAME OS INSTALLED_PACKAGES AVAILABLE_PACKAGES OSCONFIG_AGENT_VERSION UPDATE_TIME 29255009728795105 vm1-centos CentOS Linux 7 (Core) 334 2 20230504.00-g1.el7 2023-07-26T16:53:49Z 5932621394110773366 vm2-rhel8 Red Hat Enterprise Linux 8.8 (Ootpa) 410 138 20230504.00-g1.el8 2023-07-26T16:55:33Z 7127836223366142250 vm3-windows Microsoft Windows Server 2022 Datacenter 36 6 20230403.00.0+win@1 2023-07-26T16:49:16Z
REST
Pour afficher la liste des données d'inventaire pour les VM d'une zone spécifique, envoyez une requête GET à la méthode projects.locations.instances.inventories.list.
GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/–/inventories
Remplacez l'élément suivant :
PROJECT_ID: ID de votre projet.ZONE: zone où se trouvent les VM.
Afficher les données d'inventaire du système d'exploitation à partir de l'inventaire des éléments cloud
OS Inventory Management stocke et transfère les données des rapports d'inventaire et de failles vers l'inventaire des éléments cloud. Il s'agit d'un service d'inventaire de métadonnées qui vous permet d'afficher, de surveiller et d'analyser les éléments sur Google Cloud. Depuis l'inventaire des éléments cloud, vous pouvez interroger les informations et afficher les modifications dans les données.
Pour accéder aux données des rapports de failles et d'inventaire du système d'exploitation à partir de l'inventaire des éléments cloud, vous devez effectuer la configuration suivante :
- Configurez VM Manager.
- Dans votre projet Google Cloud, activez l'API Cloud Asset Inventory, Google Cloud CLI et attribuez des autorisations.
Pour en savoir plus, consultez la section Afficher les données VM Manager.
OS Inventory Management (version antérieure)
Si vous utilisez toujours la version antérieure d'OS Inventory Management, développez la section suivante pour consulter les instructions de Google Cloud CLI.
OS Inventory Management (version antérieure)
Répertorier les VMPour afficher la liste des VM pour lesquelles OS Inventory Management est configuré, exécutez la commande instances
os-inventory list-instances.
Par exemple, pour répertorier toutes les VM contenant des données d'inventaire, exécutez la commande suivante :
gcloud compute instances os-inventory list-instances
Le résultat ressemble à ce qui suit :
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
Vous pouvez également utiliser des filtres pour affiner les résultats. Vous pouvez par exemple répertorier toutes les VM pour lesquelles OS Inventory Management est configuré et dont le nom d'hôte correspond à l'expression régulière instance-* en exécutant la commande suivante :
gcloud compute instances os-inventory list-instances
--inventory-filter="Hostname~instance-*"Le résultat ressemble à ce qui suit :
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
Pour afficher les données d'inventaire de votre VM, utilisez la commande instances
os-inventory describe.
Pour afficher les données d'inventaire collectées pour une VM, exécutez la commande suivante :
gcloud compute instances os-inventory describe VM_NAME \
--zone=ZONERemplacez l'élément suivant :
VM_NAME: nom de votre VMZONE: zone où se trouve la VM
Pour connaître les types d'informations affichés dans les résultats, consultez la section Informations fournies par OS Inventory Management.
Étapes suivantes
- Affichez les rapports de failles de vos systèmes d'exploitation.
- Obtenez plus d'informations sur OS Inventory Management.