Limitar o tempo de execução de VMs em um MIG,Limitar o tempo de execução de VMs em um MIG

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

Este documento descreve como encerrar automaticamente máquinas virtuais (VMs) em um grupo de instâncias gerenciadas (MIG) especificando um limite de tempo para as VMs. Ele também descreve como funciona o limite de tempo para VMs em um MIG.

Você pode otimizar cargas de trabalho temporárias especificando um limite de tempo para as VMs em um MIG. Quando uma VM atinge seu limite de tempo, o MIG encerra (exclui) automaticamente essa VM. Limitar o tempo de execução das VMs em um MIG por um limite de tempo ajuda a minimizar custos e liberar cota.

Para saber como especificar um limite de tempo para uma VM autônoma, consulte Limitar o tempo de execução de uma VM . Se você deseja que um MIG adicione ou exclua VMs automaticamente com base em suas cargas de trabalho, consulte Dimensionamento automático de grupos de instâncias .

Antes de começar

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

  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

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Limite o tempo de execução de VMs em um MIG

Você pode limitar o tempo de execução de VMs em um MIG especificando um limite de tempo no modelo de instância usado para o MIG. Quando o MIG cria VMs com base no modelo, o limite de tempo é aplicado a cada VM.

Você pode especificar um dos dois tipos de limites de tempo:

• Limite de tempo como duração da execução
• Prazo como prazo de rescisão

Para especificar um limite de tempo para as VMs em um MIG, siga estas etapas:

1. Crie um modelo de instância com duração de execução para VMs ou com tempo de encerramento para VMs .

2. Use o modelo de instância para criar um MIG ou atualizar um MIG existente .

Limitações

• Você deve cumprir as restrições para limitar o tempo de execução de VMs autônomas .

• Ao criar um modelo de instância para especificar um limite de tempo para VMs em um MIG, as seguintes limitações se aplicam:

  • Você não pode definir a ação de encerramento como STOP . MIGs suportam apenas DELETE .
  • Você não pode usar VMs spot.

• Não é possível criar uma solicitação de redimensionamento em um MIG que use um modelo de instância que limite o tempo de execução da VM.

• Você não pode limitar o tempo de execução de VMs em um MIG regional com o formato de distribuição de destino EVEN e a redistribuição proativa de instâncias habilitadas.

Crie um modelo de instância com duração de execução para VMs

Para encerrar automaticamente VMs em um MIG após sua execução por um determinado período, defina uma duração máxima de execução ( maxRunDuration ) no modelo de instância.

  gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
      --max-run-duration=DURATION \
      --instance-termination-action=DELETE

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default",
        "accessConfigs": [
          {
            "name": "external-IP",
            "type": "ONE_TO_ONE_NAT"
          }
        ]
      }
    ],
    "disks": [
      {
        "type": "PERSISTENT",
        "boot": true,
        "mode": "READ_WRITE",
        "initializeParams":
        {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ]
    "scheduling": {
      "maxRunDuration":
      {
        "seconds": DURATION
      },
      "instanceTerminationAction": "DELETE"
    }
  }
}

Crie um modelo de instância com um horário de encerramento para VMs

Para encerrar automaticamente as VMs em um MIG em um horário específico, defina um horário de encerramento ( terminationTime ) no modelo de instância. Você pode definir uma data e hora em que deseja que um MIG encerre as VMs.

  gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
      --termination-time=TIME \
      --instance-termination-action=DELETE

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default",
        "accessConfigs": [
          {
            "name": "external-IP",
            "type": "ONE_TO_ONE_NAT"
          }
        ]
      }
    ],
    "disks": [
      {
        "type": "PERSISTENT",
        "boot": true,
        "mode": "READ_WRITE",
        "initializeParams":
        {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ]
    "scheduling": {
      "terminationTime": TIME,
      "instanceTerminationAction": "DELETE"
    }
  }
}

Como funciona o limite de tempo para VMs em um MIG

Quando você especifica um limite de tempo para VMs em um MIG, o horário em que um MIG encerrará uma VM é automaticamente definido no campo carimbo de data/hora de término ( terminationTimestamp ) da VM.

Com base no tipo de limite de tempo especificado, o carimbo de data/hora de encerramento de uma VM é definido da seguinte forma:

• Limite de tempo como duração da execução ( maxRunDuration ):

  terminationTimestamp de uma VM = última criação ou hora de início da VM + maxRunDuration

  Quando você especifica uma duração, o carimbo de data/hora de término é definido em relação à última criação ou hora de início da VM. Se a VM for recriada, reiniciada, retomada ou substituída, o carimbo de data/hora de encerramento será recalculado. O carimbo de data/hora de encerramento pode variar entre as VMs em um MIG com base na hora em que cada VM foi criada ou iniciada pela última vez. Por exemplo, se uma VM for reparada, o carimbo de data/hora de término da VM será recalculado adicionando a duração ao tempo em que a VM foi recriada durante o reparo.

