Afficher et ajouter des licences

Ce document explique comment afficher les licences associées à une instance de machine virtuelle (VM), ajouter des licences à une VM et afficher l'historique des mises à jour des licences. Pour en savoir plus sur les licences dans Compute Engine, consultez la section À propos des licences.

Avant de commencer

• 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 Trusted Cloud by S3NS services et aux API. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  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.

  After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:

  gcloud init

  Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l' Trusted Cloud authentification.

Afficher les licences associées à une VM

Pour afficher les licences associées à une VM, utilisez la console Trusted Cloud , la gcloud CLI ou l'API Compute Engine.

Afficher les licences utilisateur associées à une VM

Pour afficher les licences utilisateur associées à une VM, utilisez la consoleTrusted Cloud , gcloud CLI ou l'API Compute Engine.

Ajouter une licence lors de l'importation d'une image

Pour ajouter une licence lorsque vous importez une image, utilisez la commande gcloud compute images import suivante.

gcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE
  --os=OS

Remplacez les éléments suivants :

• IMAGE_NAME : nom de l'image à créer.
• SOURCE_FILE : fichier local ou URI Cloud Storage du disque virtuel à importer.
• OS : OS de l'image disque à importer. La licence de l'OS est déduite de la valeur de cette option. Il n'y a pas d'option explicite pour fournir des informations de licence lors de l'importation. Pour obtenir la liste des valeurs acceptées, consultez la section Option --os.

Pour plus d'informations sur l'importation d'images, consultez la page Importer des disques virtuels.

Ajouter des licences lors de la création d'une image

Pour ajouter des licences lors de la création d'une image, utilisez la commande gcloud compute images create suivante.

gcloud compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES

Remplacez les éléments suivants :

• IMAGE_NAME : nom de l'image à créer
• SOURCE_IMAGE : nom de l'image à partir de laquelle vous souhaitez créer l'image
• LICENSES : liste de chaînes de licence séparées par des virgules Exemples : "license1", "license2".

Pour en savoir plus sur la création d'images, consultez les pages Créer, supprimer et rendre obsolètes des images personnalisées et Créer une image Windows.

Ajouter des licences et des licences utilisateur lors de la création d'une image

Pour ajouter des licences et des licences utilisateur lors de la création d'une image, utilisez la commande gcloud beta compute images create suivante.

gcloud beta compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES \
  --user-licenses=USER_LICENSES

Remplacez les éléments suivants :

• IMAGE_NAME : nom de l'image à créer
• SOURCE_IMAGE : nom de l'image à partir de laquelle vous souhaitez créer l'image
• LICENSES : liste de chaînes de licence séparées par des virgules Exemples : "license1", "license2".
• USER_LICENSES : liste de chaînes de licence utilisateur séparées par des virgules Exemples : "userlicense1", "userlicense2".

Pour en savoir plus sur la création d'images, consultez les pages Créer, supprimer et rendre obsolètes des images personnalisées et Créer une image Windows.

Ajouter et valider une licence utilisateur

Pour ajouter et valider une licence utilisateur, procédez comme suit :

1. Arrêtez la VM.

2. Répertoriez les disques associés à la VM à l'aide de la commande gcloud compute instances describe suivante :

   gcloud compute instances describe VM_NAME --format="yaml(disks)"
   

3. Vérifiez que la sortie ressemble à ce qui suit :

   disks:
   - autoDelete: true
     boot: true
     deviceName: BOOT_DISK_NAME
     diskSizeGb: '20'
     guestOsFeatures:
     - type: UEFI_COMPATIBLE
     index: 0
     interface: SCSI
     kind: compute#attachedDisk
     licenses:
     - BOOT_DISK_LICENSE_STRING
     mode: READ_WRITE
     source: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/disks/BOOT_DISK_NAME
     type: PERSISTENT
   

4. Dans la sortie de l'étape précédente, recherchez le nom du disque de démarrage. Pour le disque de démarrage, la valeur de boot est true et le nom du disque de démarrage est la valeur de deviceName.

5. Ajoutez une licence utilisateur au disque de démarrage à l'aide de la commande gcloud beta compute disks update :

   gcloud beta compute disks update BOOT_DISK_NAME \
      --update-user-licenses=LICENSE_URIS
   

   Remplacez les éléments suivants :

   • BOOT_DISK_NAME : nom du disque de démarrage auquel ajouter la licence

   • LICENSE_URIS : liste des chaînes de licence séparés par une virgule, qui remplace toutes les licences utilisateur existantes

6. Obtenez des informations sur le disque de démarrage à l'aide de la commande gcloud beta compute disks describe suivante :

   gcloud beta compute disks describe BOOT_DISK_NAME
   

   Remplacez BOOT_DISK_NAME par le nom du disque de démarrage pour vérifier la licence ajoutée.

7. Vérifiez que la sortie ressemble à ce qui suit :

   creationTimestamp: '2021-05-05T15:26:27.835-07:00'
   guestOsFeatures:
   - type: UEFI_COMPATIBLE
   id: '727854272460268924'
   interface: SCSI
   kind: compute#disk
   labelFingerprint: 42WmSpB8rSM=
   lastAttachTimestamp: '2021-05-05T15:26:27.836-07:00'
   licenseCodes:
   - '1000006'
   - '6213885950785916969'
   licenses:
   - BOOT_DISK_LICENSE_STRING
   multiWriter: false
   name: VM_NAME
   physicalBlockSizeBytes: '4096'
   selfLink: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/DISK_NAME
   selfLinkWithId: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/727854272460268924
   sizeGb: '20'
   sourceImage: https://www.googleapis.com/compute/beta/projects/IMAGE_PROJECT/global/images/IMAGE
   sourceImageId: '7397991294075835597'
   status: READY
   type: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/diskTypes/pd-standard
   userLicenses:
   - LICENSE_URI
   users:
   - https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
   zone: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE
   

8. Vérifiez que la licence utilisateur est ajoutée au disque de démarrage en vérifiant la sortie de l'étape précédente du champ userLicenses pour la chaîne de licence appropriée.

   Si le champ userLicenses ne contient pas les chaînes de licence prévues, vous devrez peut-être effacer, puis mettre à jour la liste des chaînes de licence. Pour ce faire, utilisez la commande gcloud beta compute disks update.

9. Démarrez la VM.

Afficher l'historique des mises à jour des licences

Pour afficher l'historique des mises à jour des licences des VM d'un projet, procédez comme suit :

1. Dans la console Trusted Cloud , accédez à la page Explorateur de journaux.

   Accéder à l'explorateur de journaux

2. Dans la barre d'outils, assurez-vous que l'option Afficher la requête est activée.

3. Copiez l'expression suivante dans l'éditeur de requête:

   resource.type="gce_disk"
   logName="projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Factivity"
   severity>=NOTICE
   protoPayload.request.@type="type.googleapis.com/compute.disks.update"
   protoPayload.request.userLicenses:*
   

4. Cliquez sur Exécuter la requête.

Étapes suivantes

• Résolvez les problèmes de licence.

• Apprenez-en plus sur les licences Microsoft sur Compute Engine.

• Apprenez-en plus sur les systèmes d'exploitation premium :

  • Consultez les questions fréquentes sur RHEL.

  • Consultez les questions fréquentes sur SLES.

  • Consultez les questions fréquentes sur Ubuntu Pro