Crie pedidos de redimensionamento num MIG

Consola

1. Na Google Cloud consola, aceda à página Modelos de instâncias.

   Aceda a Modelos de instâncias

2. Clique em Criar modelo de instância. É apresentada a página Criar um modelo de instância.

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

4. Na secção Localização, selecione uma das seguintes opções:

   • Para criar um modelo de instância regional, selecione Regional (recomendado) e, de seguida, selecione a região na qual criar o modelo.

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

5. Na secção Configuração da máquina, especifique um tipo de máquina com GPU ou um tipo de máquina H4D.

6. Na secção Modelo de aprovisionamento, conclua os seguintes passos:

   1. No campo Modelo de aprovisionamento de VMs, selecione Início flexível.

   2. Expanda as definições avançadas do modelo de aprovisionamento de VMs.

   3. Selecione a caixa de verificação Definir um limite de tempo para a VM.

   4. Para definir uma duração de execução para as VMs criadas através do modelo de instância, no campo Introduza o número de horas, introduza o número de horas. O valor tem de estar compreendido entre 36 segundos (0.01) e sete dias (168).

7. Opcional: para alterar o tipo ou a imagem do disco de arranque predefinido, na secção Disco de arranque, clique em Alterar. Em seguida, siga as instruções para alterar o disco de arranque.

8. Clique em Criar.

gcloud

Para criar um modelo de instância, use o comando instance-templates create com as seguintes flags:

• A flag --instance-termination-action está definida como DELETE.

• A flag --maintenance-policy está definida como TERMINATE.

• A bandeira de --max-run-duration.

• A flag --provisioning-model está definida como FLEX_START.

• A flag --reservation-affinity está definida como none.

Por exemplo, para criar um modelo de instância regional, execute o seguinte comando. Se 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=DELETE \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --max-run-duration=RUN_DURATION \
    --provisioning-model=FLEX_START \
    --reservation-affinity=none

Substitua o seguinte:

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

• IMAGE_PROJECT: o projeto de imagem que contém a imagem; por exemplo, debian-cloud. Para mais informações sobre os projetos de imagens suportados, consulte o artigo Imagens públicas.

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

• REGION: a região na qual criar o modelo de instância.

• MACHINE_TYPE: o tipo de máquina de GPU ou o tipo de máquina H4D a usar para as VMs de início flexível. Se especificar um tipo de máquina N1, tem de incluir a flag --accelerator para definir o número e o tipo de GPUs a anexar às suas VMs.

• RUN_DURATION: a duração durante a qual quer que as VMs pedidas sejam executadas. Tem de formatar o valor como o número de dias, horas, minutos ou segundos, seguido de d, h, m e s, respetivamente. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para um dia, duas horas, três minutos e quatro segundos. O valor tem de estar entre 10 minutos e sete dias.

REST

Para criar um modelo de instância, faça um pedido POST através de um dos seguintes métodos:

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

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

No corpo do pedido, inclua os seguintes campos:

• O campo reservationAffinity.consumeReservationType está definido como NO_RESERVATION.

• O campo scheduling.instanceTerminationAction está definido como DELETE.

• O campo scheduling.maxRunDuration.

• O campo scheduling.onHostMaintenance está definido como TERMINATE.

• O campo scheduling.provisioningModel está definido como FLEX_START.

Por exemplo, para criar um modelo de instância regional, faça um pedido da seguinte forma:

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"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "NO_RESERVATION"
    },
    "scheduling": {
      "instanceTerminationAction": "DELETE",
      "maxRunDuration": {
        "seconds": RUN_DURATION
      },
      "onHostMaintenance": "TERMINATE",
      "provisioningModel": "FLEX_START"
    }
  }
}

Substitua o seguinte:

• PROJECT_ID: o ID do projeto no qual criar o modelo de instância.

• REGION: a região na qual criar o modelo de instância.

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

• IMAGE_PROJECT: o projeto de imagem que contém a imagem; por exemplo, debian-cloud. Para mais informações sobre os projetos de imagens suportados, consulte o artigo Imagens públicas.

• IMAGE: especifique uma das seguintes opções:

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

  • Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto especifica a imagem do SO não descontinuada mais recente. Por exemplo, se especificar family/debian-12, é usada a versão mais recente na família de imagens do Debian 12. Para mais informações sobre a utilização de famílias de imagens, consulte o artigo Práticas recomendadas para famílias de imagens.

• MACHINE_TYPE: o tipo de máquina da GPU a usar para as VMs. Se especificar um tipo de máquina N1, tem de incluir o campo guestAccelerators para definir o número e o tipo de GPUs a associar às suas VMs.

