Afficher les détails des systèmes d'exploitation

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 pour vos instances de VM. Celles-ci comprennent des informations sur le système d'exploitation telles que le nom d'hôte, le système d'exploitation et la version du noyau, ou encore les packages installés et les mises à jour disponibles pour le système d'exploitation. Pour obtenir la liste des scénarios courants d'utilisation de la gestion de l'inventaire du système d'exploitation, consultez la section Cas d'utilisation de la gestion de l'inventaire du système d'exploitation.

Vous devez configurer vos instances de VM avant de pouvoir utiliser la fonctionnalité de gestion de l'inventaire du système d'exploitation. Pour configurer vos instances de VM afin de pouvoir utiliser cette fonctionnalité, vous devez procéder comme suit :

  1. Activez les attributs d'invité et les clés de métadonnées de l'inventaire du système d'exploitation sur chaque instance ou sur l'ensemble du projet.
  2. Installez l'agent de configuration du système d'exploitation sur chaque instance.

Après avoir configuré la gestion de l'inventaire du système d'exploitation sur vos instances de VM, vous pouvez afficher les informations du système d'exploitation.

Avant de commencer

Systèmes d'exploitation compatibles

La fonctionnalité de gestion de l'inventaire du système d'exploitation est compatible avec les systèmes d'exploitation suivants :

  • Debian 9
  • Ubuntu 16.04 et 18.04
  • CentOS 6 et 7
  • Red Hat Enterprise Linux 6, 7 et 8
  • Windows Server 2008 R2, 2012 R2, 2016, 2019 et les versions semestrielles 1803 et 1809

Activer les attributs d'invité et la fonctionnalité de gestion de l'inventaire du système d'exploitation

Pour activer les attributs d'invité et la gestion d'inventaire du système d'exploitation, vous devez définir des clés de métadonnées spécifiques.

Utilisez la console Google Cloud Platform, l'outil de ligne de commande gcloud ou l'API Compute Engine pour définir des métadonnées personnalisées pour une instance ou un projet. Ces attributs peuvent être définis au niveau de l'instance ou du projet.

Console

Vous pouvez appliquer les valeurs des métadonnées à vos projets ou à vos instances en utilisant l'une des options suivantes :

Définissez enable-guest-attributes et enable-os-inventory dans les métadonnées de l'instance lorsque vous créez une instance :

  1. Dans la console GCP, accédez à la page "Instances de VM".

    Accéder à la page "Instances de VM"

  2. Cliquez sur Créer une instance.
  3. Sur la page Créer une instance, spécifiez les propriétés souhaitées pour votre instance.
  4. Dans la section Métadonnées, ajoutez les entrées de métadonnées suivantes :

    • enable-guest-attributes avec la valeur TRUE
    • enable-os-inventory avec la valeur TRUE
  5. Cliquez sur Créer pour créer l'instance.

Définissez enable-guest-attributes et enable-os-inventory dans les métadonnées à l'échelle du projet, afin que ces paramètres s'appliquent à toutes les instances de votre projet :

  1. Accédez à la page "Métadonnées"

    Accéder à la page "Métadonnées"

  2. Cliquez sur Modifier.
  3. Ajoutez les entrées de métadonnées suivantes :

    • enable-guest-attributes avec la valeur TRUE
    • enable-os-inventory avec la valeur TRUE
  4. Cliquez sur Enregistrer pour appliquer les modifications.

Définissez enable-guest-attributes et enable-os-inventory dans les métadonnées d'une instance existante :

  1. Accédez à la page des instances de VM.

    Accéder à la page "Instances de VM"

  2. Cliquez sur le nom de l'instance sur laquelle vous souhaitez définir la valeur de métadonnées.
  3. En haut de la page des détails de l'instance, cliquez sur Modifier pour modifier les paramètres de l'instance.
  4. Dans la section Métadonnées personnalisées, ajoutez les entrées de métadonnées suivantes :

    • enable-guest-attributes avec la valeur TRUE
    • enable-os-inventory avec la valeur TRUE
  5. En bas de la page des détails de l'instance, cliquez sur Enregistrer pour appliquer vos modifications à l'instance.

gcloud

Utilisez la commande gcloud project-info add-metadata pour activer les attributs d'invité et les clés de métadonnées de l'inventaire du système d'exploitation.

Vous pouvez appliquer la valeur de métadonnées enable-oslogin à vos projets ou instances en utilisant l'une des options suivantes :

Définissez enable-guest-attributes et enable-os-inventory dans les métadonnées à l'échelle du projet, afin que ces paramètres s'appliquent à toutes les instances de votre projet :

