Criar um MIG que use VMs Spot

Console

1. No console do Cloud de Confiance , acesse a página Modelos de instância.

   Acessar "Modelos de instância"

2. Clique em Criar modelo de instância. A página Criar um modelo de instância é exibida.

3. No campo Nome, insira um nome para o modelo de instância.

4. Na seção Local, selecione o tipo de modelo de instância que você quer criar:

   • Para um modelo de instância regional, selecione Regional e escolha a região em que você quer criar o modelo. Com base no tipo de máquina que você quer que as VMs do Spot usem, especifique uma região com disponibilidade.

   • Para um modelo de instância global, selecione Global.

5. Na seção Configuração da máquina, selecione uma série de máquinas compatível para VMs spot.

6. Na seção Modelo de provisionamento, faça o seguinte:

   1. Na lista Modelo de provisionamento de VM, selecione Spot. A seção Configurações avançadas do modelo de provisionamento de VM é aberta.

   2. Na lista Duração do aviso de remoção, selecione uma opção com base em como você quer lidar com a remoção.

      • Se você selecionar 120 segundos (recomendado), processe a preempção na sua carga de trabalho antes de criar uma VM spot. Por exemplo, verifique se sua carga de trabalho inclui um script para salvar seu progresso que aguarda a execução até que a remoção seja detectada.

      • Se você selecionar 0 segundos (padrão), processe a preempção usando um script de encerramento. Antes de criar uma VM Spot, crie um arquivo que contenha um script de desligamento que salve seu progresso quando o desligamento for causado por preempção. Anexe esse script de desligamento conforme explicado em uma etapa posterior.

   3. Para especificar se as VMs Spot serão interrompidas ou excluídas na preempção, na lista No encerramento da VM, selecione uma das seguintes opções:

      • Para interromper as VMs do Spot, selecione Parar.

      • Para excluir VMs Spot, selecione Excluir.

7. Para adicionar um script de desligamento, siga estas etapas. Se você selecionou 0 segundos (padrão) para a Duração do aviso de remoção, esta etapa é necessária para lidar com a remoção. Caso contrário, se você selecionou 120 segundos, esta etapa é opcional.

   1. Expanda a seção Opções avançadas.
   2. Expanda a seção Gerenciamento.
   3. Na seção Metadados, clique em add Adicionar item.
   4. No campo Chave, insira shutdown-script para a chave de metadados.
   5. No campo Valor, adicione o conteúdo de um script de desligamento que lida com a remoção.

8. Opcional: para alterar o valor padrão do tipo ou da imagem do disco de inicialização, na seção Disco de inicialização, clique em Alterar. Depois, siga as instruções para alterar o disco de inicialização.

9. Clique em Criar.

gcloud

Para criar um modelo de instância configurado para criar VMs Spot, use o comando gcloud compute instance-templates create.

O comando a seguir cria um modelo de instância regional. Se você quiser criar um modelo de instância global, use o mesmo comando sem a flag --instance-template-region.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-template-region=REGION \
    --instance-termination-action=TERMINATION_ACTION \
    --machine-type=MACHINE_TYPE \
    --provisioning-model=SPOT \
    --preemption-notice-duration=PREEMPTION_NOTICE_DURATION \
    --metadata shutdown-script=SHUTDOWN_SCRIPT

Substitua:

• INSTANCE_TEMPLATE_NAME: o nome do modelo de instância a ser criado.

• IMAGE_PROJECT: o projeto de imagem que contém a imagem, por exemplo, debian-cloud. Para mais detalhes sobre os projetos de imagem disponíveis, consulte Imagens públicas.

• IMAGE_FAMILY: uma família de imagens. Isso especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar debian-12, a versão mais recente na família de imagens do Debian 12 será usada. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.

• REGION: a região em que o modelo de instância será criado. Com base no tipo de máquina que você quer que as VMs Spot usem, especifique uma região com disponibilidade.

• TERMINATION_ACTION: se o Compute Engine interrompe ou exclui as VMs spot na preempção. É necessário especificar se as VMs serão interrompidas (STOP) ou excluídas (DELETE).