• RUN_DURATION: a duração, em segundos, durante a qual quer que as VMs pedidas sejam executadas. O valor tem de estar entre 600, que é 600 segundos (10 minutos), e 604800, que é 604 800 segundos (sete dias).

Consola

1. Na Google Cloud consola, aceda à página Modelos de instâncias.

   Aceda a Modelos de instâncias

2. Clique em Criar modelo de instância. É apresentada a página Criar um modelo de instância.

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

4. Na secção Localização, selecione uma das seguintes opções:

   • Para criar um modelo de instância regional, selecione Regional (recomendado) e, de seguida, selecione a região na qual criar o modelo.

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

5. Na secção Configuração da máquina, especifique um tipo de máquina A4, A3 Ultra ou H4D.

6. Na secção Modelo de aprovisionamento, conclua os seguintes passos:

   1. Expanda as definições avançadas do modelo de aprovisionamento de VMs.

   2. Na lista On VM termination, selecione Delete.

7. Opcional: para alterar o tipo ou a imagem do disco de arranque predefinido, na secção Disco de arranque, clique em Alterar. Em seguida, siga as instruções para alterar o disco de arranque.

8. Expanda a secção Opções avançadas e, de seguida, faça o seguinte:

   1. Expanda a secção Gestão.

   2. Na secção Reservas, selecione Escolher uma reserva e, de seguida, clique em Escolher reserva. No painel apresentado, siga as instruções para selecionar a reserva que quer usar.

9. Clique em Criar.

gcloud

Para criar um modelo de instância, use o comando instance-templates create com as seguintes flags:

• A flag --instance-termination-action está definida como DELETE.

• A flag --maintenance-policy está definida como TERMINATE.

• A flag --provisioning-model está definida como RESERVATION_BOUND.

• A flag --reservation-affinity está definida como specific.

• A bandeira de --reservation.

Por exemplo, para criar um modelo de instância regional, execute o seguinte comando. Se 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-termination-action=DELETE \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --provisioning-model=RESERVATION_BOUND \
    --reservation-affinity=specific \
    --reservation=RESERVATION_URL

Substitua o seguinte:

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

• IMAGE_PROJECT: o projeto de imagem que contém a imagem; por exemplo, debian-cloud. Para mais informações sobre os projetos de imagens suportados, consulte o artigo Imagens públicas.

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

• REGION: a região na qual criar o modelo de instância.

• MACHINE_TYPE: o tipo de máquina A4 ou A3 Ultra especificado na reserva que quer consumir.

• RESERVATION_URL: o URL da reserva criada automaticamente para uma reserva futura no modo de calendário que quer usar. Especifique um dos seguintes valores:

  • Se a reserva criada automaticamente existir no seu projeto: RESERVATION_NAME.

  • Se a reserva criada automaticamente existir num projeto diferente: projects/PROJECT_ID/reservations/RESERVATION_NAME.

REST

Para criar um modelo de instância, faça um pedido POST através de um dos seguintes métodos:

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

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

No corpo do pedido, inclua os seguintes campos:

• O campo reservationAffinity.consumeReservationType está definido como SPECIFIC_RESERVATION.

• O campo reservationAffinity.key está definido como compute.googleapis.com/reservation-name.

• O campo reservationAffinity.values está definido para o URL da reserva criada automaticamente.

• O campo scheduling.instanceTerminationAction está definido como DELETE.

• O campo scheduling.onHostMaintenance está definido como TERMINATE.

• O campo scheduling.provisioningModel está definido como RESERVATION_BOUND.

Por exemplo, para criar um modelo de instância regional, faça um pedido da seguinte forma:

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"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "SPECIFIC_RESERVATION",
      "key": "compute.googleapis.com/reservation-name",
      "values": [
        "RESERVATION_URL"
      ]
    },
    "scheduling": {
      "instanceTerminationAction": "DELETE",
      "onHostMaintenance": "TERMINATE",
      "provisioningModel": "RESERVATION_BOUND"
    }
  }
}

Substitua o seguinte:

• PROJECT_ID: o ID do projeto no qual criar o modelo de instância.

• REGION: a região na qual criar o modelo de instância.

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

• IMAGE_PROJECT: o projeto de imagem que contém a imagem; por exemplo, debian-cloud. Para mais informações sobre os projetos de imagens suportados, consulte o artigo Imagens públicas.

• IMAGE: especifique uma das seguintes opções:

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

  • Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto especifica a imagem do SO não descontinuada mais recente. Por exemplo, se especificar family/debian-12, é usada a versão mais recente na família de imagens do Debian 12. Para mais informações sobre a utilização de famílias de imagens, consulte o artigo Práticas recomendadas para famílias de imagens.

• MACHINE_TYPE: o tipo de máquina A4 ou A3 Ultra especificado na reserva que quer consumir.

