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 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.
Accéder à 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 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 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 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 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 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 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'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 l'élément suivant :

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 la section 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.