• MACHINE_TYPE: um tipo de máquina compatível com VMs Spot. Se você especificar um tipo de máquina N1, inclua a flag --accelerator para definir o número e o tipo de GPUs a serem anexadas às VMs.

• PREEMPTION_NOTICE_DURATION: se uma duração de aviso de remoção será ativada. Para a CLI gcloud, o valor precisa ser 120s ou 0s.

  • Se você especificar 120s (recomendado), processe a remoção preventiva na sua carga de trabalho. (Também é possível especificar um script de desligamento.)

  • Se você especificar 0s (padrão), processe a preempção em um script de desligamento.

• SHUTDOWN_SCRIPT: um script de desligamento.

  • Se você definir PREEMPTION_NOTICE_DURATION como 0s (padrão), especifique um script de desligamento para lidar com a remoção. Para mais informações sobre como formatar e especificar um script de encerramento, consulte Executar scripts de encerramento.

  • Caso contrário, se você não quiser especificar um script de desligamento, remova a flag --metadata shutdown-script.

REST

Para criar um modelo de instância configurado para criar VMs Spot, faça uma das seguintes solicitações POST:

• Para criar um modelo de instância regional: método regionInstanceTemplates.insert

• Para criar um modelo de instância global: método instanceTemplates.insert

Por exemplo, para criar um modelo de instância regional, faça uma solicitação da seguinte maneira:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "instanceTerminationAction": "TERMINATION_ACTION",
      "provisioningModel": "SPOT",
      "preemptionNoticeDuration": { "seconds": PREEMPTION_NOTICE_DURATION }
    },
    "metadata": {
      "items": [
        {
          "key": "shutdown-script",
          "value": "SHUTDOWN_SCRIPT"
        }
      ]
    }
  }
}

Substitua:

• PROJECT_ID: o ID do projeto em que o modelo de instância será criado.

• REGION: a região em que o modelo de instância será criado. Com base no tipo de máquina que você quer que as VMs Spot usem, especifique uma região com disponibilidade.

• INSTANCE_TEMPLATE_NAME: o nome do modelo de instância.

• IMAGE_PROJECT: o projeto de imagem que contém a imagem, por exemplo, debian-cloud. Para mais detalhes sobre os projetos de imagem disponíveis, consulte Imagens públicas.

• IMAGE: especifique uma destas opções:

  • Uma versão específica da imagem do SO, como debian-12-bookworm-v20240617.

  • Uma família de imagens, que precisa ter o formato family/IMAGE_FAMILY. Ela especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, a versão mais recente na família de imagens do Debian 12 será usada. Para saber como usar famílias de imagens, consulte Práticas recomendadas para famílias de imagens.

• MACHINE_TYPE: um tipo de máquina compatível com VMs Spot. Se você especificar um tipo de máquina N1, inclua o campo guestAccelerators para definir o número e o tipo de GPUs a serem anexadas às VMs.

• TERMINATION_ACTION: se o Compute Engine interrompe ou exclui as VMs spot na preempção. É necessário especificar se as VMs serão interrompidas (STOP) ou excluídas (DELETE).

• PREEMPTION_NOTICE_DURATION: se uma duração de aviso de remoção será ativada. Para REST, o valor precisa ser 120 ou 0.

  • Se você especificar 120 (recomendado), processe a remoção preventiva na sua carga de trabalho. (Também é possível especificar um script de desligamento.)

  • Se você especificar 0 (padrão), processe a preempção em um script de desligamento.

• SHUTDOWN_SCRIPT: um script de desligamento.

  • Se você definir PREEMPTION_NOTICE_DURATION como 0s (padrão), especifique um script de desligamento para lidar com a remoção. Para mais informações sobre como formatar e especificar um script de encerramento, consulte Executar scripts de encerramento.

  • Caso contrário, se você não quiser especificar um script de desligamento, remova o campo metadata e os subcampos.

• TERMINATION_ACTION: opcional: especifique qual ação de encerramento a ser realizada quando o Compute Engine forçar a interrupção da VM, STOP (comportamento padrão) ou DELETE.