• RESERVATION_URL: o URL da reserva criada automaticamente para uma reserva futura no modo de calendário que quer usar. Especifique um dos seguintes valores:

  • Se a reserva criada automaticamente existir no seu projeto: RESERVATION_NAME

  • Se a reserva criada automaticamente existir num projeto diferente: projects/PROJECT_ID/reservations/RESERVATION_NAME

Consola

1. Na Google Cloud consola, aceda à página Grupos de instâncias.

   Aceda a Grupos de instâncias

2. Clique em Criar grupo de instâncias. É apresentada a página Criar grupo de instâncias.

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

4. Antes de selecionar um modelo de instância, tem de eliminar a configuração do ajuste de escala automático e desativar as reparações da seguinte forma:

   1. Para eliminar a configuração do ajuste automático, faça o seguinte:

      1. Na secção Ajuste automático de escala, clique na lista Modo de ajuste automático de escala e, de seguida, clique em Eliminar configuração do ajuste automático de escala.

      2. Na caixa de diálogo de confirmação, clique em Eliminar.

   2. Para desativar as reparações, na secção Ciclo de vida da instância de VM, clique na lista Ação predefinida em caso de falha e, de seguida, selecione Nenhuma ação.

5. Volte ao campo Modelo de instância. Na lista Modelo de instância, selecione o modelo de instância que criou na secção anterior. Se selecionar um modelo de instância regional, a lista Região é definida para a região do modelo.

6. Efetue um dos seguintes passos:

   • Para criar um pedido de redimensionamento quando criar o MIG, faça o seguinte:

     1. No campo Número de instâncias, introduza o número de VMs que quer criar de uma só vez.

     2. Selecione a caixa de verificação Usar pedido de redimensionamento para criar VMs de uma só vez.

     3. Opcional: se o modelo de instância do MIG especificar uma duração de execução, pode especificar uma duração de execução diferente. Para tal, nos campos Duração da execução pedida e nas listas Unidade, especifique uma duração da execução. Tem de especificar uma duração entre uma hora e sete dias.

   • Para criar um pedido de redimensionamento depois de criar o MIG, no campo Número de instâncias, introduza 0.

7. Na secção Localização, especifique se quer criar um GIG zonal ou regional da seguinte forma:

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

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

   3. Se estiver a criar um MIG regional, faça o seguinte:

      1. No campo Forma de distribuição de destino, selecione Qualquer zona única.

      2. Na caixa de diálogo apresentada, clique em Desativar redistribuição de instâncias.

8. Clique em Criar.

gcloud

Use o comando instance-groups managed create com o sinalizador --default-action-on-vm-failure definido como do_nothing. Se estiver a criar um MIG regional, também tem de incluir a sinalização --target-distribution-shape definida como any-single-zone e a sinalização --instance-redistribution-type definida como none.

• Para criar um MIG zonal, execute o seguinte comando:

  gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
      --template=INSTANCE_TEMPLATE_URL \
      --size=0 \
      --zone=ZONE \
      --default-action-on-vm-failure=do_nothing
  

• Para criar um MIG regional, execute o seguinte comando:

  gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
      --template=INSTANCE_TEMPLATE_URL \
      --size=0 \
      --region=REGION \
      --target-distribution-shape=any-single-zone \
      --instance-redistribution-type=none \
      --default-action-on-vm-failure=do_nothing
  

Substitua o seguinte:

• INSTANCE_GROUP_NAME: o nome do MIG a criar.

• INSTANCE_TEMPLATE_URL: o URL parcial do modelo de instância que criou na secção anterior. Se quiser usar um modelo de instância regional para criar o MIG, só pode criar o MIG na região do modelo. Especifique um dos seguintes valores:

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

  • Para um modelo de instância global: INSTANCE_TEMPLATE_NAME

• ZONE: a zona na qual criar o MIG.

• REGION: a região na qual criar o MIG.

REST

• Para criar um MIG zonal, envie um pedido POST através do método instanceGroupManagers.insert da seguinte forma:

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

• Para criar um MIG regional, envie um pedido POST através do método regionInstanceGroupManagers.insert da seguinte forma:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers
  
  {
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ],
    "name": "INSTANCE_GROUP_NAME",
    "targetSize": 0,
    "distributionPolicy": {
      "targetShape": "ANY_SINGLE_ZONE"
    },
    "updatePolicy": {
      "instanceRedistributionType": "NONE"
    },
    "instanceLifecyclePolicy": {
      "defaultActionOnFailure": "DO_NOTHING"
    }
  }
  

Substitua o seguinte:

• PROJECT_ID: o ID do projeto onde existe o modelo de instância que criou na secção anterior.

