Criar um MIG para cargas de trabalho de HPC com consumo vinculado à reserva

gcloud

Para criar um modelo de instância regional, use o comando gcloud compute instance-templates create.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --instance-template-region=REGION \
    --boot-disk-type=hyperdisk-balanced \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    
--network-interface=nic-type=GVNIC, \
      network=GVNIC_NAME_PREFIX-net-0, \
      subnet=GVNIC_NAME_PREFIX-sub-0, \
      stack-type=STACK_TYPE, \
      address=EXTERNAL_IPV4_ADDRESS \
--network-interface=nic-type=GVNIC, \
      network=GVNIC_NAME_PREFIX-net-1, \
      subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
--network-interface=nic-type=IRDMA, \
      network=RDMA_NAME_PREFIX-irdma, \
      subnet=RDMA_NAME_PREFIX-irdma-sub, \
      stack-type=IPV4_ONLY,no-address \
    --reservation-affinity=specific \
    --reservation=RESERVATION \
    --provisioning-model=RESERVATION_BOUND \
    --instance-termination-action=DELETE \
    --maintenance-policy=TERMINATE

Substitua:

• INSTANCE_TEMPLATE_NAME: o nome do modelo de instância.
• MACHINE_TYPE: o tipo de máquina H4D a ser usado para a instância.
• IMAGE_FAMILY: a família de imagens da imagem do SO que você quer usar. Para uma lista de sistemas operacionais compatíveis, consulte Sistemas operacionais compatíveis.
• IMAGE_PROJECT: o ID do projeto da imagem do SO.
• REGION: a região em que você quer criar o modelo de instância. Especifique uma região em que o tipo de máquina que você quer usar esteja disponível.
• DISK_SIZE: o tamanho do disco de inicialização em GiB.

• GVNIC_NAME_PREFIX: o prefixo de nome usado ao criar as redes e sub-redes VPC padrão para as interfaces gVNIC.

  Se você estiver usando a rede padrão, inclua apenas um campo --network-interface com o campo nic-type definido como GVNIC. Além disso, omita as configurações network e subnetwork para essa interface de rede.

• STACK_TYPE: opcional: o tipo de pilha a ser usado para a interface gVNIC. Especifique IPV4_ONLY ou IPV4_IPV6. Se você não especificar um valor, IPV4_ONLY será usado por padrão.

• EXTERNAL_IPV4_ADDRESS: opcional: um endereço IPv4 externo estático para usar com a interface de rede gVNIC. É preciso ter reservado um endereço IPv4 externo. Escolha uma destas opções:

  • Especifique um endereço IPv4 válido da sub-rede.
  • Use a flag no-address se não quiser que a interface de rede tenha um endereço IP externo.
  • Especifique address='' se quiser que a interface de rede receba um endereço IP externo temporário.

  Para especificar um endereço IPv6 externo para a interface de rede gVNIC, use a flag --external-ipv6-address.

• RDMA_NAME_PREFIX: o prefixo de nome usado ao criar a rede VPC e a sub-rede para a interface de rede IRDMA.

  Se você não estiver usando o Cloud RDMA com as instâncias H4D, omita o campo --network-interface para a interface IRDMA.

• RESERVATION: o nome da reserva que você quer usar.

  RESERVATION: o nome da reserva ou um bloco específico dentro de uma reserva. Para conferir o nome da reserva ou os blocos disponíveis, consulte Visualizar a capacidade reservada. Com base na sua exigência de posicionamento de instâncias, escolha uma das seguintes opções:

  • Para criar instâncias em vários blocos ou em um único bloco:

    projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME

    Além disso, para um único bloco, crie o MIG aplicando uma política de carga de trabalho que especifica uma colocação de bloco (maxTopologyDistance=BLOCK) . Em seguida, o Compute Engine aplica a política à reserva e cria instâncias no mesmo bloco.

  • Para criar instâncias em um bloco específico:

    projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME

REST

