Configura i suggerimenti sui tipi di macchina


Questa pagina descrive come visualizzare e modificare la configurazione dei suggerimenti sui tipi di macchina. Puoi modificare i tipi di macchine suggeriti in modo che i suggerimenti generati includano solo la serie di macchine che ti interessa. Per migliorare il livello di accuratezza dei suggerimenti, puoi inoltre modificare le metriche utilizzate per generare suggerimenti sulla memoria. Le modifiche alla configurazione vengono applicate a livello di progetto.

Per saperne di più sui suggerimenti sui tipi di macchina, consulta Applica i suggerimenti sul tipo di macchina per le istanze VM.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
    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.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare i suggerimenti sui tipi di macchina, chiedi all'amministratore di concederti il ruolo IAM Compute Recommender Admin (roles/recommender.computeAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito dispone delle autorizzazioni necessarie per modificare i suggerimenti sui tipi di macchina. Per visualizzare le autorizzazioni obbligatorie corrette, espandi l'omonima sezione:

Autorizzazioni obbligatorie

Per modificare i suggerimenti sui tipi di macchina sono necessarie le seguenti autorizzazioni:

  • Visualizza la configurazione del suggerimento sul tipo di macchina: recommender.computeInstanceMachineTypeRecommenderConfig.get nel progetto
  • Modifica la configurazione del suggerimento sul tipo di macchina: recommender.computeInstanceMachineTypeRecommenderConfig.update nel progetto

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Configura i suggerimenti

Per configurare i suggerimenti sui tipi di macchina, esegui i seguenti passaggi:

  1. Ottieni la configurazione attuale per acquisire il relativo file JSON.
  2. Modifica il file di configurazione in formato JSON.
  3. Per applicare le modifiche, carica il nuovo file di configurazione.

Ottieni la configurazione attuale

Utilizzando Google Cloud CLI, puoi ottenere la configurazione attuale dei suggerimenti sui tipi di macchina per il tuo progetto.

gcloud

Per ottenere i parametri della configurazione attuale, utilizza i comandi gcloud beta recommender recommender-config describe e google.compute.instance.MachineTypeRecommender come ID del motore per suggerimenti:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • ZONE: la zona per la quale vuoi ottenere la configurazione attuale

Il comando restituisce la configurazione del motore per suggerimenti, inclusi i campi secondari modificabili 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 vuoi salvare la configurazione in un file locale per poterla modificare e caricare in un secondo momento, esegui il seguente comando:

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

Modifica la configurazione dei suggerimenti

La configurazione ti consente di personalizzare i seguenti parametri:

  • preferred_machine_types: i suggerimenti che ricevi sui tipi di macchina
  • memory_metrics: il modo attraverso cui vengono utilizzate le metriche di memoria per generare suggerimenti

Opzioni per i suggerimenti sui tipi di macchina

Puoi specificare i suggerimenti che ricevi sui tipi di macchina modificando l'impostazione preferred_machine_types in uno dei seguenti valori:

  • DEFAULT: il valore predefinito è STANDARD_AND_CUSTOM
  • STANDARD_AND_CUSTOM: consiglia la migliore corrispondenza tra tipi di macchine standard e tipi personalizzati
  • STANDARD_ONLY: consiglia la migliore corrispondenza solo tra i tipi di macchine standard

Opzioni per i suggerimenti sulla memoria

Per le metriche di memoria utilizzate per generare i suggerimenti, puoi impostare i seguenti valori:

  • MEMORY_METRICS_DEFAULT: utilizza le metriche predefinite per generare suggerimenti
  • MEMORY_METRICS_ALL: utilizza tutte le metriche disponibili per generare suggerimenti
  • MONITORING_AGENT_ONLY: utilizza solo le metriche raccolte da Ops Agent di Cloud Monitoring
  • Se non utilizzi Ops Agent e preferisci non ricevere suggerimenti sulla memoria, utilizza il valore MEMORY_AGENT_ONLY per disattivarli

Per ricevere suggerimenti più precisi sull'uso della memoria, utilizza Ops Agent.

Aggiorna la configurazione di un progetto

Per aggiornare la configurazione dei suggerimenti sui tipi di macchina, modifica i relativi valori e carica la nuova configurazione del progetto. Puoi modificare i tipi di macchina preferiti, le metriche di memoria utilizzate per i suggerimenti o entrambi i valori nella stessa richiesta.

Dopo aver caricato la nuova configurazione, l'applicazione della modifica richiede circa 48 ore. Fino a quel momento, tutti i suggerimenti generati utilizzano la configurazione precedente.

gcloud

Per aggiornare i parametri di configurazione, utilizza i comandi gcloud beta recommender recommender-config update e google.compute.instance.MachineTypeRecommender come ID del motore per suggerimenti:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • ZONE: la zona per la quale vuoi ottenere la configurazione attuale.
  • LOCAL_FILE_PATH_AND_NAME: il percorso del file JSON con la configurazione attuale.
  • ETAG: il valore etag della configurazione attuale. Puoi trovare questo valore nell'output del comando precedente.

Nel file di configurazione, specifica solo l'oggetto recommenderGenerationConfig con i parametri di configurazione aggiornati. Se hai salvato la configurazione in un file locale, assicurati di copiare il valore etag, dopodiché rimuovi tutti i campi fatta eccezione per il valore recommenderGenerationConfig.

Ad esempio, per ottenere suggerimenti solo sui tipi di macchina standard, utilizza il seguente file di configurazione:

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

Se il comando ha esito positivo, restituisce un corpo della risposta simile al seguente, mostrando la nuova configurazione con i parametri appena modificati.

{
  "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"
}

Passaggi successivi