• INSTANCE_TEMPLATE_URL: o URL parcial do modelo de instância que criou na secção anterior. Se quiser usar um modelo de instância regional para criar o MIG, só pode criar o MIG na região do modelo. Especifique um dos seguintes valores:

  • Para um modelo de instância regional: regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

  • Para um modelo de instância global: global/instanceTemplates/INSTANCE_TEMPLATE_NAME

• ZONE: a zona na qual criar o MIG.

• REGION: a região na qual criar o MIG.

• INSTANCE_GROUP_NAME: o nome do MIG a criar.

Consola

1. Na Google Cloud consola, aceda à página Grupos de instâncias.

   Aceda a Grupos de instâncias

2. Na coluna Nome, clique no nome do MIG no qual quer criar o pedido de redimensionamento.

   É aberta a página de vista geral do MIG.

3. Na linha Pedidos de redimensionamento, clique em edit Editar pedidos de redimensionamento.

4. Clique em add Novo pedido de redimensionamento.

   É apresentado o painel Novos pedidos de redimensionamento.

5. No campo Nome, introduza o nome do pedido de redimensionamento.

6. No campo Número de instâncias adicionais necessárias, introduza o número de VMs a adicionar ao MIG de uma só vez.

7. Opcional: se o modelo de instância do MIG especificar uma duração de execução, pode especificar uma duração de execução diferente. Para o fazer, nos campos Duração da execução pedida e Unidade, especifique uma duração da execução. Tem de especificar uma duração entre uma hora e sete dias.

8. Clique em Criar.

gcloud

• Para criar um pedido de redimensionamento num MIG zonal, use o comando instance-groups managed resize-requests create.

  gcloud compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \
      --resize-request=RESIZE_REQUEST_NAME \
      --resize-by=COUNT \
      --zone=ZONE
  

• Para criar um pedido de redimensionamento num MIG regional, use o comando beta instance-groups managed resize-requests create.

  gcloud beta compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \
      --resize-request=RESIZE_REQUEST_NAME \
      --resize-by=COUNT \
      --region=REGION
  

Substitua o seguinte:

• INSTANCE_GROUP_NAME: o nome do MIG configurado para criar pedidos de redimensionamento no mesmo.

• RESIZE_REQUEST_NAME: o nome do pedido de redimensionamento, que tem de ser exclusivo no MIG especificado. Caso contrário, a criação do pedido de redimensionamento falha.

• COUNT: o número de VMs a adicionar ao MIG de uma só vez.

• ZONE: a zona onde o MIG existe.

• REGION: a região onde o MIG existe.

Opcionalmente, pode fazer o seguinte:

• Se o modelo de instância do MIG especificar uma duração de execução, pode especificar uma duração de execução diferente. Para tal, inclua a flag --requested-run-duration no comando. Tem de especificar uma duração entre 10 minutos e sete dias.

• Se a sua carga de trabalho exigir nomes de VMs específicos, pode especificar uma lista de nomes de VMs a criar através do comando beta instance-groups managed resize-requests create. No comando, substitua a flag --resize-request pela flag --instances.

REST

• Para criar um pedido de redimensionamento num MIG zonal, envie um pedido POST através do método instanceGroupManagerResizeRequests.insert.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
  

• Para criar um pedido de redimensionamento num GIG regional, envie um pedido POST usando o método beta.regionInstanceGroupManagerResizeRequests.insert.

No corpo do pedido, inclua o seguinte:

{
  "name": "RESIZE_REQUEST_NAME",
  "resizeBy": COUNT
}

Substitua o seguinte:

• PROJECT_ID: o ID do projeto onde o MIG especificado existe.

• ZONE: a zona onde o MIG existe.

• REGION: a região onde o MIG existe.

• INSTANCE_GROUP_NAME: o nome do MIG configurado para criar pedidos de redimensionamento no mesmo.

• RESIZE_REQUEST_NAME: o nome do pedido de redimensionamento, que tem de ser exclusivo no MIG especificado. Caso contrário, a criação do pedido de redimensionamento falha.

• COUNT: o número de VMs a adicionar todas de uma vez ao MIG.

Opcionalmente, pode fazer o seguinte:

• Se o modelo de instância do MIG especificar uma duração de execução, pode especificar uma duração de execução diferente. Para tal, inclua o campo requestedRunDuration no corpo do pedido. Tem de especificar uma duração, em segundos, entre 10 minutos e sete dias.

• Se a sua carga de trabalho exigir nomes de VMs específicos, pode especificar uma lista de nomes de VMs a criar. Para o fazer, envie um pedido POST para o método beta.regionInstanceGroupManagerResizeRequests.insert para um GIG regional ou o método beta.instanceGroupManagerResizeRequests.insert para um GIG zonal. No corpo do pedido, substitua o campo resizeBy pelo campo instanceNames.