Veja a flexibilidade da instância

Este documento descreve como ver a configuração da flexibilidade das instâncias num grupo de instâncias geridas (GIG) e os tipos de máquinas usados por cada VM no grupo.

Depois de adicionar ou fazer alterações à flexibilidade das instâncias num MIG, pode fazer o seguinte:

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se 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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Veja a configuração da flexibilidade da instância

Consola

  1. Na Google Cloud consola, aceda à página Grupos de instâncias.

    Aceda a Grupos de instâncias

  2. Na coluna Nome, clique no nome do MIG cuja configuração de flexibilidade da instância quer ver.

    É aberta a página de vista geral do MIG.

  3. Clique no separador Detalhes.

    Na secção Flexibilidade da instância, a tabela Seleções de instâncias mostra o nome da seleção de instâncias, a classificação e os tipos de máquinas numa seleção. Se o MIG não tiver a flexibilidade de instâncias configurada, a secção Flexibilidade de instâncias não é apresentada.

gcloud

Para ver a configuração da flexibilidade da instância, use o comando instance-groups managed describe. Inclua a flag --format para filtrar as propriedades instanceFlexibilityPolicy.instanceSelections.

  gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
      --region REGION \
      --format="json(instanceFlexibilityPolicy.instanceSelections)"

Segue-se um exemplo de saída:

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Se um MIG não tiver a flexibilidade de instâncias configurada, o resultado devolve null.

Substitua o seguinte:

  • INSTANCE_GROUP_NAME: o nome do MIG do qual quer ver a configuração de flexibilidade da instância.
  • REGION: a região onde o MIG está localizado.

REST

Para ver a configuração da flexibilidade da instância, use o método regionInstanceGroupManagers.get. Inclua o parâmetro fields no URL do pedido para filtrar as propriedades instanceFlexibilityPolicy.instanceSelections.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME?fields=instanceFlexibilityPolicy.instanceSelections

Segue-se um exemplo de saída:

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Se um MIG não tiver a flexibilidade de instâncias configurada, o resultado devolve null.

Substitua o seguinte:

  • PROJECT_ID: o seu ID do projeto.
  • REGION: a região onde o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG do qual quer ver a configuração de flexibilidade da instância.

Veja os tipos de máquinas usados por cada VM

Consola

  1. Na Google Cloud consola, aceda à página Grupos de instâncias.

    Aceda a Grupos de instâncias

  2. Na coluna Nome, clique no nome do MIG no qual quer ver os tipos de máquinas usados por cada VM.

    É aberta a página Vista geral do MIG, que apresenta todas as VMs no grupo, os respetivos tipos de máquinas e outros detalhes.

gcloud

Para ver os tipos de máquinas usados por cada VM num MIG, liste as VMs com o comando instance-groups managed list-instances e inclua a flag --format para filtrar o campo propertiesFromFlexibilityPolicy.machineType. Também pode filtrar outros campos conforme necessário.

  gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
      --region REGION \
      --format='(name,instanceStatus,currentAction,propertiesFromFlexibilityPolicy.machineType,lastAttempt.errors.errors)'

Segue-se um exemplo de saída:

NAME: example-mig-0md2
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

NAME: example-mig-vbgg
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

Substitua o seguinte:

  • REGION: a região onde o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG do qual quer ver a configuração de flexibilidade da instância.

REST

Para ver os tipos de máquinas usados por cada VM num MIG, liste as VMs através do método listManagedInstances e verifique o campo propertiesFromFlexibilityPolicy.machineType na resposta.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

Segue-se um exemplo de saída. Procure o campo propertiesFromFlexibilityPolicy no qual o campo machineType de uma VM está definido.

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-0md2",
      "instanceStatus": "RUNNING",
      "id": "2656095434923471959",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-0md2",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    },
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-vbgg",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "9171259522409694366",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-vbgg",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    }
  ]
}

Substitua o seguinte:

  • PROJECT_ID: o seu ID do projeto.
  • REGION: a região onde o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG do qual quer ver a configuração de flexibilidade da instância.

O que se segue?