Neste documento, descrevemos como criar solicitações de redimensionamento em um grupo gerenciado de instâncias (MIG) de máquina virtual (VM) com GPUs anexadas.
Antes de começar
- Saiba como funcionam as solicitações de redimensionamento.
- Para garantir que haja cota de GPU suficiente para os recursos solicitados, verifique sua cota de GPU.
-
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 Google Cloud.
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine da seguinte maneira.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Para criar um modelo de instância:
compute.instanceTemplates.create
no projeto -
Para criar um MIG zonal:
compute.instanceGroupManagers.create
no projeto -
Para criar solicitações de redimensionamento em um MIG:
compute.instanceGroupManagers.update
no projeto Interrompa as VMs durante eventos de manutenção do host.
Não use reservas.
No Console do Google Cloud, acesse a página Modelos de instância.
Clique em Criar modelo de instância.
No campo Nome, insira um nome para o modelo de instância.
Na seção Local, selecione uma das seguintes opções:
Para criar um modelo de instância global, selecione Global (padrão).
Para criar um modelo de instância regional, selecione Regional e escolha a região em que você quer criar o modelo de instância.
Na seção Configuração da máquina, faça o seguinte:
Clique na guia GPUs.
Na lista Tipo de GPU, selecione o tipo de GPU.
Na lista Número de GPUs, selecione o número de GPUs.
Opcional: se o modelo de GPU der suporte a estações de trabalho virtuais (vWS) NVIDIA RTX para cargas de trabalho de gráficos e você planeja executar cargas de trabalho com muitos gráficos, selecione Ativar estação de trabalho virtual (NVIDIA GRID).
Na lista Tipo de máquina, selecione um tipo de máquina.
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.
Expanda a seção Opções avançadas e depois faça o seguinte:
Expanda a seção Gerenciamento.
Na lista Reservas, selecione Não usar.
Clique em Criar.
A flag
--maintenance-policy
definida comoTERMINATE
.A flag
--reservation-affinity
definida comonone
.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 informações sobre os projetos de imagem com suporte, consulte Imagens públicas.IMAGE_FAMILY
ouIMAGE
- especifique uma das seguintes opções:IMAGE_FAMILY
: uma família de imagens. Especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificardebian-10
, a versão mais recente na família de imagens do Debian 10 será usada. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.IMAGE
: uma versão específica da imagem do SO, por exemplo,debian-10-buster-v20200309
. Se você decidir especificar uma versão específica da imagem do SO, será necessário substituir a flag--image-family
pela flag--image
.
MACHINE_TYPE
: um tipo de máquina que dá suporte a GPUs. Se você especificar um tipo de máquina N1, inclua a flag--accelerator
para especificar o número e o tipo de GPUs a serem anexadas às VMs.Defina o campo
scheduling.onHostMaintenance
comoTERMINATE
Defina o campo
reservationAffinity.consumeReservationType
comoNO_RESERVATION
.PROJECT_ID
: o ID do projeto em que 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 mais informações sobre os projetos de imagem com suporte, consulte Imagens públicas.IMAGE
ouIMAGE_FAMILY
- especifique uma das seguintes opções:IMAGE
: uma versão específica da imagem do SO, por exemplo,debian-10-buster-v20200309
.IMAGE_FAMILY
: uma família de imagens. Especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-10
, a versão mais recente na família de imagens do Debian 10 será usada. Para 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 dá suporte a GPUs. Se você especificar um tipo de máquina N1, inclua o campoguestAccelerators
no corpo da solicitação para especificar o número e o tipo de GPUs a serem anexadas às VMs.Defina o tipo de atualização do MIG como oportunista (padrão).
Se você tiver configurado o escalonamento automático no MIG, exclua a configuração de escalonamento automático.
No Console do Google Cloud, acesse a página Grupos de instâncias.
Clique em Criar grupo de instâncias.
A página Criar grupo de instâncias é aberta.
No campo Nome, insira um nome para o MIG.
Na lista Modelo de instância, selecione o modelo de instância que você criou 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.
Na seção Local, faça o seguinte:
Selecione Única zona (padrão).
Selecione a Região e a Zona do MIG.
Para excluir a configuração de escalonamento automático, faça o seguinte:
Na seção Escalonamento automático, clique na lista Modo de escalonamento automático e depois em Excluir configuração de escalonamento automático.
Na caixa de diálogo de confirmação, clique em Excluir.
Para desativar os reparos, na seção Ciclo de vida da instância de VM, clique na lista Ação padrão em caso de falha e selecione Nenhuma ação.
Escolha uma destas opções:
Para criar uma solicitação de redimensionamento nesse momento, faça o seguinte:
No campo Número de instâncias, insira o número de VMs que você quer criar de uma só vez.
Marque a caixa de seleção Usar solicitação de redimensionamento para criar VMs de uma só vez.
No campo Duração da execução solicitada e na lista Unidade, especifique a duração da execução das VMs. A duração precisa ser de 1 hora a 7 dias.
Caso contrário, no campo Número de instâncias, digite
0
. Mais tarde, será possível adicionar VMs ao grupo criando solicitações de redimensionamento.
Clique em Criar.
INSTANCE_GROUP_NAME
: o nome do MIG que será criado.INSTANCE_TEMPLATE_NAME
: o nome do modelo de instância que você criou na seção anterior.ZONE
: a zona em que o MIG será criado.PROJECT_ID
: o ID do projeto em que está o modelo de instância criado na seção anterior.ZONE
: a zona em que o MIG será criado.INSTANCE_TEMPLATE_NAME
: o nome do modelo de instância que você criou na seção anterior.INSTANCE_GROUP_NAME
: o nome do MIG que será criado.No Console do Google Cloud, acesse a página Grupos de instâncias.
Na coluna Nome, clique no nome do MIG em que você quer criar a solicitação de redimensionamento.
A página de visão geral do MIG será aberta.
Na linha Solicitações de redimensionamento, clique em
Editar solicitações de redimensionamento.Clique em
Nova solicitação de redimensionamento.O painel Novas solicitações de redimensionamento será exibido.
No campo Nome, digite o nome da solicitação de redimensionamento.
No campo Número de instâncias extras necessárias, insira o número de VMs a serem adicionadas ao MIG de uma só vez.
Nos campos Duração da execução solicitada e Unidade, especifique a duração das VMs solicitadas. A duração precisa ser entre 1 hora e 7 dias.
Clique em Criar.
INSTANCE_GROUP_NAME
: o nome de um MIG zonal atual configurado para a criação de solicitações de redimensionamento.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.COUNT
: o número de VMs a serem adicionadas ao MIG de uma só vez.RUN_DURATION
: a duração da execução das VMs solicitadas. O valor precisa ser formatado com o número de dias, horas, minutos ou segundos, seguido pord
,h
,m
es
, respectivamente. Por exemplo, especifique30m
para 30 minutos ou1d2h3m4s
para um dia, duas horas, três minutos e quatro segundos. O valor precisa estar entre 10 minutos e sete dias.ZONE
: a zona em que o MIG está localizado.PROJECT_ID
: o ID do projeto em que o MIG especificado está.ZONE
: a zona em que o MIG está localizado.INSTANCE_GROUP_NAME
: o nome de um MIG zonal atual configurado para a criação de solicitações de redimensionamento.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.COUNT
: o número de VMs a serem adicionadas de uma só vez ao MIG.RUN_DURATION
: a duração, em segundos, em que você quer que as VMs solicitadas sejam executadas. O valor precisa estar entre600
, que representa 600 segundos (10 minutos), e604800
, que é 604.800 segundos (sete dias).Saiba como visualizar, cancelar ou excluir solicitações de redimensionamento em um MIG.
Saiba como visualizar informações sobre MIGs e VMs gerenciadas.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Funções exigidas
Para receber as permissões necessárias a fim de criar solicitações de redimensionamento em um MIG, peça ao administrador para conceder a você o papel do IAm de Administrador da instância da computação (v1) (
roles/compute.instanceAdmin.v1
) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.Esse papel predefinido contém as permissões necessárias para criar solicitações de redimensionamento em um MIG. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para criar solicitações de redimensionamento em um MIG:
Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.
Preparar um MIG para solicitações de redimensionamento
Para criar solicitações de redimensionamento em um MIG, configure um modelo de instância e o MIG conforme descrito nas seções a seguir.
Criar um modelo de instância
Se você quiser criar solicitações de redimensionamento em um MIG, ele precisará usar um modelo de instância com as seguintes configurações:
Console
Para criar um modelo de instância configurado para a criação de solicitações de redimensionamento em um MIG, faça o seguinte:
gcloud
Para criar um modelo de instância configurado para a criação de solicitações de redimensionamento em um MIG, use o comando
instance-templates create
com as seguintes flags:Por exemplo, use o seguinte comando:
gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --image-project=IMAGE_PROJECT \ --image-family=IMAGE_FAMILY \ --machine-type=MACHINE_TYPE \ --maintenance-policy=TERMINATE \ --reservation-affinity=none
Substitua:
REST
Para criar um modelo de instância configurado para a criação de solicitações de redimensionamento em um MIG, faça uma solicitação
POST
ao métodoinstanceTemplates.insert
. No corpo da solicitação, faça o seguinte:Por exemplo, faça uma solicitação
POST
desta maneira:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "disks": [ { "boot": true, "mode": "READ_WRITE", "type": "PERSISTENT", "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "machineType": "MACHINE_TYPE", "networkInterfaces": [ { "accessConfigs": [ { "name": "external-IP", "type": "ONE_TO_ONE_NAT" } ], "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, "scheduling": { "onHostMaintenance": "TERMINATE" } } }
Substitua:
Para mais informações sobre como criar um modelo de instância, consulte Criar modelos de instância.
Criar ou atualizar um MIG
Depois de criar o modelo de instância conforme descrito na seção anterior, use esse modelo para atualizar um MIG ou criá-lo conforme a seguir. Além disso, faça o seguinte a fim de prepará-lo para as solicitações de redimensionamento:
Console
Se você quiser criar um MIG zonal configurado para a criação solicitações de redimensionamento, faça o seguinte:
gcloud
Se você quiser criar um MIG zonal configurado para a criação de solicitações de redimensionamento, use o comando
instance-groups managed create
com a flag--default-action-on-vm-failure
definida comodo_nothing
.gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template=INSTANCE_TEMPLATE_NAME \ --size=0 \ --zone=ZONE \ --default-action-on-vm-failure=do_nothing
Substitua:
REST
Se você quiser criar um MIG zonal configurado para a criação de solicitações de redimensionamento, faça uma solicitação
POST
para o métodoinstanceGroupManagers.insert
. No corpo da solicitação, inclua o campodefaultActionOnFailure
definido comoDO_NOTHING
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME" } ], "name": "INSTANCE_GROUP_NAME", "targetSize": 0, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
Substitua:
Criar uma solicitação de redimensionamento em um MIG
Antes de criar solicitações de redimensionamento, verifique se você preparou o MIG conforme descrito na seção anterior.
Depois que você cria uma solicitação de redimensionamento e todos os recursos solicitados ficam disponíveis, o MIG cria o número solicitado de VMs de uma só vez. As VMs são executadas até que o MIG as exclua após o término da duração de execução especificada ou até você excluí-las.
Console
Para criar uma solicitação de redimensionamento em um MIG, faça o seguinte:
gcloud
Para criar uma solicitação de redimensionamento em um MIG, 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 \ --zone=ZONE
Substitua:
REST
Para criar uma solicitação de redimensionamento em um MIG, faça uma solicitação
POST
ao métodobeta.instanceGroupManagerResizeRequests.insert
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests { "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT, "requestedRunDuration": { "seconds": "RUN_DURATION" } }
Substitua:
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-12 UTC.
-