Crie solicitações de redimensionamento em um MIG

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

Console

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

   Vá para modelos de instância

2. Clique em Criar modelo de instância .

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

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

   • Para criar um modelo de instância global, selecione Global , se ainda não estiver selecionado.

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

5. Na seção Configuração da máquina , faça o seguinte:

   1. Clique na guia GPUs .

   2. Na lista de tipos de GPU , selecione o tipo de GPU.

   3. Na lista Número de GPUs , selecione o número de GPUs.

   4. Opcional: se o seu modelo de GPU suportar estações de trabalho virtuais NVIDIA RTX (vWS) para cargas de trabalho gráficas e você planeja executar cargas de trabalho com uso intensivo de gráficos, selecione Habilitar estação de trabalho virtual (NVIDIA GRID) .

   5. Na seção Tipo de máquina , selecione um tipo de máquina.

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

7. Expanda a seção Opções avançadas e faça o seguinte:

   1. Expanda a seção Gerenciamento .

   2. Na lista Reservas , selecione Não usar .

8. Clique em Criar .

gcloud

Para criar um modelo de instância configurado para criar solicitações de redimensionamento em um MIG, use o comando instance-templates create com os seguintes sinalizadores:

• O sinalizador --maintenance-policy definido como TERMINATE .

• O sinalizador --reservation-affinity definido como none .

Por exemplo, use o comando a seguir para criar um modelo de instância regional. Se você deseja criar um modelo de instância global, use o mesmo comando sem o sinalizador --instance-template-region .

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --reservation-affinity=none

Substitua o seguinte:

• 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 obter mais informações sobre os projetos de imagem suportados, consulte Imagens públicas .

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

  Se você quiser usar uma versão específica da imagem do sistema operacional, como debian-12-buster-v20240701 , substitua o sinalizador --image-family pelo sinalizador --image .

• REGION : a região na qual o modelo de instância será criado.

• MACHINE_TYPE : um tipo de máquina que suporta GPUs . Se você especificar um tipo de máquina N1, inclua o sinalizador --accelerator para especificar o número e o tipo de GPUs a serem anexadas às suas VMs.

DESCANSAR

Para criar um modelo de instância configurado para criar solicitações de redimensionamento em um MIG, faça uma solicitação POST para 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 da solicitação, faça o seguinte:

• Inclua o campo scheduling.onHostMaintenance e defina-o como TERMINATE .

• Inclua o campo reservationAffinity.consumeReservationType e configure-o como NO_RESERVATION .

Por exemplo, para criar um modelo de instância regional, faça uma solicitação POST 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": {
      "onHostMaintenance": "TERMINATE"
    }
  }
}

Substitua o seguinte:

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

• REGION : a região na qual o modelo de instância será criado.

• 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 obter mais informações sobre os projetos de imagem suportados, consulte Imagens públicas .

• IMAGE : especifique um dos seguintes:

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

  • Uma família de imagens , que deve ser formatada como family/ IMAGE_FAMILY . Isso especifica a imagem do sistema operacional mais recente e não obsoleta. Por exemplo, se você especificar family/debian-12 , a versão mais recente da família de imagens Debian 12 será usada. Para obter mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens .

• MACHINE_TYPE : um tipo de máquina que suporta GPUs . Se você especificar um tipo de máquina N1, inclua o campo guestAccelerators no corpo da solicitação para especificar o número e o tipo de GPUs a serem anexadas às suas VMs.

Console

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

   Vá para grupos 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 criado na seção anterior. Se você selecionar um modelo de instância regional, a lista Região será definida como a região do modelo de instância.

5. Na seção Localização , especifique se deseja criar um MIG zonal ou regional da seguinte forma:

   1. Para criar um MIG zonal, selecione Zona única . Ou, para criar um MIG regional, selecione Zonas múltiplas .

   2. Selecione a região e zonas do MIG.

   3. Se você estiver criando um MIG regional, faça o seguinte:

      1. No campo Formato de distribuição de destino , selecione Qualquer zona única . Você poderá selecionar essa opção somente depois de excluir a configuração de escalonamento automático nas etapas seguintes.

      2. Depois de selecionar a opção qualquer zona única, na caixa de diálogo exibida, clique em Desativar redistribuição de instância .

6. Exclua a configuração de escalonamento automático da seguinte maneira:

   1. Na seção Escalonamento automático , clique na lista Modo de escalonamento automático e clique em Excluir configuração de escalonamento automático .

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

7. Desligue os reparos da seguinte forma:

   1. Na seção Ciclo de vida da instância de VM , clique na lista Ação padrão em caso de falha .

   2. Selecione Nenhuma ação .