Para criar um modelo de instância regional, faça uma solicitação POST para o método regionInstanceTemplates.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates
{
  "name":"INSTANCE_TEMPLATE_NAME",
  "properties":{
    "disks":[
      {
        "boot":true,
        "initializeParams":{
          "diskSizeGb":"DISK_SIZE",
          "diskType":"hyperdisk-balanced",
          "sourceImage":"projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        },
        "mode":"READ_WRITE",
        "type":"PERSISTENT"
      }
    ],
    "machineType":"MACHINE_TYPE",
    
        "networkInterfaces": [
        {
          "network": "GVNIC_NAME_PREFIX-net-0",
          "subnetwork": "GVNIC_NAME_PREFIX-sub-0",
          "accessConfigs": [
            {
                "type": "ONE_TO_ONE_NAT",
                "name": "External IP",
                "natIP": "EXTERNAL_IPV4_ADDRESS"
            }
          ],
          "stackType": "IPV4_ONLY",
          "nicType": "GVNIC",
      },
      {
          "network": "GVNIC_NAME_PREFIX-net-1",
          "subnetwork": "GVNIC_NAME_PREFIX-sub-1",
          "stackType": "IPV4_ONLY",
          "nicType": "GVNIC",
      },
      {
          "network": "RDMA_NAME_PREFIX-irdma",
          "subnetwork": "RDMA_NAME_PREFIX-irdma-sub",
          "stackType": "IPV4_ONLY",
          "nicType": "IRDMA",
      }
    ],
,
    "reservationAffinity":{
        "consumeReservationType":"SPECIFIC_RESERVATION",
        "key":"compute.googleapis.com/reservation-name",
        "values":[
          "RESERVATION"
        ]
      },
    "scheduling":{
        "provisioningModel":"RESERVATION_BOUND",
        "instanceTerminationAction":"DELETE",
        "onHostMaintenance": "TERMINATE",
        "automaticRestart":true
      }
  }
}

Substitua:

• INSTANCE_TEMPLATE_NAME: o nome do modelo de instância.
• MACHINE_TYPE: o tipo de máquina a ser usado para a instância. Especifique um tipo de máquina H4D. Para mais informações, consulte Tipos de máquina H4D.
• IMAGE_FAMILY: a família de imagens da imagem do SO que você quer usar. Para uma lista de sistemas operacionais compatíveis, consulte Sistemas operacionais compatíveis.
• IMAGE_PROJECT: o ID do projeto da imagem do SO.
• REGION: a região em que você quer criar o modelo de instância. Especifique uma região em que o tipo de máquina que você quer usar esteja disponível. Para informações sobre regiões, consulte Regiões e zonas.
• DISK_SIZE: o tamanho do disco de inicialização em GiB.

• GVNIC_NAME_PREFIX: o prefixo de nome usado ao criar as redes e sub-redes VPC padrão para as interfaces gVNIC.

  Se você estiver usando a rede padrão, inclua apenas um campo --network-interface com o campo nic-type definido como GVNIC. Além disso, omita as configurações network e subnetwork para essa interface de rede.

• EXTERNAL_IPV4_ADDRESS: opcional: um endereço IPv4 externo estático para usar com a interface de rede gVNIC. É preciso ter reservado um endereço IPv4 externo.

  Para especificar um endereço IPv6 externo para a interface de rede gVNIC, use a flag --external-ipv6-address.

• RDMA_NAME_PREFIX: o prefixo de nome usado ao criar a rede VPC e a sub-rede para a interface de rede IRDMA.

  Se você não estiver usando o Cloud RDMA com as instâncias H4D, omita o campo --network-interface para a interface IRDMA.

• RESERVATION: o nome da reserva que você quer usar.

  RESERVATION: o nome da reserva ou um bloco específico dentro de uma reserva. Para conferir o nome da reserva ou os blocos disponíveis, consulte Visualizar a capacidade reservada. Com base na sua exigência de posicionamento de instâncias, escolha uma das seguintes opções:

  • Para criar instâncias em vários blocos ou em um único bloco:

    projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME

    Além disso, para um único bloco, crie o MIG aplicando uma política de carga de trabalho que especifica uma colocação de bloco (maxTopologyDistance=BLOCK) . Em seguida, o Compute Engine aplica a política à reserva e cria instâncias no mesmo bloco.

  • Para criar instâncias em um bloco específico:

    projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME

gcloud

Para criar um MIG com um tamanho de destino especificado, use o comando instance-groups managed create.

Nesta etapa, os comandos para criar um MIG usam uma política de carga de trabalho para especificar o posicionamento da VM. Se você não quiser usar uma política de carga de trabalho, remova a flag --workload-policy.

Crie um MIG zonal ou regional da seguinte maneira:

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

  gcloud compute instance-groups managed create MIG_NAME \
    --template=INSTANCE_TEMPLATE_URL \
    --size=TARGET_SIZE \
    --workload-policy=WORKLOAD_POLICY_URL \
    --zone=ZONE
  

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

  gcloud compute instance-groups managed create MIG_NAME \
      --template=INSTANCE_TEMPLATE_URL \
      --size=TARGET_SIZE \
      --workload-policy=WORKLOAD_POLICY_URL \
      --region=REGION
  

• MIG_NAME: o nome do MIG;
• INSTANCE_TEMPLATE_URL: o URL do modelo de instância que você quer usar para criar instâncias no MIG. 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
• TARGET_SIZE: o número de VMs que você quer no MIG.
• WORKLOAD_POLICY_URL: opcional: o URL da política de carga de trabalho. Se você não quiser usar uma política de carga de trabalho, remova a flag --workload-policy.
• ZONE: a zona em que você quer criar o MIG. Se você usar uma política de carga de trabalho, especifique uma zona na região da política.
• REGION: a região em que você quer criar a MIG. Se você usar uma política de carga de trabalho, especifique a mesma região da política. Para um MIG regional, em vez de uma região, você pode especificar as zonas nessa região usando a flag --zones.

REST

Para criar um MIG com um tamanho de destino especificado, faça uma solicitação POST da seguinte maneira.

Nesta etapa, as solicitações para criar um MIG usam uma política de carga de trabalho para especificar o posicionamento da VM. Se você não quiser usar uma política de carga de trabalho, remova o campo resourcePolicies.workloadPolicy do corpo da solicitação.

Crie um MIG zonal ou regional da seguinte maneira:

• 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
  {
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ],
    "name": "MIG_NAME",
    "instanceTemplate": "INSTANCE_TEMPLATE_URL",
    "targetSize": "TARGET_SIZE",
    "resourcePolicies": {
      "workloadPolicy": WORKLOAD_POLICY_URL
    }
  }
  