gcloud compute project-info add-metadata \
  --project [PROJECT_ID] \
  --metadata=enable-guest-attributes=true,enable-os-inventory=true

[PROJECT_ID] correspond à l'ID de votre projet.

Définissez enable-guest-attributes et enable-os-inventory dans les métadonnées d'une instance existante :

gcloud compute instances add-metadata [INSTANCE_NAME] \
  --metadata=enable-guest-attributes=true,enable-os-inventory=true

[INSTANCE_NAME] est le nom de l'instance.

Définissez enable-guest-attributes et enable-os-inventory dans les métadonnées de l'instance lorsque vous créez une instance :

gcloud compute instances create [INSTANCE_NAME] \
  --metadata=enable-guest-attributes=true,enable-os-inventory=true

[INSTANCE_NAME] est le nom de l'instance.

API

Les paires clé/valeur suivantes sont requises comme valeurs de métadonnées :

  • Attributs d'invité :
    • Clé : enable-guest-attributes
    • Valeur : True
  • Gestion de l'inventaire du système d'exploitation :
    • Clé : enable-os-inventory
    • Valeur : True

Installer l'agent de configuration du système d'exploitation

Installez l'agent de configuration du système d'exploitation sur chaque instance. Pour ce faire, utilisez l'une des options suivantes :

Installer l'agent manuellement

Utilisez cette option pour installer l'agent de configuration du système d'exploitation sur une instance existante.

Pour installer l'agent, procédez comme suit :

  1. Connectez-vous à l'instance sur laquelle vous souhaitez installer l'agent de configuration du système d'exploitation.

  2. Installez l'agent de configuration du système d'exploitation.

    Windows Server

    Pour installer l'agent de configuration du système d'exploitation sur un serveur Windows, exécutez la commande suivante :

    googet -noconfirm install google-osconfig-agent
    

    Ubuntu

    1. Configurez le dépôt 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 -
      
    2. Installez l'agent de configuration du système d'exploitation.

      sudo apt-get update
      sudo apt-get install -y google-osconfig-agent
      

    Debian

    Pour installer l'agent de configuration du système d'exploitation sur une instance Debian, exécutez la commande suivante :

    sudo apt-get update
    sudo apt-get install -y google-osconfig-agent
    

    Si le message d'erreur Unable to locate package s'affiche, vous devez configurer le dépôt Debian. Pour ce faire, exécutez la commande suivante :

    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

    Pour installer l'agent de configuration du système d'exploitation sur une instance RHEL ou CentOS, exécutez la commande suivante :

    sudo yum -y install google-osconfig-agent
    

Installer l'agent à l'aide d'un script de démarrage

Vous pouvez également utiliser les commandes d'installation manuelles pour créer un script de démarrage qui installe l'agent de configuration du système d'exploitation lors de la création de l'instance.

  1. Copiez les commandes manuelles correspondant à votre système d'exploitation.
  2. Fournissez le script de démarrage à votre méthode de création d'instance.

    Par exemple, si vous utilisez la commande gcloud compute instances create pour créer une instance de machine virtuelle Debian 9, votre commande se présente comme suit :

    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'
    
  3. Vérifiez que le script de démarrage est terminé. Pour vérifier si un script de démarrage est terminé, vous pouvez consulter les journaux ou examiner la console série.

Afficher les détails des systèmes d'exploitation

Afficher les données d'inventaire

Pour afficher les données d'inventaire de votre instance, 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 beta compute instances os-inventory describe [INSTANCE_NAME]

[INSTANCE_NAME] est le nom de l'instance.

Pour connaître les types d'informations affichées dans les résultats, consultez la section Informations fournies par la fonctionnalité de gestion de l'inventaire du système d'exploitation.

Répertorier les instances

Pour afficher la liste des instances de VM sur lesquelles la gestion de l'inventaire du système d'exploitation est configurée, exécutez la commande instances os-inventory list-instances.

Par exemple, pour répertorier toutes les instances contenant des données d'inventaire, exécutez la commande suivante :

gcloud beta compute instances os-inventory list-instances

Le résultat doit se présenter comme suit :

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

Vous pouvez également utiliser des filtres pour affiner les résultats. Vous pouvez par exemple répertorier toutes les instances pour lesquelles la gestion de l'inventaire du système d'exploitation est configurée et dont le nom d'hôte correspond à l'expression régulière instance-* en exécutant la commande suivante :

gcloud beta compute instances os-inventory list-instances --inventory-filter="Hostname~instance-*"

Le résultat doit se présenter comme suit :

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

Étape suivante

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Documentation Compute Engine