Passer d'Ubuntu à Ubuntu Pro

Linux

Lorsqu'une image Ubuntu LTS arrive en fin de vie, elle n'est plus acceptée et ne reçoit plus de mises à jour de sécurité. Si vous passez à Ubuntu Pro, vous pouvez continuer à recevoir des mises à jour de sécurité pendant la période de maintenance de sécurité étendue (ESM).

Ce document explique comment passer d'Ubuntu à Ubuntu Pro. Vous devez procéder comme suit pour chaque VM :

Installez les mises à jour et les dépendances.
Remplacez la licence Ubuntu par la licence Ubuntu Pro.
Validez la licence.

Chemins de mise à niveau acceptés

Le tableau suivant indique les chemins de mise à niveau acceptés :

Version initiale	Version 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

Limites

Vous devez arrêter une VM avant de remplacer sa licence.
Vous ne pouvez passer d'Ubuntu LTS à Ubuntu Pro LTS que s'il s'agit de la même version. Par exemple, vous pouvez passer d'Ubuntu 16.04 LTS à Ubuntu Pro 16.04 LTS, mais ne pouvez pas passer d'Ubuntu 16.04 LTS à Ubuntu Pro 20.04 LTS.

Facturation

Ubuntu Pro LTS vous est facturé conformément aux tarifs des images payantes.

Pour en savoir plus sur la facturation, consultez Cloud Billing.

Avant de commencer

Exécutez les commandes suivantes sur chaque VM en remplaçant VM_NAME par le nom de la VM à mettre à niveau :
1. Mettez à jour l'index du package à l'aide de la commande suivante :
```
gcloud compute ssh VM_NAME --command "sudo apt update"
```
2. Installez la dernière version des packages à l'aide de la commande suivante :
```
gcloud compute ssh VM_NAME --command "sudo apt -f upgrade"
```
3. Installez Ubuntu Pro à l'aide de la commande suivante :
```
gcloud compute ssh VM_NAME --command "sudo apt -f install ubuntu-advantage-pro"
```
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 :
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.
  
  Remarque : Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
2. Set a default region and zone.

Remplacer la licence

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

compute.disks.update sur le disque de démarrage

Remplacez la licence Ubuntu par la licence Ubuntu Pro en procédant comme suit :

Arrêtez la VM à l'aide de la commande gcloud compute instances stop :
```
gcloud compute instances stop VM_NAME \
   --zone=ZONE
```
Remplacez les éléments suivants :
- VM_NAME : nom de la VM à arrêter.
- ZONE : zone contenant la VM à arrêter.
Récupérez la liste des disques associés à la VM en exécutant la commande gcloud compute instances describe :
```
gcloud compute instances describe VM_NAME \
   --zone=ZONE \
   --format="yaml(disks)"
```
Remplacez les éléments suivants :
- VM_NAME : nom de la VM pour laquelle vous souhaitez récupérer la liste des disques associés.
- ZONE : zone contenant la VM pour laquelle vous souhaitez récupérer la liste des disques associés.

Vérifiez que le résultat ressemble à ceci :

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

Notez qu'aucun élément Licenses n'a été remplacé.

Obtenez le nom du disque de démarrage en exécutant la commande gcloud compute disks list :
```
gcloud compute disks list
```
Mettez à jour le disque de démarrage avec l'URI de licence Ubuntu Pro à l'aide de la commande gcloud compute disks update :
```
gcloud compute disks update DISK_NAME \
   --zone=ZONE \
   --replace-license="PREVIOUS_LICENSE, NEW_LICENSE"
```
Remplacez les éléments suivants :
- DISK_NAME : nom du disque de démarrage dont vous souhaitez remplacer la licence.
- ZONE : zone contenant le disque de démarrage dont vous souhaitez remplacer la licence.
- PREVIOUS_LICENSE : URI de licence pour la version Ubuntu.
- NEW_LICENSE : nouvel URI de licence Ubuntu Pro.
Le tableau suivant indique l'URI de licence pour les versions acceptées d'Ubuntu Pro :

Version d'Ubuntu Pro	URI de licence
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`

Valider la licence

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

compute.disks.get sur le disque de démarrage

Validez la licence Ubuntu Pro en procédant comme suit :

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

Vérifiez que le résultat ressemble à ceci :

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

Assurez-vous que la licence Ubuntu Pro est ajoutée au disque de démarrage en vérifiant dans la sortie de l'étape précédente que la chaîne de licence appropriée est spécifiée dans le champ licenses.

Si le champ licenses ne contient pas la chaîne de licence prévue, vous devrez peut-être effacer les licences utilisateur, puis les mettre à jour. Pour en savoir plus sur cette commande, consultez gcloud compute disks update.
Arrêtez la VM à l'aide de la commande gcloud compute instances start :
```
gcloud compute instances start VM_NAME \
   --zone=ZONE \
   [--csek-key-file ENCRYPTION_KEY]
```
Remplacez les éléments suivants :
- VM_NAME : nom de la VM à démarrer.
- ZONE : zone contenant la VM à démarrer.
- ENCRYPTION_KEY : (facultatif) spécifie le chemin d'accès au fichier de clé de chiffrement fournie par le client (CSEK, Customer-Supplied Encryption Key) si le disque de démarrage est chiffré.
Une fois la VM démarrée, exécutez la commande gcloud compute ssh pour vérifier qu'Ubuntu ESM est autorisé et activé :
```
gcloud compute ssh VM_NAME --command "sudo ua status --wait" \
   --zone=ZONE
```
Remplacez les éléments suivants :
- VM_NAME : nom de la VM à vérifier.
- ZONE : zone contenant la VM à vérifier.

Vérifiez qu'Ubuntu ESM est autorisé et activé. Le résultat doit ressembler à ceci :

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

Afficher les journaux d'activité

Pour afficher l'historique des mises à jour des licences des VM d'un projet, procédez comme suit :

Dans la console Google Cloud , accédez à la page Explorateur de journaux.

Accéder à l'explorateur de journaux
Dans la barre d'outils, assurez-vous que l'option Afficher la requête est activée.

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

Remplacez PROJECT_NAME par le nom de votre projet.
Cliquez sur Exécuter la requête.

Passer d'Ubuntu à Ubuntu Pro Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Chemins de mise à niveau acceptés

Limites

Facturation

Avant de commencer

Console

gcloud

Remplacer la licence

Autorisations requises pour cette tâche

Valider la licence

Autorisations requises pour cette tâche

Afficher les journaux d'activité

Passer d'Ubuntu à Ubuntu Pro