• 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
    {
      "versions": [
        {
          "instanceTemplate": "INSTANCE_TEMPLATE_URL"
        }
      ],
      "name": "MIG_NAME",
      "instanceTemplate": "INSTANCE_TEMPLATE_URL",
      "targetSize": "TARGET_SIZE",
      "resourcePolicies": {
        "workloadPolicy": WORKLOAD_POLICY_URL
      }
    }
  

• PROJECT_ID: o ID do projeto;
• ZONE: a zona em que você quer criar o MIG. Se você usar uma política de carga de trabalho, especifique uma zona na região da política.
• REGION: a região em que você quer criar um MIG. Se você usar uma política de carga de trabalho, especifique a mesma região da política.
• INSTANCE_TEMPLATE_URL: o URL do modelo de instância que você quer usar para criar instâncias no MIG. 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
• MIG_NAME: o nome do MIG;
• TARGET_SIZE: o número de VMs que você quer no MIG.
• WORKLOAD_POLICY_URL (opcional): o URL da política de carga de trabalho. Se você não quiser usar uma política de carga de trabalho, remova o campo resourcePolicies.workloadPolicy.

gcloud

Nesta etapa, os comandos para criar um MIG usam uma política de carga de trabalho para especificar o posicionamento da VM. Se você não quiser usar uma política de carga de trabalho, remova a flag --workload-policy.

Crie um MIG zonal ou regional e uma solicitação de redimensionamento da seguinte maneira:

• Para criar um MIG zonal e uma solicitação de redimensionamento nele, faça o seguinte:

  1. Crie um MIG zonal usando o comando instance-groups managed create da seguinte maneira.

     gcloud compute instance-groups managed create MIG_NAME \
         --template=INSTANCE_TEMPLATE_URL \
         --size=0 \
         --workload-policy=WORKLOAD_POLICY_URL \
         --zone=ZONE
     

  2. Crie uma solicitação de redimensionamento no MIG zonal usando o comando instance-groups managed resize-requests create da seguinte maneira:

     gcloud compute instance-groups managed resize-requests create MIG_NAME \
         --resize-request=RESIZE_REQUEST_NAME \
         POPULATION_METHOD \
         --zone=ZONE
     

• Para criar um MIG regional e uma solicitação de redimensionamento nele, faça o seguinte:

  1. Crie um MIG regional usando o comando instance-groups managed create da seguinte maneira.

     gcloud compute instance-groups managed create MIG_NAME \
         --template=INSTANCE_TEMPLATE_URL \
         --size=0 \
         --workload-policy=WORKLOAD_POLICY_URL \
         --zones=ZONE \
         --target-distribution-shape=any-single-zone \
         --instance-redistribution-type=none
       

  2. Crie uma solicitação de redimensionamento no MIG regional usando o comando Beta instance-groups managed resize-requests create da seguinte maneira:

     gcloud beta compute instance-groups managed resize-requests create MIG_NAME \
         --resize-request=RESIZE_REQUEST_NAME \
         POPULATION_METHOD \
         --region=REGION
     

Substitua:

• MIG_NAME: o nome do MIG;
• INSTANCE_TEMPLATE_URL: o URL do modelo de instância que você quer usar para criar instâncias no MIG. 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
• WORKLOAD_POLICY_URL (opcional): o URL da política de carga de trabalho. Se você não quiser usar uma política de carga de trabalho, remova a flag --workload-policy.
• ZONE: a zona em que você quer criar o MIG. Para um MIG regional, também é necessário especificar uma zona. Essa zona precisa ser a que contém o perfil da sua rede VPC e precisa ser uma zona em que o tipo de máquina está disponível. Saiba mais em Limitações.
• RESIZE_REQUEST_NAME: o nome da solicitação de redimensionamento, que precisa ser exclusivo no MIG especificado. Caso contrário, a criação da solicitação de redimensionamento falha.

