Substituir, remover ou excluir políticas de carga de trabalho

Este documento explica como substituir, remover ou excluir políticas de carga de trabalho de grupos de instâncias gerenciadas (MIGs, na sigla em inglês). Essas ações são úteis nos seguintes cenários:

  • Substituir uma política de carga de trabalho: é possível mudar a localização das instâncias do Compute Engine no MIG ou mudar para uma política de carga de trabalho diferente que melhor se adapte aos requisitos da carga de trabalho.

  • Remover uma política de carga de trabalho: é possível parar de usar regras de posicionamento específicas se a carga de trabalho não precisar mais delas, revertendo o MIG para o comportamento de posicionamento de instâncias de computação padrão.

  • Excluir uma política de carga de trabalho: é possível excluir permanentemente as políticas de carga de trabalho que não são mais necessárias.

Para saber como criar uma política de carga de trabalho, consulte Criar políticas de carga de trabalho para MIGs.

Limitações

Só é possível substituir ou remover uma política de carga de trabalho de um MIG se não houver instâncias de computação no MIG.

Antes de começar

Funções exigidas

Para receber as permissões necessárias para substituir, remover ou excluir políticas de carga de trabalho, peça ao administrador para conceder a você o papel do IAM de Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para substituir, remover ou excluir políticas de carga de trabalho. Para acessar as permissões exatas que são necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para substituir, remover ou excluir políticas de carga de trabalho:

  • Para substituir ou remover uma política de carga de trabalho de um MIG: compute.instances.update on the project
  • Para excluir uma política de carga de trabalho: compute.resourcePolicies.delete on the project

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Substituir uma política de carga de trabalho em um MIG

Para substituir uma política de carga de trabalho em um MIG por uma política de carga de trabalho diferente, selecione uma das seguintes opções:

gcloud

  1. Defina manualmente o tamanho do MIG como 0.

  2. Para substituir a política de carga de trabalho no MIG, use o gcloud compute instance-groups managed update comando com a --workload-policy flag. Com base no tipo de MIG, inclua uma das seguintes flags:

    • Para substituir a política de carga de trabalho em um MIG zonal, inclua a flag --zone:

      gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --zone=ZONE

    • Para substituir a política de carga de trabalho em um MIG regional, inclua a flag --region:

      gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --region=REGION

    Substitua:

    • MIG_NAME: o nome do MIG;

    • WORKLOAD_POLICY: o nome da política de carga de trabalho que você quer aplicar ao MIG;

    • ZONE: a zona em que o MIG zonal existe;

    • REGION: a região em que o MIG regional e a política de carga de trabalho existem.

REST

  1. Defina manualmente o tamanho do MIG como 0.

  2. Para substituir a política de carga de trabalho no MIG, faça uma solicitação PATCH para um dos seguintes métodos:

    • Para substituir a política de carga de trabalho em um MIG zonal, faça uma PATCH solicitação para o compute.instanceGroupManagers.patch método:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": "projects/PROJECT_ID/regions/REGION/resourcePolicies/WORKLOAD_POLICY"
}

    • Para substituir a política de carga de trabalho em um MIG regional, faça uma PATCH solicitação para o compute.regionInstanceGroupManagers.patch método:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": "projects/PROJECT_ID/regions/REGION/resourcePolicies/WORKLOAD_POLICY"
}

    Substitua:

    • PROJECT_ID: o ID do projeto em que o MIG e a política de carga de trabalho existem;

    • ZONE: a zona em que o MIG zonal existe;

    • REGION: a região em que o MIG regional e a política de carga de trabalho existem;

    • MIG_NAME: o nome do MIG;

    • WORKLOAD_POLICY: o nome da política de carga de trabalho que você quer aplicar ao MIG.

Remover uma política de carga de trabalho de um MIG

Para remover uma política de carga de trabalho de um MIG, selecione uma das seguintes opções:

gcloud

  1. Defina manualmente o tamanho do MIG como 0.

  2. Para remover uma política de carga de trabalho de um MIG, use o gcloud compute instance-groups managed update comando com a --remove-workload-policy flag. Com base no tipo de MIG, inclua uma das seguintes flags:

    • Para remover uma política de carga de trabalho de um MIG zonal, inclua a flag --zone:

      gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --zone=ZONE

    • Para remover uma política de carga de trabalho de um MIG regional, inclua a flag --region:

      gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --region=REGION

    Substitua:

    • MIG_NAME: o nome do MIG;

    • WORKLOAD_POLICY: o nome da política de carga de trabalho aplicada ao MIG;

    • ZONE: a zona em que o MIG zonal existe;

    • REGION: a região em que o MIG regional existe.

REST

  1. Defina manualmente o tamanho do MIG como 0.

  2. Para remover uma política de carga de trabalho de um MIG, faça uma solicitação PATCH para um dos seguintes métodos:

    • Para remover uma política de carga de trabalho de um MIG zonal, faça uma solicitação para o compute.instanceGroupManagers.patch método:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}

    • Para remover uma política de carga de trabalho de um MIG regional, faça uma solicitação para o compute.regionInstanceGroupManagers.patch método:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}

    Substitua:

    • PROJECT_ID: o ID do projeto em que o MIG e a política de carga de trabalho existem;

    • ZONE: a zona em que o MIG zonal existe;

    • REGION: a região em que o MIG regional e a política de carga de trabalho existem;

    • MIG_NAME: o nome do MIG.

Excluir uma política de carga de trabalho

Não é possível excluir uma política de carga de trabalho aplicada a um MIG. Antes de excluir a política, é necessário removê-la do MIG.

Para excluir uma política de carga de trabalho, selecione uma das seguintes opções:

gcloud

Para excluir uma política de carga de trabalho, use o gcloud compute resource-policies delete comando:

gcloud compute resource-policies delete WORKLOAD_POLICY \
    --region=REGION

Substitua:

  • WORKLOAD_POLICY: o nome de uma política de carga de trabalho existente;

  • REGION: a região em que a política de carga de trabalho existe.

REST

Para excluir uma política de carga de trabalho, faça uma DELETE solicitação para o resourcePolicies.delete método:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

Substitua:

  • PROJECT_ID: o ID do projeto em que a política de carga de trabalho existe;

  • REGION: a região em que a política de carga de trabalho existe;

  • POLICY_NAME: o nome de uma política de carga de trabalho existente.

A seguir