• Limite de tempo como tempo de rescisão ( terminationTime ):

  terminationTimestamp de uma VM = terminationTime

  Quando você especifica um horário, o carimbo de data/hora de término é definido para esse horário, desde que o horário seja no futuro. Se o tempo de encerramento tiver passado, qualquer ação MIG que tente criar, reiniciar ou substituir uma VM falhará com um erro . Para resolver esse erro, você deve criar um novo modelo de instância com um horário de encerramento no futuro e aplicar esse modelo ao MIG. Se desejar usar as propriedades do modelo existente no novo modelo, crie um modelo de instância com base no modelo existente .

Durante uma atualização de VM, o carimbo de data/hora de encerramento não muda. Por exemplo, se você definir o nível de interrupção para atualizações como REFRESH , o carimbo de data/hora de encerramento será retido sempre que o MIG atualizar a VM.

Quando você suspende ou interrompe uma VM em um MIG, o carimbo de data/hora de encerramento é automaticamente apagado, independentemente do tipo de limite de tempo. Quando você retoma ou inicia uma VM, o carimbo de data/hora de encerramento é definido novamente com base no tipo de limite de tempo, conforme explicado anteriormente nesta seção.

Como funciona o escalonamento automático quando um limite de tempo é definido

O escalonamento automático permite que seu MIG adicione ou remova VMs automaticamente com base em aumentos ou diminuições na carga. Quando um MIG exclui VMs que atingiram seus carimbos de data/hora de término, o MIG cria novas VMs para manter o tamanho recomendado pelo escalonador automático. As novas VMs são executadas pelo limite de tempo especificado. Se a recomendação do escalonador automático for reduzir o número de VMs, o MIG excluirá as VMs antes mesmo que elas atinjam seus limites de tempo.

Se você tiver configurado agendamentos de escalabilidade , as VMs serão executadas somente até o final de um agendamento ou até que uma VM atinja seu carimbo de data/hora de término, o que ocorrer primeiro.

O que vem a seguir

• Aprenda sobre os cenários básicos para criação de MIGs .
• Saiba mais sobre como aplicar um novo modelo de instância a um MIG existente .

Este documento descreve como encerrar automaticamente máquinas virtuais (VMs) em um grupo de instâncias gerenciadas (MIG) especificando um limite de tempo para as VMs. Ele também descreve como funciona o limite de tempo para VMs em um MIG.

Você pode otimizar cargas de trabalho temporárias especificando um limite de tempo para as VMs em um MIG. Quando uma VM atinge seu limite de tempo, o MIG encerra (exclui) automaticamente essa VM. Limitar o tempo de execução das VMs em um MIG por um limite de tempo ajuda a minimizar custos e liberar cota.

Para saber como especificar um limite de tempo para uma VM autônoma, consulte Limitar o tempo de execução de uma VM . Se você deseja que um MIG adicione ou exclua VMs automaticamente com base em suas cargas de trabalho, consulte Dimensionamento automático de grupos de instâncias .

Antes de começar

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

  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

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Limite o tempo de execução de VMs em um MIG

Você pode limitar o tempo de execução de VMs em um MIG especificando um limite de tempo no modelo de instância usado para o MIG. Quando o MIG cria VMs com base no modelo, o limite de tempo é aplicado a cada VM.

Você pode especificar um dos dois tipos de limites de tempo:

• Limite de tempo como duração da execução
• Prazo como prazo de rescisão

Para especificar um limite de tempo para as VMs em um MIG, siga estas etapas:

1. Crie um modelo de instância com duração de execução para VMs ou com tempo de encerramento para VMs .

2. Use o modelo de instância para criar um MIG ou atualizar um MIG existente .

Limitações

• Você deve cumprir as restrições para limitar o tempo de execução de VMs autônomas .

• Ao criar um modelo de instância para especificar um limite de tempo para VMs em um MIG, as seguintes limitações se aplicam:

  • Você não pode definir a ação de encerramento como STOP . MIGs suportam apenas DELETE .
  • Você não pode usar VMs spot.

• Não é possível criar uma solicitação de redimensionamento em um MIG que use um modelo de instância que limite o tempo de execução da VM.

• Você não pode limitar o tempo de execução de VMs em um MIG regional com formato de distribuição de destino EVEN e redistribuição proativa de instâncias habilitados.

Crie um modelo de instância com duração de execução para VMs

