Questa pagina è stata tradotta dall'API Cloud Translation.

Esegui l'upgrade da Ubuntu a Ubuntu Pro

Linux

Quando un'immagine Ubuntu LTS raggiunge la fine del suo ciclo di vita, non viene più supportata e non riceverà aggiornamenti della sicurezza. Se esegui l'upgrade a Ubuntu Pro, continuerai a ricevere gli aggiornamenti della sicurezza per la durata del servizio Extended Security Maintenance (ESM).

Questo documento mostra come fare l'upgrade da Ubuntu a Ubuntu Pro intraprendendo per ogni VM le azioni riportate di seguito:

Installa gli aggiornamenti e le dipendenze.
Sostituisci la licenza Ubuntu con la licenza Ubuntu Pro.
Convalida la licenza.

Percorsi di upgrade supportati

La tabella seguente mostra i percorsi di upgrade supportati:

Versione iniziale	Versione finale
Ubuntu 16.04 LTS	Ubuntu Pro 16.04 LTS
Ubuntu 18.04 LTS	Ubuntu Pro 18.04 LTS
Ubuntu 20.04 LTS	Ubuntu Pro 20.04 LTS
Ubuntu 22.04 LTS	Ubuntu Pro 22.04 LTS
Ubuntu 24.04 LTS	Ubuntu Pro 24.04 LTS

Limitazioni

Devi arrestare una VM prima di sostituire una licenza.
Puoi fare l'upgrade da Ubuntu LTS a Ubuntu Pro LTS solo se si tratta della stessa versione. Ad esempio, puoi fare l'upgrade da Ubuntu 16.04 LTS a Ubuntu Pro 16.04 LTS, ma non da Ubuntu 16.04 LTS a Ubuntu Pro 20.04 LTS.

Fatturazione

La fatturazione di Ubuntu Pro LTS avviene in base ai prezzi delle immagini premium.

Per ulteriori informazioni sulla fatturazione, consulta Fatturazione Cloud.

Prima di iniziare

Esegui i seguenti comandi su ogni VM, sostituendo VM_NAME con il nome della VM di cui desideri fare l'upgrade:
1. Aggiorna l'indice dei pacchetti utilizzando il seguente comando:
```
gcloud compute ssh VM_NAME --command "sudo apt update"
```
2. Installa la versione più recente dei pacchetti utilizzando il seguente comando:
```
gcloud compute ssh VM_NAME --command "sudo apt -f upgrade"
```
3. Installa Ubuntu Pro utilizzando il seguente comando:
```
gcloud compute ssh VM_NAME --command "sudo apt -f install ubuntu-advantage-pro"
```
Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso a Google Cloud 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando:
  gcloud init
  Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
  
  Nota:se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
2. Set a default region and zone.

Sostituisci la licenza

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

compute.disks.update sul disco di avvio

Sostituisci la licenza Ubuntu con la licenza Ubuntu Pro utilizzando la seguente procedura:

Arresta la VM utilizzando il comando gcloud compute instances stop:
```
gcloud compute instances stop VM_NAME \
   --zone=ZONE
```
Sostituisci quanto segue:
- VM_NAME: il nome della VM da arrestare
- ZONE: la zona contenente la VM da arrestare
Ottieni l'elenco dei dischi associati alla VM utilizzando il comando gcloud compute instances describe:
```
gcloud compute instances describe VM_NAME \
   --zone=ZONE \
   --format="yaml(disks)"
```
Sostituisci quanto segue:
- VM_NAME: il nome della VM da cui recuperare l'elenco dei dischi associati
- ZONE: la zona contenente la VM da cui recuperare l'elenco di dischi associati

Verifica che l'output sia simile al seguente:

disks:
- autoDelete: true
  boot: true
  deviceName: ubuntu
  diskSizeGb: '10'
  guestOsFeatures:
  - type: VIRTIO_SCSI_MULTIQUEUE
  - type: SEV_CAPABLE
  - type: UEFI_COMPATIBLE
  - type: GVNIC
  index: 0
  interface: SCSI
  kind: compute#attachedDisk
  licenses:
  - https://www.googleapis.com/compute/v1/projects/ubuntu-os-cloud/global/licenses/ubuntu-1604-xenial
  mode: READ_WRITE
  shieldedInstanceInitialState:
    dbxs:
    - content: ...
      fileType: BIN
  source: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/disks/VM_NAME
  type: PERSISTENT

Tieni presente che non è stato sostituito alcun Licenses.

Recupera il nome del disco di avvio eseguendo il comando gcloud compute disks list:
```
gcloud compute disks list
```
Aggiorna il disco di avvio con l'URI della licenza Ubuntu Pro utilizzando il comando gcloud compute disks update:
```
gcloud compute disks update DISK_NAME \
   --zone=ZONE \
   --replace-license="PREVIOUS_LICENSE, NEW_LICENSE"
```
Sostituisci quanto segue:
- DISK_NAME: il nome del disco di avvio a cui sostituire la licenza.
- ZONE: la zona contenente il disco di avvio a cui sostituire la licenza.
- PREVIOUS_LICENSE: l'URI della licenza per la versione di Ubuntu
- NEW_LICENSE: il nuovo URI della licenza Ubuntu Pro.
La tabella seguente mostra l'URI della licenza per le versioni supportate di Ubuntu Pro:

