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 le changement de licence

Seules certaines licences d'OS peuvent être ajoutées, supprimées ou remplacées. Les modifications de licence sont acceptées pour Red Hat Enterprise Linux (RHEL), RHEL pour SAP, SUSE Linux Enterprise Server (SLES), SLES pour SAP, Ubuntu et Ubuntu Pro.

Les modifications de licence autorisées sont déterminées par le propriétaire de la licence et peuvent être modifiées. Pour valider les modifications de licence autorisées pour votre VM, consultez Examiner les modifications et les restrictions de licence.

Pour passer des licences RHEL ou SLES du paiement à l'usage (PAYG) à l'utilisation de votre propre abonnement (BYOS), consultez Passer de PAYG à BYOS et inversement.

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 valide votre identité pour accéder aux services et aux API Google Cloud . 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    2. Set a default region and zone.

    REST

    Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

      Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google 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, commencez par arrêter l'instance ou dissocier 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 Google Cloud , gcloud CLI ou l'API Compute Engine.

Console

  1. Dans la console Google 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, indiquez un champ de licence vide dans la requête d'appel, ainsi que 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 Google 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