Gérer les licences

Ce document explique comment gérer les licences associées à une instance Compute Engine. Cela inclut l'ajout, la suppression et le remplacement de licences, ainsi que l'affichage de l'historique des mises à jour des licences. Pour en savoir plus sur les licences dans Compute Engine, consultez À propos des licences.

Restrictions concernant la gestion des licences :

  • Vous ne pouvez ajouter une licence à un disque que si AppendableToDisk est défini sur true.
  • Vous ne pouvez supprimer (sans remplacement) que si RemovableFromDisk est true.
  • Vous ne pouvez remplacer une licence que par l'une des licences de remplacement listées dans AllowedReplacementLicenses.

Pour Ubuntu LTS, afin de passer à Ubuntu Pro et d'activer la maintenance de sécurité étendue (ESM), consultez Passer d'Ubuntu à Ubuntu Pro.

Pour mettre à jour votre licence RHEL à la demande afin d'inclure l'assistance étendue, consultez Ajouter le module complémentaire RHEL Extended Lifecycle Support (ELS) à votre licence.

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 services et aux API Trusted Cloud by S3NS . 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. Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :

      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.

      Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :

      gcloud init

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

Préparer la mise à jour de la licence d'un disque

Pour mettre à jour la licence du disque lorsqu'il est associé à une instance en cours d'exécution, arrêtez d'abord l'instance ou dissociez le disque.

  • Arrêtez l'instance. Arrête temporairement l'instance avant de mettre à jour la licence du disque.
  • Dissociez le disque. Cela dissocie le disque de l'instance avant de mettre à jour la licence du disque.

Afficher les licences associées à une VM

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

Console

  1. Dans la console Trusted Cloud , accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Cliquez sur le nom de la VM pour laquelle vous souhaitez vérifier la licence. La page Détails de l'instance s'affiche.

  3. Au bas de la page Détails de l'instance, cliquez sur Code équivalent.

  4. Affichez le champ licenses pour le disque de démarrage.

gcloud

  1. Exécutez la commande gcloud compute instances describe suivante :

    gcloud compute instances describe VM_NAME
    

    Remplacez VM_NAME par le nom de votre VM.

  2. Consultez la section disks du résultat. Le champ licenses contient les licences associées au disque de démarrage.

REST

Appelez la méthode instances.get v1 :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instancesVM_NAME

Remplacez les éléments suivants :

  • PROJECT : nom du projet.
  • ZONE : zone contenant la VM
  • VM_NAME : nom de la VM

L'API Compute Engine renvoie les licences associées au disque de démarrage dans la section disks du champ licenses.

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

Pour ajouter une licence lors de l'importation d'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 en savoir plus sur l'importation d'images, consultez 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 Exemple : "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.

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 à un disque

Pour ajouter des licences associées à une VM, utilisez gcloud CLI ou l'API Compute Engine.

gcloud

Pour ajouter des licences à un disque à l'aide d'une référence ou d'un code de licence, utilisez la commande gcloud compute disks update suivante.

gcloud compute disks update DISK_NAME \
--append-licenses=LICENSES

Remplacez les éléments suivants :

  • DISK_NAME : nom du disque à ajouter.
  • LICENSES : liste de références de licence séparées par une virgule, par exemple "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Pour ajouter des licences à un disque à l'aide d'une référence ou d'un code de licence, appelez la méthode disks.update v1 suivante :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/LICENSES"]}'

Remplacez les éléments suivants :

  • PROJECT : nom du projet.
  • ZONE : zone contenant la VM
  • DISK_NAME : le nom du disque
  • LICENSES : liste de références de licence séparées par une virgule, par exemple "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Remplacer des licences sur un disque

Pour remplacer les licences associées à une VM, utilisez gcloud CLI ou l'API Compute Engine.

gcloud

Pour remplacer une licence sur un disque à l'aide d'une référence ou d'un code de licence, utilisez la commande gcloud compute disks update suivante.

gcloud compute disks update DISK_NAME \
--replace-license=PREVIOUS_LICENSE,NEW_LICENSE

Remplacez les éléments suivants :

  • DISK_NAME : nom du disque à ajouter.
  • PREVIOUS_LICENSE : référence de licence précédente remplacée, par exemple "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".
  • NEW_LICENSE : nouvelle référence de licence, par exemple "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Pour remplacer une licence sur un disque à l'aide d'une référence ou d'un code de licence, appelez la méthode disks.update v1 et remplacez l'ancienne licence par la nouvelle dans le corps de la requête comme suit :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/NEW_LICENSE"]}'

Remplacez les éléments suivants :

  • PROJECT : nom du projet.
  • ZONE : zone contenant la VM
  • DISK_NAME : le nom du disque
  • NEW_LICENSE : nouvelle référence de licence, par exemple "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Supprimer des licences d'un disque

Pour supprimer des licences individuelles associées à une VM, utilisez gcloud CLI et l'API Compute Engine.

gcloud

Pour supprimer des licences d'un disque à l'aide d'une référence ou d'un code de licence, utilisez la commande gcloud compute disks update.

gcloud compute disks update DISK_NAME \
--remove-licenses=LICENSES

Remplacez les éléments suivants :

  • DISK_NAME : nom du disque à supprimer.
  • LICENSES : liste de références de licence séparées par une virgule, par exemple "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Pour supprimer une licence, fournissez un champ de licence vide dans la requête d'appel avec le sélecteur de chemin en appelant la méthode v1 disks.update suivante :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":[]}'

Remplacez les éléments suivants :

  • PROJECT : nom du projet.
  • ZONE : zone contenant la VM
  • DISK_NAME : le nom du disque
  • LICENSES : laissez ce champ vide.

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, vérifiez 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.licenses:*
    
  4. Remplacez PROJECT_NAME par le nom du fichier.

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

Étapes suivantes