Console

1. No console, do Cloud de Confiance , acesse a página Grupos de instâncias.

   Acesse grupo de instâncias

2. Clique em Criar grupo de instâncias. A página Criar grupo de instâncias é aberta.

3. No campo Nome, insira um nome para o MIG.

4. Na lista Modelo de instância, selecione o modelo de instância que você criou na seção anterior.

5. No campo Número de instâncias, insira o número de VMs Spot a serem criadas no MIG. Se a carga de trabalho exigir VMs com nomes específicos, insira 0 para pular a criação de VMs nesta etapa. Depois de criar o MIG, adicione VMs com nomes específicos a ele.

6. Na seção Local, especifique se você quer criar um MIG zonal ou regional da seguinte maneira:

   1. Para criar um MIG zonal, selecione Zona única. Ou, para criar um MIG regional, selecione Várias zonas.

   2. Selecione a Região e as Zonas do MIG.

7. Clique em Criar.

gcloud

Para criar um MIG, use o comando gcloud compute instance-groups managed create.

De acordo com o tipo de MIG que você quer criar, inclua as seguintes flags no comando:

• Para criar um MIG zonal, inclua a flag --zone:

  gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
      --size=SIZE \
      --template=INSTANCE_TEMPLATE_URL \
      --zone=ZONE
  

• Para criar um MIG regional, inclua a flag --region:

  gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
      --size=SIZE \
      --template=INSTANCE_TEMPLATE_URL \
      --region=REGION
  

Substitua:

• INSTANCE_GROUP_NAME: o nome do MIG;

• INSTANCE_TEMPLATE_URL: o URL do modelo de instância que você criou na seção anterior. O URL pode conter o ID ou o nome do modelo de instância. Especifique um dos seguintes valores:

  • Para um modelo de instância regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID

  • Para um modelo de instância global: INSTANCE_TEMPLATE_ID

• SIZE: o número de VMs do Spot a serem criadas no MIG. Se a carga de trabalho exigir nomes de VM específicos, especifique 0 para pular a criação de VMs nesta etapa. Depois de criar o MIG, adicione VMs com nomes específicos a ele.

• ZONE: a zona em que o MIG zonal será criado. Se você usar um modelo de instância regional para criar o MIG, especifique uma zona na mesma região do modelo.

• REGION: a região em que o MIG regional será criado. Se você usar um modelo de instância regional para criar o MIG, especifique a mesma região do modelo.

REST

Para criar um MIG, faça uma solicitação POST a um dos seguintes métodos:

• Para criar um MIG zonal, faça uma solicitação POST para o método instanceGroupManagers.insert:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
  
  {
    "name": "INSTANCE_GROUP_NAME",
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ],
    "targetSize": SIZE
  }
  

• Para criar um MIG regional, faça uma solicitação POST para o método regionInstanceGroupManagers.insert:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers
  
  {
    "name": "INSTANCE_GROUP_NAME",
    "instanceTemplate": "INSTANCE_TEMPLATE_URL",
    "targetSize": SIZE
  }
  

Substitua:

• PROJECT_ID: o ID do projeto em que o MIG regional ou zonal será criado.

• ZONE: a zona em que o MIG zonal será criado. Se você usar um modelo de instância regional para criar o MIG, especifique uma zona na mesma região do modelo.

• REGION: a região em que o MIG regional será criado. Se você usar um modelo de instância regional para criar o MIG, especifique a mesma região do modelo.

• INSTANCE_GROUP_NAME: o nome do MIG;

• INSTANCE_TEMPLATE_URL: o URL do modelo de instância que você criou na seção anterior. O URL pode conter o ID ou o nome do modelo de instância. Especifique um dos seguintes valores:

  • Para um modelo de instância regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID

  • Para um modelo de instância global: INSTANCE_TEMPLATE_ID

• SIZE: o número de VMs do Spot a serem criadas no MIG. Se a carga de trabalho exigir nomes específicos de VM, especifique 0 para pular a criação de VMs nesta etapa. Depois de criar o MIG, adicione VMs com nomes específicos a ele.