Versione di Ubuntu Pro	URI della licenza
Ubuntu Pro 16.04 LTS	`https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-1604-lts`
Ubuntu Pro 18.04 LTS	`https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-1804-lts`
Ubuntu Pro 20.04 LTS	`https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-2004-lts`
Ubuntu Pro 22.04 LTS	`https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-2204-lts`
Ubuntu Pro 24.04 LTS	`https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-2404-lts`

Convalida la licenza

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

compute.disks.get sul disco di avvio

Convalida la licenza Ubuntu Pro seguendo la procedura riportata di seguito:

Per informazioni sul disco di avvio, esegui il comando gcloud compute disks describe:
```
gcloud compute disks describe DISK_NAME \
   --zone=ZONE
```
Sostituisci quanto segue:
- DISK_NAME: il nome del disco di avvio di cui desideri verificare la licenza
- ZONE: la zona contenente il disco di avvio di cui desideri verificare la licenza

Verifica che l'output sia simile al seguente:

creationTimestamp: '2021-10-20T17:20:26.616-07:00'
guestOsFeatures:
- type: VIRTIO_SCSI_MULTIQUEUE
- type: SEV_CAPABLE
- type: UEFI_COMPATIBLE
- type: GVNIC
id: '7008232787326864549'
kind: compute#disk
labelFingerprint: 42WmSpB8rSM=
lastAttachTimestamp: '2021-10-20T17:20:26.617-07:00'
licenseCodes:
- '1000201'
- '8045211386737108299'
licenses:
- https://www.googleapis.com/compute/v1/projects/ubuntu-os-cloud/global/licenses/ubuntu-1604-xenial
- https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-1604-lts
name: ubuntu
physicalBlockSizeBytes: '4096'
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/disks/DISK_NAME
sizeGb: '10'
sourceImage: https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT/global/images/IMAGE
sourceImageId: '1233998915439563944'
status: READY
type: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/diskTypes/DISK_TYPE
users:
- https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
zone: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE

Verifica che la licenza Ubuntu Pro sia stata aggiunta al disco di avvio controllando il campo licenses della stringa della licenza appropriata nell'output del passaggio precedente.

Se il campo licenses non contiene la stringa della licenza prevista, potrebbe essere necessario eliminare e aggiornare le licenze. Per ulteriori informazioni, consulta il comando gcloud compute disks update.
Avvia la VM utilizzando il comando gcloud compute instances start:
```
gcloud compute instances start VM_NAME \
   --zone=ZONE \
   [--csek-key-file ENCRYPTION_KEY]
```
Sostituisci quanto segue:
- VM_NAME: il nome della VM da avviare
- ZONE: la zona contenente la VM da avviare
- ENCRYPTION_KEY: facoltativo: specifica il percorso del file della chiave di crittografia fornita dal cliente (CSEK) nel caso in cui il disco di avvio è criptato
Dopo l'avvio della VM, esegui il comando gcloud compute ssh per verificare che Ubuntu ESM disponga dei diritti necessari e sia stato abilitato:
```
gcloud compute ssh VM_NAME --command "sudo ua status --wait" \
   --zone=ZONE
```
Sostituisci quanto segue:
- VM_NAME: il nome della VM da verificare
- ZONE: la zona contenente la VM da verificare

Verifica che Ubuntu ESM sia autorizzato e abilitato controllando che l'output sia simile al seguente:

SERVICE       ENTITLED  STATUS    DESCRIPTION
cis           yes       disabled  Center for Internet Security Audit Tools
esm-apps      yes       enabled   UA Apps: Extended Security Maintenance (ESM)
esm-infra     yes       enabled   UA Infra: Extended Security Maintenance (ESM)
fips          yes       n/a       NIST-certified core packages
fips-updates  yes       n/a       NIST-certified core packages with priority security updates
livepatch     yes       n/a       Canonical Livepatch service

Visualizza log delle attività

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

Nella console Google Cloud , vai alla pagina Esplora log.

Vai a Esplora log
Nella barra degli strumenti, verifica che l'opzione Mostra query sia attivata.

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:*

Sostituisci PROJECT_NAME con il nome del progetto.
Fai clic su Esegui query.

Esegui l'upgrade da Ubuntu a Ubuntu Pro Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Percorsi di upgrade supportati

Limitazioni

Fatturazione

Prima di iniziare

Console

gcloud

Sostituisci la licenza

Autorizzazioni richieste per questa attività

Convalida la licenza

Autorizzazioni richieste per questa attività

Visualizza log delle attività

Esegui l'upgrade da Ubuntu a Ubuntu Pro