Gerenciar licenças

Neste documento, explicamos como gerenciar licenças associadas a uma instância do Compute Engine. Isso inclui como anexar, remover, substituir e ver o histórico de atualizações de licença. Para mais informações sobre licenças no Compute Engine, consulte Sobre licenças.

Restrições para gerenciar licenças:

• Só é possível adicionar uma licença a um disco se AppendableToDisk for true.
• Só é possível remover (sem substituição) se RemovableFromDisk for true.
• Só é possível substituir uma licença por uma das opções listadas em AllowedReplacementLicenses.

Para fazer upgrade da sua licença do Ubuntu LTS para o Ubuntu Pro e ativar a manutenção de segurança estendida (ESM), consulte Fazer upgrade do Ubuntu para o Ubuntu Pro.

Para atualizar sua licença do RHEL sob demanda e incluir suporte estendido, consulte Anexar o complemento de suporte de ciclo de vida estendido (ELS) do RHEL à sua licença.

Antes de começar

• Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Trusted Cloud 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:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

  gcloud

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

     gcloud init

  2. Set a default region and zone.

  REST

  Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

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

  gcloud init

  Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted Cloud .

Preparar para atualizar a licença de um disco

Para atualizar a licença do disco enquanto ele está anexado a uma instância em execução, primeiro pare a instância ou remova o disco.

• Interrompa a instância. Desliga temporariamente a instância antes de atualizar a licença do disco.
• Desanexe o disco. Isso desanexa o disco da instância antes de atualizar a licença dele.

Ver as licenças associadas a uma VM

Para visualizar as licenças associadas a uma VM, use o Trusted Cloud console, a CLI gcloud ou a API Compute Engine.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instancesVM_NAME

Adicionar uma licença ao final durante a importação de uma imagem

Para incluir uma licença durante o processo de importação de imagens, use o seguinte comando gcloud compute images import.

gcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE
  --os=OS

Substitua:

• IMAGE_NAME: o nome da imagem a ser criada.
• SOURCE_FILE: um arquivo local ou o URI do Cloud Storage do disco virtual a ser importado.
• OS: o SO da imagem de disco a ser importada. A licença do SO é inferida a partir do valor dessa sinalização. Não há uma sinalização explícita para fornecer informações de licença durante a importação. Para uma lista de valores compatíveis, consulte a sinalização --os.

Para mais informações sobre como importar imagens, consulte Como importar discos virtuais.

Incluir licenças ao criar uma imagem

Para anexar licenças ao criar uma imagem, use o comando gcloud compute images create.

gcloud compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES

Substitua:

• IMAGE_NAME: o nome da imagem a ser criada.
• SOURCE_IMAGE: o nome da imagem a partir da qual a nova imagem vai ser criada.
• LICENSES: uma lista separada por vírgulas de strings de licença. Exemplo: "license1", "license2".

Para mais informações sobre como criar imagens, consulte Como criar, excluir e suspender o uso de imagens personalizadas e Como criar uma imagem do Windows.

Para mais informações sobre como criar imagens, consulte Como criar, excluir e suspender o uso de imagens personalizadas e Como criar uma imagem do Windows.

Anexar licenças a um disco

Para adicionar licenças associadas a uma VM, use a CLI gcloud ou a API Compute Engine.

gcloud compute disks update DISK_NAME \
--append-licenses=LICENSES

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/LICENSES"]}'

Substituir licenças em um disco

Para substituir as licenças associadas a uma VM, use a CLI gcloud ou a API Compute Engine.

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

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/NEW_LICENSE"]}'

Remover licenças de um disco

Para remover licenças individuais associadas a uma VM, use a CLI gcloud e a API Compute Engine.

gcloud compute disks update DISK_NAME \
--remove-licenses=LICENSES

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":[]}'

Ver o histórico de atualizações de licenças

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

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

   Acessar o Explorador 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.

A seguir

• Resolver problemas com licenças

• Saiba mais sobre as licenças da Microsoft no Compute Engine

• Analisar as mudanças e restrições de licença

• Saiba mais sobre os sistemas operacionais premium:

  • Consulte as perguntas frequentes sobre o RHEL

  • Consulte as perguntas frequentes sobre o Ubuntu Pro