Afficher les données d'inventaire du système d'exploitation

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 nécessaires

Pour obtenir les autorisations dont vous avez besoin pour lister 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 Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Configurer 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, vous disposez des méthodes suivantes :
- Utiliser la consoleGoogle Cloud , la 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 , la gcloud CLI ou l'API OS Config pour afficher les informations sur l'OS pour une VM spécifique.

Console

Pour afficher les failles du système d'exploitation et les informations concernant les packages installés sur une VM à l'aide de la console Google Cloud , procédez comme suit :

Dans la console Google Cloud , accédez à la page Instances de VM.
Accéder à la page "Instances de VM"
Cliquez sur le nom de l'instance pour laquelle vous souhaitez afficher les informations sur le système d'exploitation. La page Détails de l'instance s'affiche.
Cliquez sur l'onglet Informations sur l'OS.
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 l'OS.
Facultatif : Si des mises à jour sont disponibles pour certains des packages installés, sélectionnez les noms de ces packages et cliquez sur Appliquer les mises à jour.
La page Correctif s'affiche. Pour en savoir plus sur l'utilisation de la fonctionnalité Patch (correctif) dans VM Manager, consultez 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 VM
ZONE : 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'OS
full : affiche les informations sur l'OS et les packages

Si cet élément n'est pas 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 les éléments suivants :

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 d'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 la 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 VM

VIEW : type d'informations de sortie requis. Les types de vue suivants sont disponibles :

basic : affiche uniquement les informations sur l'OS
full : affiche les informations sur l'OS et les packages

Si cet élément n'est pas 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 les éléments suivants :

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 les données des rapports d'inventaire et de failles et les transfère vers l'inventaire des éléments cloud. Ce dernier est un service d'inventaire de métadonnées qui vous permet d'afficher, de surveiller et d'analyser les éléments pour l'ensemble de votre solution Google Cloud. Depuis l'inventaire des éléments cloud, vous pouvez interroger les informations et visualiser 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 ainsi que la Google Cloud CLI, et attribuez des autorisations.

Pour en savoir plus, consultez 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 spécifiques à la Google Cloud CLI.

OS Inventory Management (version antérieure)

Lister les VM

Pour afficher la liste des VM pour lesquelles OS Inventory Management est configuré, exécutez la commande instances os-inventory list-instances.

Par exemple, pour recenser toutes les instances comportant 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 lister 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'inventaire

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=ZONE

Remplacez les éléments suivants :

VM_NAME : nom de votre VM
ZONE : zone où se trouve la VM

Pour connaître les types d'informations affichés dans les résultats, consultez Informations fournies par OS Inventory Management.

Étapes suivantes

Affichez les rapports de failles pour vos systèmes d'exploitation.
Obtenez plus d'informations sur OS Inventory Management.

Afficher les données d'inventaire du système d'exploitation Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Systèmes d'exploitation compatibles

Rôles et autorisations nécessaires

Configurer votre VM

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

Console

gcloud

Exemple de résultat :

Exemple de résultat Linux

Exemple de résultat Windows

REST

Afficher les données d'inventaire du système d'exploitation pour les VM d'une zone spécifique

gcloud

REST

Afficher les données d'inventaire du système d'exploitation à partir de l'inventaire des éléments cloud

OS Inventory Management (version antérieure)

OS Inventory Management (version antérieure)

Étapes suivantes

Afficher les données d'inventaire du système d'exploitation