8. Faça um dos seguintes:

   • Para criar uma solicitação de redimensionamento neste momento, faça o seguinte:

     1. No campo Número de instâncias , insira o número de VMs que você deseja criar de uma só vez.

        

     2. Marque a caixa de seleção Usar solicitação de redimensionamento para criar VMs de uma só vez .

     3. No campo Duração da execução solicitada e na lista Unidade , especifique a duração da execução das VMs. A duração deve ser entre 1 hora e 7 dias.

   • Caso contrário, no campo Número de instâncias , insira 0 . Posteriormente, você poderá adicionar VMs ao grupo criando solicitações de redimensionamento .

9. Clique em Criar .

gcloud

Use o comando instance-groups managed create com o sinalizador --default-action-on-vm-failure definido como do_nothing . Se você estiver criando um MIG regional, também deverá incluir o sinalizador --target-distribution-shape definido como any-single-zone e o sinalizador --instance-redistribution-type definido como none .

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

  gcloud compute instance-groups managed create INSTANCE_GROUP_URL \
    --template=INSTANCE_TEMPLATE_NAME \
    --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 ser criado.

• INSTANCE_TEMPLATE_URL : o URL parcial do modelo de instância que você criou na seção anterior. Se quiser usar um modelo de instância regional para criar o MIG, você só poderá criar o MIG dentro da 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 será criado o MIG.

DESCANSAR

• Para criar um MIG zonal, envie uma solicitação POST usando o método instanceGroupManagers.insert da seguinte maneira:

  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 uma solicitação POST usando o 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 está localizado o modelo de instância que você criou na seção anterior.

• INSTANCE_TEMPLATE_URL : o URL parcial do modelo de instância que você criou na seção anterior. Se quiser usar um modelo de instância regional para criar o MIG, você só poderá criar o MIG dentro da 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 será criado o MIG.

• INSTANCE_GROUP_NAME : o nome do MIG a ser criado.

Console

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

   Vá para grupos de instâncias

2. Na coluna Nome , clique no nome do MIG no qual deseja criar a solicitação de redimensionamento.

   A página de visão geral do MIG é aberta.

3. Na linha Solicitações de redimensionamento , clique em edit Editar solicitações de redimensionamento .

4. Clique em add nova solicitação de redimensionamento .

   O painel Novas solicitações de redimensionamento é exibido.

5. No campo Nome , insira o nome da solicitação de redimensionamento.

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

7. Nos campos Duração da execução solicitada e Unidade , especifique a duração que você deseja que as VMs solicitadas sejam executadas. A duração deve ser entre 1 hora e 7 dias.

8. Clique em Criar .

gcloud

• Para criar uma solicitação de redimensionamento em um 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 \
      --requested-run-duration=RUN_DURATION \
      --zone=ZONE
  

• Para criar uma solicitação de redimensionamento em um 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 \
      --requested-run-duration=RUN_DURATION \
      --region=REGION
  

Substitua o seguinte:

• INSTANCE_GROUP_NAME : o nome do MIG configurado para criar solicitações de redimensionamento nele.

• RESIZE_REQUEST_NAME : o nome da solicitação de redimensionamento, que deve ser exclusivo dentro do MIG especificado. Caso contrário, a criação da solicitação de redimensionamento falhará.

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

• RUN_DURATION : a duração que você deseja que as VMs solicitadas sejam executadas. O valor deve ser formatado como o número de dias, horas, minutos ou segundos seguido por d , h , m e s respectivamente. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos. O valor deve estar entre 10 minutos e 7 dias.

• ZONE : a zona onde o MIG está localizado.

• REGION : região onde o MIG está localizado.

DESCANSAR

• Para criar uma solicitação de redimensionamento em um MIG zonal, envie uma solicitação POST usando o método instanceGroupManagerResizeRequests.insert .

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

• Para criar uma solicitação de redimensionamento em um MIG regional, envie uma solicitação POST usando o método beta.regionInstanceGroupManagerResizeRequests.insert .

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
  

No corpo da solicitação, inclua o seguinte:

{
  "name": "RESIZE_REQUEST_NAME",
  "resizeBy": COUNT,
  "requestedRunDuration": {
    "seconds": "RUN_DURATION"
  }
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto onde o MIG especificado está localizado.

• ZONE : a zona onde o MIG está localizado.

• REGION : região onde o MIG está localizado.

• INSTANCE_GROUP_NAME : o nome do MIG configurado para criar solicitações de redimensionamento nele.

• RESIZE_REQUEST_NAME : o nome da solicitação de redimensionamento, que deve ser exclusivo dentro do MIG especificado. Caso contrário, a criação da solicitação de redimensionamento falhará.

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

• RUN_DURATION : a duração, em segundos, que você deseja que as VMs solicitadas sejam executadas. O valor deve estar entre 600 , que é 600 segundos (10 minutos), e 604800 , que é 604.800 segundos (7 dias).