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 :
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init - Set a default region and zone.
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
- 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. 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
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.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
PROJECT_ID: ID de votre projet.ZONE: zone où se trouvent les VM.- Configurez VM Manager.
- Dans votre projet Google Cloud, activez l'API Cloud Asset Inventory, Google Cloud CLI et attribuez des autorisations.
VM_NAME: nom de votre VMZONE: zone où se trouve la VM- Affichez les rapports de failles de vos systèmes d'exploitation.
- Obtenez plus d'informations sur OS Inventory Management.
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 initPour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.
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
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 :
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=VIEWRemplacez les éléments suivants :
REST
Pour afficher les détails de l'inventaire pour une VM spécifique, envoyez une requête
GETà la méthodeprojects.locations.instances.inventories.get.GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE/inventory
Remplacez l'élément suivant :
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=VIEWRemplacez les éléments suivants :
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éthodeprojects.locations.instances.inventories.list.GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/–/inventories
Remplacez l'élément suivant :
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 :
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
Afficher les données d'inventairePour 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 :
Pour connaître les types d'informations affichés dans les résultats, consultez la section Informations fournies par OS Inventory Management.
Étapes suivantes
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/11/21 (UTC).
-