Actualiza las licencias después de una actualización del SO

En esta página, se explica cómo actualizar las cadenas de licencias en tus instancias de máquina virtual (VM) después de realizar una actualización local del sistema operativo (SO). Este proceso se aplica a los siguientes sistemas operativos:

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

Para obtener detalles sobre las referencias y los códigos de licencia, consulta Cambios y restricciones de licencias.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

    Console

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

    gcloud

    1. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  • Configura una región y una zona predeterminadas.

Prepárate para actualizar la licencia de un disco

Para actualizar la licencia del disco mientras está conectado a una instancia en ejecución, primero detén la instancia o desconecta el disco.

  • Detén la instancia. Apaga temporalmente la instancia antes de actualizar la licencia del disco.
  • Desconecta el disco. Esto desconecta el disco de la instancia antes de actualizar la licencia del disco.

Actualiza la licencia en el disco

Para actualizar la licencia de un disco, usa Google Cloud CLI o la API de Compute Engine. Este proceso reemplaza el URI de licencia existente por el nuevo que corresponde a la versión actualizada del SO.

gcloud

Para reemplazar la licencia de un disco por una referencia de licencia nueva, usa el comando gcloud compute disks update:

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

Reemplaza lo siguiente:

  • DISK_NAME: Es el nombre del disco que se actualizará.
  • PREVIOUS_LICENSE: Es la referencia de licencia para la versión anterior del SO, por ejemplo, "projects/windows-cloud/global/licenses/windows-server-2022-dc" o "projects/rhel-cloud/global/licenses/rhel-9".
  • NEW_LICENSE: Es la referencia de licencia para la nueva versión del SO, por ejemplo, "projects/windows-cloud/global/licenses/windows-server-2025-dc" o "projects/rhel-cloud/global/licenses/rhel-10".

REST

Para reemplazar la licencia de un disco, agrega la licencia nueva al cuerpo de la solicitud y omite la licencia anterior. Llama al siguiente método disks.update v1:

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"]}'

Reemplaza lo siguiente:

  • PROJECT: el nombre del proyecto.
  • ZONE: Es la zona que contiene el disco.
  • DISK_NAME: el nombre del disco.
  • NEW_LICENSE: Es la nueva referencia de licencia, por ejemplo, "projects/windows-cloud/global/licenses/windows-server-2025-dc" o "projects/rhel-cloud/global/licenses/rhel-10".

Valida el cambio de licencia

Para validar que se cambió la licencia en el disco de arranque, usa el siguiente procedimiento:

  1. Para obtener información sobre el disco de arranque, ejecuta el comando gcloud compute disks describe:

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

    Reemplaza lo siguiente:

    • DISK_NAME: Es el nombre del disco de arranque cuya licencia se validará.
    • ZONE: Es la zona que contiene el disco de arranque cuya licencia se validará.

  2. Verifica que el resultado sea similar al siguiente:

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