• POPULATION_METHOD: o método de adicionar instâncias ao MIG. Use uma das seguintes opções:

  • --resize-by=COUNT: adicione o número especificado de instâncias ao MIG de uma só vez. Os nomes das instâncias são gerados automaticamente.
  • --instances=INSTANCE_NAME_LIST: adiciona de uma só vez ao MIG instâncias com os nomes especificados. Substitua INSTANCE_NAME_LIST por uma lista separada por vírgulas de nomes de instâncias. O número de nomes fornecidos determina o número de instâncias a serem criadas com essa solicitação de redimensionamento.
• REGION: a região em que o MIG está localizado.

Se você quiser aplicar uma política de carga de trabalho ao MIG, inclua a sinalização --workload-policy no comando.

REST

Nesta etapa, as solicitações para criar um MIG usam uma política de carga de trabalho para especificar o posicionamento da VM. Se você não quiser usar uma política de carga de trabalho, remova o campo resourcePolicies.workloadPolicy do corpo da solicitação.

Crie um MIG zonal ou regional e uma solicitação de redimensionamento da seguinte maneira:

• Para criar um MIG zonal e uma solicitação de redimensionamento nele, faça o seguinte:
  1. Crie um MIG zonal fazendo uma solicitação POST para 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": "MIG_NAME",
       "targetSize": 0,
       "resourcePolicies": {
         "workloadPolicy": WORKLOAD_POLICY_URL
       }
     }
     

  2. Crie uma solicitação de redimensionamento no MIG zonal fazendo uma solicitação POST para o método instanceGroupManagerResizeRequests.insert da seguinte maneira:

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resizeRequests
     {
       "name": "RESIZE_REQUEST_NAME",
       POPULATION_METHOD
     }
     

• Para criar um MIG regional e uma solicitação de redimensionamento nele, faça o seguinte:
  1. Crie um MIG regional fazendo uma solicitação POST para o método regionInstanceGroupManagers.insert da seguinte maneira.

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers
     {
       "versions": [
         {
           "instanceTemplate": "INSTANCE_TEMPLATE_URL"
         }
       ],
       "name": "MIG_NAME",
       "targetSize": 0,
       "distributionPolicy": {
         "targetShape": "ANY_SINGLE_ZONE",
         "zones": [
           {
             "zone": "projects/PROJECT_ID/zones/ZONE"
           }
         ]
       },
       "updatePolicy": {
         "instanceRedistributionType": "NONE"
       },
       "resourcePolicies": {
         "workloadPolicy": WORKLOAD_POLICY_URL
       }
     }
     

  2. Crie uma solicitação de redimensionamento no MIG regional fazendo uma solicitação POST para o método beta.regionInstanceGroupManagerResizeRequests.insert da seguinte maneira:

     POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME/resizeRequests
     {
       "name": "RESIZE_REQUEST_NAME",
       POPULATION_METHOD
     }
     

Substitua:

• PROJECT_ID: o ID do projeto;
• ZONE: a zona em que você quer criar o MIG. Para um MIG regional, também é necessário especificar uma zona. Essa zona precisa ser a que contém o perfil da sua rede VPC e precisa ser uma zona em que o tipo de máquina está disponível. Saiba mais em Limitações.
• REGION: a região em que você quer criar o MIG.
• INSTANCE_TEMPLATE_URL: o URL do modelo de instância que você quer usar para criar instâncias no MIG. 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
• MIG_NAME: o nome do MIG;
• WORKLOAD_POLICY_URL: opcional: o URL da política de carga de trabalho. Se você não quiser usar uma política de carga de trabalho, remova o campo resourcePolicies.workloadPolicy.
• RESIZE_REQUEST_NAME: o nome da solicitação de redimensionamento, que precisa ser exclusivo no MIG especificado. Caso contrário, a criação da solicitação de redimensionamento falha.

• POPULATION_METHOD: o método de adicionar instâncias ao MIG. Use uma das seguintes opções:

  • "resizeBy":COUNT: substitua COUNT pelo número especificado de instâncias a serem adicionadas ao MIG de uma só vez. Os nomes das instâncias são gerados automaticamente.
  • "instanceNames":INSTANCE_NAME_LIST: adiciona de uma só vez ao MIG instâncias com os nomes especificados. Substitua INSTANCE_NAME_LIST por uma lista separada por vírgulas de nomes de instâncias. O número de nomes fornecidos determina a quantidade de instâncias a serem criadas com essa solicitação de redimensionamento.

Se você quiser aplicar uma política de carga de trabalho ao MIG, inclua o resourcePolicies.workloadPolicy campo no corpo da solicitação.