Fazer upgrade do Ubuntu para Ubuntu Pro

Quando uma imagem do Ubuntu LTS chega ao fim da vida útil, ela não recebe mais suporte nem atualizações de segurança. Se você fizer upgrade para o Ubuntu Pro, vai continuar recebendo atualizações de segurança durante a manutenção de segurança estendida (ESM).

Neste documento, você verá como fazer upgrade do Ubuntu para o Ubuntu Pro fazendo o seguinte para cada VM:

1. Instale atualizações e dependências.
2. Substitua a licença do Ubuntu pela do Ubuntu Pro.
3. Valide a licença.

Caminhos de upgrade compatíveis

A tabela a seguir mostra os caminhos de upgrade compatíveis:

Versão inicial	Versão final.
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

Limitações

• É necessário interromper uma VM antes de substituir uma licença.

• Só é possível fazer upgrade do Ubuntu LTS para o Ubuntu Pro LTS se eles tiverem a mesma versão. Por exemplo, é possível fazer upgrade do Ubuntu 16.04 LTS para o Ubuntu Pro 16.04 LTS, mas não do upgrade do Ubuntu 16.04 LTS para o Ubuntu Pro 20.04 LTS.

Faturamento

A cobrança do Ubuntu Pro LTS é feita de acordo com os preços das imagens premium.

Para mais informações sobre faturamento, consulte Cloud Billing.

Antes de começar

• Execute os seguintes comandos em cada VM, substituindo VM_NAME pelo nome da VM para fazer upgrade:

  1. Atualize o índice de pacotes usando o seguinte comando:

     gcloud compute ssh VM_NAME --command "sudo apt update"

  2. Instale a versão mais recente dos pacotes usando este comando:

     gcloud compute ssh VM_NAME --command "sudo apt -f upgrade"

  3. Instale o Ubuntu Pro usando o seguinte comando:

     gcloud compute ssh VM_NAME --command "sudo apt -f install ubuntu-advantage-pro"

• Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Cloud de Confiance by S3NS . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

  Selecione a guia para como planeja usar as amostras nesta página:

  Console

  Quando você usa o console Cloud de Confiance para acessar os serviços e as APIs Cloud de Confiance by S3NS , não é necessário configurar a autenticação.

  gcloud

  1. Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:

     gcloud init

• Defina uma região e uma zona padrão.

Substituir a licença

Permissões exigidas para a tarefa

Para executar esta tarefa, é necessário ter as seguintes permissões:

• compute.disks.update no disco de inicialização

Substitua a licença do Ubuntu pela do Ubuntu Pro usando o seguinte procedimento:

1. Interrompa a VM usando o comando gcloud compute instances stop:

   gcloud compute instances stop VM_NAME \
      --zone=ZONE
   

   Substitua:

   • VM_NAME: o nome da VM a ser parada
   • ZONE: zona que contém a VM a ser interrompida

2. Receba a lista de discos associados à VM usando o comando gcloud compute instances describe:

   gcloud compute instances describe VM_NAME \
      --zone=ZONE \
      --format="yaml(disks)"
   

   Substitua:

   • VM_NAME: o nome da VM para receber a lista de discos associados

   • ZONE: a zona que contém a VM para receber a lista de discos associados

3. Verifique se a saída é semelhante a:

   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
   

   Nenhum Licenses foi substituído.

4. Para saber o nome do disco de inicialização, execute o comando gcloud compute disks list:

   gcloud compute disks list
   

5. Atualize o disco de inicialização com o URI da licença do Ubuntu Pro usando o comando gcloud compute disks update:

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

   Substitua:

   • DISK_NAME: o nome do disco de inicialização a que a licença será substituída.

   • ZONE: a zona que contém o disco de inicialização para substituir a licença.

   • PREVIOUS_LICENSE: o URI da licença da versão do Ubuntu

   • NEW_LICENSE: o novo URI da licença do Ubuntu Pro.

   A tabela a seguir mostra o URI da licença para as versões compatíveis do Ubuntu Pro:

Versão do Ubuntu Pro	URI da licença
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

Validar a licença

Permissões exigidas para a tarefa

Para executar esta tarefa, é necessário ter as seguintes permissões:

• compute.disks.get no disco de inicialização

Valide a licença do Ubuntu Pro usando o seguinte procedimento:

1. Para informações sobre o disco de inicialização, execute o comando gcloud compute disks describe:

   gcloud compute disks describe DISK_NAME \
      --zone=ZONE
   

   Substitua:

   • DISK_NAME: o nome do disco de inicialização para validar a licença

   • ZONE: a zona que contém o disco de inicialização para validar a licença.

2. Verifique um resultado semelhante a:

   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:
   - '8045211386737108299'
   licenses:
   - 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
   

3. Confirme se a licença do Ubuntu Pro foi adicionada ao disco de inicialização verificando a saída da etapa anterior do campo licenses para a string de licença apropriada.

   Se o campo licenses não contiver a string de licença desejada, talvez seja necessário limpar e atualizar as licenças. Para mais informações, consulte o comando gcloud compute disks update.

4. Inicie a VM usando o comando gcloud compute instances start:

   gcloud compute instances start VM_NAME \
      --zone=ZONE \
      [--csek-key-file ENCRYPTION_KEY]
   

   Substitua:

   • VM_NAME: o nome da VM a ser iniciada

   • ZONE: a zona que contém a VM a ser iniciada

   • ENCRYPTION_KEY: opcional. Se o disco de inicialização estiver criptografado com uma chave de criptografia fornecida pelo cliente (CSEK) (descontinuado), especifica o caminho para o arquivo de chave.

5. Depois que a VM for inicializada, execute o comando gcloud compute ssh para verificar se o ESM do Ubuntu tem direito e está ativado:

   gcloud compute ssh VM_NAME --command "sudo ua status --wait" \
      --zone=ZONE
   

   Substitua:

   • VM_NAME: o nome da VM a ser verificada.

   • ZONE: a zona que contém a VM a ser verificada.

6. Verifique se o ESM do Ubuntu tem direito e está ativado, verificando se a saída é semelhante a:

   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
   

Ver registros de atividades

Veja o histórico de atualizações de licença para VMs em um projeto usando o procedimento a seguir:

1. No console do Cloud de Confiance , acesse a página Análise de registros.

   Acessar a Análise de registros

2. Na barra de ferramentas, verifique se a opção Mostrar consulta está ativada.

3. Copie a seguinte expressão no editor de consultas:

   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. Substitua PROJECT_NAME pelo nome do projeto.

5. Clique em Executar consulta.