Algumas ou todas as informações nesta página podem não se aplicar ao Cloud de Confiance da S3NS. Consulte Diferenças do Google Cloud para saber mais.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

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:

Instale atualizações e dependências.
Substitua a licença do Ubuntu pela do Ubuntu Pro.
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

Você vai receber cobranças pelo Ubuntu Pro LTS 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 serviços Cloud de Confiance by S3NS e APIs, 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
  Observação:se você já instalou a CLI gcloud, execute o comando gcloud components update para verificar se tem a versão mais recente.
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:

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

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 nenhum Licenses foi substituído.

Para saber o nome do disco de inicialização, execute o comando gcloud compute disks list:
```
gcloud compute disks list
```
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 para substituir a licença.
- 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 das 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:

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.

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

Valide se a licença do Ubuntu Pro está anexada 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 pretendida, talvez seja necessário limpar e atualizar as licenças. Para mais informações, consulte o comando gcloud compute disks update.
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
Após a inicialização da VM, execute o comando gcloud compute ssh para verificar se o ESM do Ubuntu está autorizado e 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.

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:

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

Acessar a Análise de registros
Na barra de ferramentas, verifique se a opção Mostrar consulta está ativada.

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

Substitua PROJECT_NAME pelo nome do projeto.
Clique em Executar consulta.

Fazer upgrade do Ubuntu para Ubuntu Pro

Caminhos de upgrade compatíveis

Limitações

Faturamento

Antes de começar

Console

gcloud

Substituir a licença

Permissões exigidas para a tarefa

Validar a licença

Permissões exigidas para a tarefa

Ver registros de atividades