Atualize do Ubuntu para o Ubuntu Pro

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

---

Quando uma imagem Ubuntu LTS chega ao fim de sua vida útil , ela não é mais suportada e não receberá atualizações de segurança. Se você atualizar para o Ubuntu Pro , continuará recebendo atualizações de segurança durante a Manutenção Estendida de Segurança (ESM) .

Este documento mostra como atualizar do Ubuntu para o Ubuntu Pro fazendo o seguinte para cada VM:

1. Instalando atualizações e dependências
2. Anexando a licença do Ubuntu Pro
3. Validando a licença

Caminhos de atualização suportados

A tabela a seguir mostra os caminhos de atualização suportados:

Versão inicial	Versão final
Ubuntu 16.04LTS	Ubuntu Pro 16.04LTS
Ubuntu 18.04LTS	Ubuntu Pro 18.04LTS
Ubuntu 20.04LTS	Ubuntu Pro 20.04 LTS
Ubuntu 22.04LTS	Ubuntu Pro 22.04LTS
Ubuntu 24.04LTS	Ubuntu Pro 24.04LTS

Limitações

• Você deve parar uma VM antes de anexar uma licença.

• Você só pode atualizar do Ubuntu LTS para o Ubuntu Pro LTS se eles forem da mesma versão. Por exemplo, você pode atualizar do Ubuntu 16.04 LTS para o Ubuntu Pro 16.04 LTS, mas não pode atualizar do Ubuntu 16.04 LTS para o Ubuntu Pro 20.04 LTS.

Cobrança

Você será cobrado pelo Ubuntu Pro LTS de acordo com o preço das imagens premium .

Para obter 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 a ser atualizada:

  1. Atualize o índice do pacote usando o seguinte comando:

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

  2. Instale a versão mais recente dos pacotes usando o seguinte 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"

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

  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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

Anexar a licença

Permissões necessárias para esta tarefa

Para executar esta tarefa, você deve ter as seguintes permissões :

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

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

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

   gcloud compute instances stop VM_NAME \
      --zone=ZONE
   

   Substitua o seguinte:

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

2. Obtenha 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 o seguinte:

   • VM_NAME : o nome da VM da qual obter a lista de discos associados

   • ZONE : a zona que contém a VM da qual obter 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
   

   Observe que nenhuma userLicenses foi anexada.

4. Obtenha o nome do disco de inicialização executando o comando gcloud compute disks list :

   gcloud compute disks list
   

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

   gcloud beta compute disks update BOOT_DISK_NAME \
      --zone=ZONE \
      --update-user-licenses="LICENSE_URI"
   

   Substitua o seguinte:

   • BOOT_DISK_NAME : o nome do disco de inicialização ao qual anexar a licença.

   • ZONE : a zona que contém o disco de inicialização ao qual anexar a licença.

   • LICENSE_URI : o URI de licença da versão do Ubuntu Pro para a qual você está atualizando. A tabela a seguir mostra o URI de licença para as versões suportadas do Ubuntu Pro:

     Versão Ubuntu Pro	URI de licença
     Ubuntu Pro 16.04LTS	https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-1604-lts
     Ubuntu Pro 18.04LTS	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.04LTS	https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-2204-lts
     Ubuntu Pro 24.04LTS	https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-2404-lts

Validar a licença

Permissões necessárias para esta tarefa

Para executar esta tarefa, você deve 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. Obtenha informações sobre o disco de inicialização executando o comando gcloud beta compute disks describe :

   gcloud beta compute disks describe BOOT_DISK_NAME \
      --zone=ZONE
   

   Substitua o seguinte:

   • BOOT_DISK_NAME : o nome do disco de boot para validar a licença do

   • ZONE : a zona que contém o disco de boot para validar a licença do

2. Verifique a saída 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:
   - '1000201'
   - '8045211386737108299'
   licenses:
   - https://www.googleapis.com/compute/v1/projects/ubuntu-os-cloud/global/licenses/ubuntu-1604-xenial
   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
   userLicenses:
   - https://www.googleapis.com/compute/v1/projects/ubuntu-os-pro-cloud/global/licenses/ubuntu-pro-1604-lts
   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. Valide se a licença do Ubuntu Pro está anexada ao disco de inicialização verificando a saída da etapa anterior no campo userLicenses para obter a sequência de licença apropriada.

   Se o campo userLicenses não contiver a sequência de licença pretendida, talvez seja necessário limpar e atualizar as licenças de usuário. Para obter mais informações, consulte o comando gcloud beta 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 o seguinte:

   • VM_NAME : o nome da VM a ser iniciada

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

   • ENCRYPTION_KEY : um sinalizador opcional que especifica o caminho para o arquivo CSEK (chave de criptografia fornecida pelo cliente) se o disco de inicialização estiver criptografado

5. Após a inicialização da VM, execute o comando gcloud compute ssh para verificar se o Ubuntu ESM está autorizado e ativado:

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

   Substitua o seguinte:

   • VM_NAME : o nome da VM a ser verificada

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

6. Verifique se o Ubuntu ESM está autorizado e habilitado, 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 auditoria

Visualize o histórico de atualizações de licença usando o procedimento a seguir:

1. No console do Google Cloud, acesse a página Atividade .

   Vá para a atividade

2. No painel Filtros em Categorias , para Tipos de atividade, selecione Configuração .

3. No painel Filtros em Categorias , para o Tipo de recurso selecione Disco .