Para encerrar automaticamente VMs em um MIG após sua execução por um determinado período, defina uma duração máxima de execução ( maxRunDuration ) no modelo de instância.

  gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
      --max-run-duration=DURATION \
      --instance-termination-action=DELETE

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default",
        "accessConfigs": [
          {
            "name": "external-IP",
            "type": "ONE_TO_ONE_NAT"
          }
        ]
      }
    ],
    "disks": [
      {
        "type": "PERSISTENT",
        "boot": true,
        "mode": "READ_WRITE",
        "initializeParams":
        {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ]
    "scheduling": {
      "maxRunDuration":
      {
        "seconds": DURATION
      },
      "instanceTerminationAction": "DELETE"
    }
  }
}

Crie um modelo de instância com um horário de encerramento para VMs

Para encerrar automaticamente as VMs em um MIG em um horário específico, defina um horário de encerramento ( terminationTime ) no modelo de instância. Você pode definir uma data e hora em que deseja que um MIG encerre as VMs.

  gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
      --termination-time=TIME \
      --instance-termination-action=DELETE

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default",
        "accessConfigs": [
          {
            "name": "external-IP",
            "type": "ONE_TO_ONE_NAT"
          }
        ]
      }
    ],
    "disks": [
      {
        "type": "PERSISTENT",
        "boot": true,
        "mode": "READ_WRITE",
        "initializeParams":
        {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ]
    "scheduling": {
      "terminationTime": TIME,
      "instanceTerminationAction": "DELETE"
    }
  }
}

Como funciona o limite de tempo para VMs em um MIG

Quando você especifica um limite de tempo para VMs em um MIG, o horário em que um MIG encerrará uma VM é automaticamente definido no campo carimbo de data/hora de término ( terminationTimestamp ) da VM.

Com base no tipo de limite de tempo especificado, o carimbo de data/hora de encerramento de uma VM é definido da seguinte maneira:

• Limite de tempo como duração da execução ( maxRunDuration ):

  terminationTimestamp de uma VM = última criação ou hora de início da VM + maxRunDuration

  Quando você especifica uma duração, o carimbo de data/hora de término é definido em relação à última criação ou hora de início da VM. Se a VM for recriada, reiniciada, retomada ou substituída, o carimbo de data/hora de encerramento será recalculado. O carimbo de data/hora de encerramento pode variar entre as VMs em um MIG com base na hora em que cada VM foi criada ou iniciada pela última vez. Por exemplo, se uma VM for reparada, o carimbo de data/hora de término da VM será recalculado adicionando a duração ao tempo em que a VM foi recriada durante o reparo.

• Limite de tempo como tempo de rescisão ( terminationTime ):

  terminationTimestamp de uma VM = terminationTime

  Quando você especifica um horário, o carimbo de data/hora de término é definido para esse horário, desde que o horário seja no futuro. Se o tempo de encerramento tiver passado, qualquer ação MIG que tente criar, reiniciar ou substituir uma VM falhará com um erro . Para resolver esse erro, você deve criar um novo modelo de instância com um horário de encerramento no futuro e aplicar esse modelo ao MIG. Se desejar usar as propriedades do modelo existente no novo modelo, crie um modelo de instância com base no modelo existente .

Durante uma atualização de VM, o carimbo de data/hora de encerramento não muda. Por exemplo, se você definir o nível de interrupção para atualizações como REFRESH , o carimbo de data/hora de encerramento será retido sempre que o MIG atualizar a VM.

Quando você suspende ou interrompe uma VM em um MIG, o carimbo de data/hora de encerramento é automaticamente apagado, independentemente do tipo de limite de tempo. Quando você retoma ou inicia uma VM, o carimbo de data/hora de encerramento é definido novamente com base no tipo de limite de tempo, conforme explicado anteriormente nesta seção.

Como funciona o escalonamento automático quando um limite de tempo é definido

O escalonamento automático permite que seu MIG adicione ou remova VMs automaticamente com base em aumentos ou diminuições na carga. Quando um MIG exclui VMs que atingiram seus carimbos de data/hora de término, o MIG cria novas VMs para manter o tamanho recomendado pelo escalonador automático. As novas VMs são executadas pelo limite de tempo especificado. Se a recomendação do escalonador automático for reduzir o número de VMs, o MIG excluirá as VMs antes mesmo que elas atinjam seus limites de tempo.

Se você tiver configurado agendamentos de escalabilidade , as VMs serão executadas somente até o final de um agendamento ou até que uma VM atinja seu carimbo de data/hora de término, o que ocorrer primeiro.

O que vem a seguir

• Aprenda sobre os cenários básicos para criação de MIGs .
• Saiba mais sobre como aplicar um novo modelo de instância a um MIG existente .