Configure as recomendações de tipo de máquina

Esta página descreve como ver e modificar a configuração das recomendações de tipo de máquina. Pode modificar os tipos de máquinas recomendados, para que as recomendações geradas incluam apenas a série de máquinas preferida. Também pode alterar as métricas usadas para gerar recomendações de memória para melhorar a precisão das recomendações. As alterações à configuração são aplicadas ao nível do projeto.

Para mais informações sobre as recomendações de tipo de máquina, consulte o artigo Aplique recomendações de tipo de máquina para VMs.

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:

    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.

Funções necessárias

Para receber as autorizações de que precisa para modificar as recomendações de tipo de máquina, peça ao seu administrador que lhe conceda a função IAM Administrador do Recommender do Compute (roles/recommender.computeAdmin) no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para modificar as recomendações de tipo de máquina. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para modificar as recomendações de tipo de máquina:

  • Veja a configuração da recomendação de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.get no projeto
  • Modifique a configuração de recomendações de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.update no projeto

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Configure as suas recomendações

Para configurar as recomendações de tipo de máquina, siga estes passos:

  1. Obtenha a configuração atual para receber o ficheiro JSON da configuração.
  2. Edite o ficheiro de configuração no formato JSON.
  3. Carregue o novo ficheiro de configuração para aplicar as alterações.

Obter a configuração atual

Pode obter a configuração atual das recomendações de tipo de máquina para o seu projeto através da CLI do Google Cloud.

gcloud

Para obter os parâmetros de configuração atuais, use o comando gcloud beta recommender recommender-config describe e use google.compute.instance.MachineTypeRecommender como o ID do recomendador:

gcloud beta recommender recommender-config describe google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE

Substitua o seguinte:

  • PROJECT_ID: o ID do seu projeto.
  • ZONE: a zona para a qual quer obter a configuração atual.

O comando devolve a configuração do recomendador, incluindo os subcampos modificáveis preferred_machine_types e memory_metrics.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_AND_CUSTOM",
      "memory_metrics": "MONITORING_AGENT_ONLY"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-08-20T04:41:15.330351Z"
}

Se quiser guardar a configuração num ficheiro local para a poder editar e carregar mais tarde, execute o seguinte comando:

gcloud beta recommender recommender-config describe \
  google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE > LOCAL_FILE_PATH_AND_NAME

Edite a configuração de recomendações

A configuração permite-lhe personalizar os seguintes parâmetros:

  • preferred_machine_types: as recomendações de tipos de máquinas que recebe.
  • memory_metrics: como as métricas de memória são usadas para gerar recomendações.

Opções para recomendações de tipos de máquinas

Pode especificar que recomendações de tipos de máquinas recebe alterando a definição preferred_machine_types para um dos seguintes valores:

  • DEFAULT: o valor predefinido é STANDARD_AND_CUSTOM.
  • STANDARD_AND_CUSTOM: recomenda a melhor correspondência dos tipos de máquinas padrão e personalizados.
  • STANDARD_ONLY: recomenda a melhor correspondência apenas a partir de tipos de máquinas padrão.

Opções para recomendações de memória

Para as métricas de memória usadas para gerar as recomendações, pode definir os seguintes valores:

  • MEMORY_METRICS_DEFAULT: use as métricas predefinidas para gerar recomendações.
  • MEMORY_METRICS_ALL: use todas as métricas disponíveis para gerar recomendações.
  • MONITORING_AGENT_ONLY: use apenas métricas recolhidas pelo agente de operações do Cloud Monitoring.
  • Se não usar o agente de operações e preferir não receber recomendações de memória, use o valor MEMORY_AGENT_ONLY para desativar as recomendações.

Para receber recomendações mais precisas sobre a utilização da memória, use o Ops Agent.

Atualize a configuração de um projeto

Para atualizar a configuração das recomendações de tipo de máquina, modifique os valores de configuração e carregue a nova configuração para o seu projeto. Pode alterar os tipos de máquinas preferenciais, as métricas de memória usadas para recomendações ou ambos os valores no mesmo pedido.

Depois de carregar a nova configuração, esta demora aproximadamente 48 horas a entrar em vigor. Até lá, as recomendações geradas usam a configuração anterior.

gcloud

Para atualizar os parâmetros de configuração, use o comando gcloud beta recommender recommender-config update e use google.compute.instance.MachineTypeRecommender como o ID do recomendador:

gcloud beta recommender recommender-config update google.compute.instance.MachineTypeRecommender\
  --project=PROJECT_ID \
  --location=ZONE \
  --config-file=LOCAL_FILE_PATH_AND_NAME \
  --etag=ETAG

Substitua o seguinte:

  • PROJECT_ID: o ID do seu projeto.
  • ZONE: a zona para a qual quer obter a configuração atual.
  • LOCAL_FILE_PATH_AND_NAME: o caminho para o ficheiro JSON com a configuração atual.
  • ETAG: o valor etag da configuração atual. Pode encontrar este valor no resultado do comando anterior.

No ficheiro de configuração, especifique apenas o objeto recommenderGenerationConfig com os parâmetros de configuração atualizados. Se guardou a configuração num ficheiro local, certifique-se de que copia o valor etag e, em seguida, remove todos os campos, exceto o valor recommenderGenerationConfig.

Por exemplo, para receber recomendações apenas com tipos de máquinas padrão, use o seguinte ficheiro de configuração:

{
  "params": {
    "preferred_machine_types": "STANDARD_ONLY"
  }
}

Se o comando for bem-sucedido, devolve um corpo da resposta semelhante ao seguinte, que mostra a nova configuração com os parâmetros que acabou de modificar.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_ONLY"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-08-20T05:00:05Z"
}

O que se segue?