Mettre à jour les licences après une mise à niveau de l'OS

Cette page explique comment mettre à jour les chaînes de licence sur vos instances de machine virtuelle (VM) après avoir effectué une mise à niveau sur place du système d'exploitation (OS). Cette procédure s'applique aux systèmes d'exploitation suivants :

  • Red Hat Enterprise Linux (RHEL)
  • RHEL pour SAP
  • SUSE Linux Enterprise Server (SLES)
  • SLES pour SAP
  • Windows Server

Pour en savoir plus sur les références et les codes de licence, consultez Modifications et restrictions de licence.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet de valider 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 :

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.

    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.

  • Définissez une région et une zone par défaut.

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. Cela 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.

Mettre à jour la licence du disque

Pour mettre à jour la licence d'un disque, utilisez la Google Cloud CLI ou l'API Compute Engine. Ce processus remplace l'URI de licence existant par le nouvel URI correspondant à la version mise à niveau de votre OS.

gcloud

Pour remplacer la licence d'un disque par une nouvelle référence de licence, utilisez la commande gcloud compute disks update :

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

Remplacez les éléments suivants :

  • DISK_NAME : nom du disque à mettre à jour.
  • PREVIOUS_LICENSE : référence de licence pour la version précédente de l'OS, par exemple "projects/windows-cloud/global/licenses/windows-server-2022-dc" ou "projects/rhel-cloud/global/licenses/rhel-9".
  • NEW_LICENSE : référence de licence de la nouvelle version de l'OS, par exemple "projects/windows-cloud/global/licenses/windows-server-2025-dc" ou "projects/rhel-cloud/global/licenses/rhel-10".

REST

Pour remplacer la licence d'un disque, ajoutez la nouvelle licence au corps de la requête et omettez l'ancienne 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/NEW_LICENSE"]}'

Remplacez les éléments suivants :

  • PROJECT : nom du projet.
  • ZONE : zone contenant le disque.
  • DISK_NAME : nom du disque.
  • NEW_LICENSE : nouvelle référence de licence, par exemple "projects/windows-cloud/global/licenses/windows-server-2025-dc" ou "projects/rhel-cloud/global/licenses/rhel-10".

Valider le changement de licence

Pour vérifier que votre licence a été modifiée sur le disque de démarrage, procédez comme suit :

  1. Obtenez des informations sur le disque de démarrage en exécutant la commande gcloud compute disks describe :

    gcloud compute disks describe DISK_NAME \
    --zone=ZONE \
    --format="value(licenses)"

    Remplacez les éléments suivants :

    • DISK_NAME : nom du disque de démarrage dont vous souhaitez valider la licence.
    • ZONE : zone contenant le disque de démarrage dont vous souhaitez valider la licence.

  2. Vérifiez que le résultat ressemble à ce qui suit :

    https://www.googleapis.com/compute/v1/projects/windows-cloud/global/licenses/windows-server-2025-dc