Gestisci le licenze

Questo documento spiega come gestire le licenze associate a un'istanza Compute Engine. Sono incluse le istruzioni su come aggiungere, rimuovere, sostituire e visualizzare la cronologia degli aggiornamenti delle licenze. Per ulteriori informazioni sulle licenze su Compute Engine, vedi Informazioni sulle licenze.

Limitazioni per la gestione delle licenze:

  • Puoi aggiungere una licenza a un disco solo se AppendableToDisk è true.
  • Puoi rimuovere (senza fornire sostituzioni) solo se RemovableFromDisk è true.
  • Puoi sostituire una licenza solo con una delle sostituzioni elencate in AllowedReplacementLicenses.

Per Ubuntu LTS, per eseguire l'upgrade della licenza a Ubuntu Pro e attivare Extended Security Maintenance (ESM), vedi Esegui l'upgrade da Ubuntu a Ubuntu Pro.

Per aggiornare la licenza RHEL on demand in modo da includere l'assistenza estesa, vedi Aggiungere il componente aggiuntivo RHEL Extended Lifecycle Support (ELS) alla licenza.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo di verifica dell'identità per poter accedere a Trusted Cloud by S3NS servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    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. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando:

      gcloud init
    2. Set a default region and zone.

    REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando:

      gcloud init

    Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .

Prepararsi ad aggiornare la licenza di un disco

Per aggiornare la licenza del disco mentre è collegato a un'istanza in esecuzione, prima arresta l'istanza o scollega il disco.

  • Arresta l'istanza. Arresta temporaneamente l'istanza prima di aggiornare la licenza del disco.
  • Scollega il disco. In questo modo il disco viene scollegato dall'istanza prima di aggiornare la licenza del disco.

Visualizza le licenze associate a una VM

Per visualizzare le licenze associate a una VM, utilizza la console Trusted Cloud , gcloud CLI o l'API Compute Engine.

Console

  1. Nella console Trusted Cloud , vai alla pagina Istanze VM.

    Vai a Istanze VM

  2. Fai clic sul nome della VM di cui vuoi controllare la licenza. Viene visualizzata la pagina Dettagli istanza.

  3. Nella parte inferiore della pagina Dettagli istanza, fai clic su Codice equivalente.

  4. Visualizza il campo licenses per il disco di avvio.

gcloud

  1. Esegui questo comando gcloud compute instances describe:

    gcloud compute instances describe VM_NAME
    

    Sostituisci VM_NAME con il nome della VM.

  2. Visualizza la sezione disks dell'output. Il campo licenses mostra le licenze associate al disco di avvio.

REST

Chiama il metodo v1 instances.get:

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

Sostituisci quanto segue:

  • PROJECT: il nome del progetto
  • ZONE: la zona contenente la VM
  • VM_NAME: il nome della VM

L'API Compute Engine restituisce le licenze associate al disco di avvio nella sezione disks del campo licenses.

Aggiungere una licenza durante l'importazione di un'immagine

Per aggiungere una licenza durante il processo di importazione dell'immagine, utilizza il seguente comando gcloud compute images import.

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

Sostituisci quanto segue:

  • IMAGE_NAME: il nome dell'immagine da creare.
  • SOURCE_FILE: un file locale o un URI Cloud Storage del disco virtuale da importare.
  • OS: il sistema operativo dell'immagine disco da importare. La licenza per il sistema operativo viene dedotta dal valore di questo flag; non esiste un flag esplicito per fornire informazioni sulla licenza durante l'importazione. Per un elenco dei valori supportati, vedi il flag --os.

Per saperne di più sull'importazione di immagini, consulta Importazione di dischi virtuali.

Aggiungi le licenze durante la creazione di un'immagine

Per aggiungere licenze durante la creazione di un'immagine, utilizza il seguente comando gcloud compute images create.

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

Sostituisci quanto segue:

  • IMAGE_NAME: il nome dell'immagine da creare.
  • SOURCE_IMAGE: il nome dell'immagine da cui creare la nuova immagine.
  • LICENSES: un elenco separato da virgole di stringhe di licenza. Ad esempio, "license1", "license2".

Per saperne di più sulla creazione di immagini, vedi Creare, eliminare e impostare come obsolete le immagini personalizzate e Creare un'immagine Windows.

Per saperne di più sulla creazione di immagini, vedi Creare, eliminare e impostare come obsolete le immagini personalizzate e Creare un'immagine Windows.

Aggiungere licenze a un disco

Per aggiungere licenze associate a una VM, utilizza gcloud CLI o l'API Compute Engine.

gcloud

Per aggiungere licenze a un disco utilizzando un riferimento o un codice di licenza, utilizza il comando gcloud compute disks update riportato di seguito.

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

Sostituisci quanto segue:

  • DISK_NAME: il nome del disco da aggiungere.
  • LICENSES: un elenco separato da virgole di riferimenti alle licenze, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Per aggiungere licenze a un disco utilizzando un riferimento o un codice di licenza, chiama il seguente metodo v1 disks.update:

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

Sostituisci quanto segue:

  • PROJECT: il nome del progetto
  • ZONE: la zona contenente la VM
  • DISK_NAME: il nome del disco
  • LICENSES: un elenco separato da virgole di riferimenti alle licenze, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Sostituire le licenze su un disco

Per sostituire le licenze associate a una VM, utilizza gcloud CLI o l'API Compute Engine.

gcloud

Per sostituire una licenza su un disco utilizzando un riferimento o un codice di licenza, utilizza il seguente comando gcloud compute disks update.

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

Sostituisci quanto segue:

  • DISK_NAME: il nome del disco da aggiungere.
  • PREVIOUS_LICENSE: il riferimento alla licenza precedente da sostituire, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".
  • NEW_LICENSE: il nuovo riferimento alla licenza, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Per sostituire una licenza su un disco utilizzando un riferimento o un codice di licenza, chiama il metodo v1e sostituisci la licenza precedente con la nuova nel corpo della richiesta come segue:disks.update

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

Sostituisci quanto segue:

  • PROJECT: il nome del progetto
  • ZONE: la zona contenente la VM
  • DISK_NAME: il nome del disco
  • NEW_LICENSE: il nuovo riferimento alla licenza, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Rimuovere le licenze da un disco

Per rimuovere le singole licenze associate a una VM, utilizza gcloud CLI e l'API Compute Engine.

gcloud

Per rimuovere le licenze da un disco utilizzando un riferimento o un codice di licenza, utilizza il comando gcloud compute disks update.

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

Sostituisci quanto segue:

  • DISK_NAME: il nome del disco da rimuovere.
  • LICENSES: un elenco separato da virgole di riferimenti alle licenze, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Per rimuovere una licenza, fornisci un campo della licenza vuoto nella richiesta di chiamata insieme al selettore di percorso chiamando il seguente metodo v1 disks.update:

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

Sostituisci quanto segue:

  • PROJECT: il nome del progetto
  • ZONE: la zona contenente la VM
  • DISK_NAME: il nome del disco
  • LICENSES: lascia vuoto.

Visualizza la cronologia degli aggiornamenti delle licenze

Visualizza la cronologia degli aggiornamenti delle licenze per le VM presenti in un progetto utilizzando la seguente procedura:

  1. Nella console Trusted Cloud , vai alla pagina Esplora log.

    Vai a Esplora log

  2. Nella barra degli strumenti, verifica che l'opzione Mostra query sia attivata.

  3. Copia la seguente espressione nell'Editor di query:

    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. Sostituisci PROJECT_NAME con il nome del progetto.

  5. Fai clic su Esegui query.

Passaggi successivi