Configurare i suggerimenti sui tipo di macchina


Questa pagina descrive come visualizzare e modificare la configurazione dei consigli per il tipo di macchina. Puoi modificare i tipi di macchine consigliati, in modo che i consigli generati includano solo la serie di macchine che preferisci. Puoi anche modificare le metriche utilizzate per generare consigli sulla memoria per migliorare l'accuratezza dei consigli. Le modifiche alla configurazione vengono applicate a livello di progetto.

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

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso ai servizi e alle 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. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.

Ruoli obbligatori

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

Questo ruolo predefinito contiene le autorizzazioni necessarie per modificare i consigli tipo di macchina. Per visualizzare le autorizzazioni esatta richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per modificare i consigli tipo di macchina sono necessarie le seguenti autorizzazioni:

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

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

Configurare i consigli

Per configurare i consigli per i tipo di macchina, svolgi i seguenti passaggi:

  1. Ottieni la configurazione corrente per ottenere il file JSON della configurazione.
  2. Modifica il file di configurazione in formato JSON.
  3. Carica il nuovo file di configurazione per applicare le modifiche.

Ottenere la configurazione attuale

Puoi ottenere la configurazione corrente per i consigli tipo di macchina per il tuo progetto utilizzando Google Cloud CLI.

gcloud

Per ottenere i parametri di configurazione correnti, utilizza il comando gcloud beta recommender recommender-config describe e google.compute.instance.MachineTypeRecommender come ID consigliere:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto.
  • ZONE: la zona per la quale vuoi ottenere la configurazione corrente.

Il comando restituisce la configurazione del recommender, 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

Modificare la configurazione dei consigli

La configurazione ti consente di personalizzare i seguenti parametri:

  • preferred_machine_types: i consigli sui tipi di macchine che ricevi.
  • memory_metrics: come vengono utilizzate le metriche di memoria per generare consigli.

Opzioni per i consigli sui tipi di macchine

Puoi specificare i tipi di macchine di cui vuoi ricevere i consigli 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 i tipi di macchine standard e personalizzate.
  • STANDARD_ONLY: consiglia la migliore corrispondenza solo tra i tipi di macchine standard.

Opzioni per i consigli sulla memoria

Per le metriche della memoria utilizzate per generare i consigli, puoi impostare i seguenti valori:

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

Per ottenere consigli più precisi sull'utilizzo della memoria, utilizza l'agente Ops.

Aggiornare la configurazione di un progetto

Per aggiornare la configurazione dei consigli per i tipo di macchina, modifica i valori di configurazione e carica la nuova configurazione per il progetto. Puoi modificare i tipi di macchine preferiti, le metriche della memoria utilizzate per i consigli o entrambi i valori nella stessa richiesta.

Dopo aver caricato la nuova configurazione, sono necessarie circa 48 ore per l'applicazione. Fino a quel momento, tutti i consigli generati utilizzeranno la configurazione precedente.

gcloud

Per aggiornare i parametri di configurazione, utilizza il comando gcloud beta recommender recommender-config update e google.compute.instance.MachineTypeRecommender come ID recommender:

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 del progetto.
  • ZONE: la zona per la quale vuoi ottenere la configurazione corrente.
  • LOCAL_FILE_PATH_AND_NAME: il percorso del file JSON con la configurazione corrente.
  • ETAG: il valore etag della configurazione corrente. 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, quindi rimuovi tutti i campi tranne il valore recommenderGenerationConfig.

Ad esempio, per ricevere consigli solo con tipi di macchine 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, che mostra 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