Garantisci la disponibilità delle risorse utilizzando le prenotazioni di VM

Questo documento spiega come creare job in esecuzione su risorse prenotate.

Le prenotazioni sono una funzionalità di Compute Engine. Una prenotazione offre un livello molto elevato di garanzia nell'ottenimento di capacità per una o più VM con la configurazione hardware specificata. Una prenotazione per una VM comporta i costi della VM dal momento della creazione a quella dell'eliminazione della prenotazione. Tuttavia, mentre utilizzi quella VM, il costo totale è equivalente a una VM senza prenotazione.

In genere, le prenotazioni sono utili quando la disponibilità di capacità è di fondamentale importanza o per evitare errori nell'acquisizione delle risorse. Per Batch in particolare, valuta la possibilità di utilizzare prenotazioni dedicate per ridurre al minimo i tempi di pianificazione dei job oppure prova a utilizzare le prenotazioni esistenti quando non vengono utilizzate. Se hai un numero di prenotazioni insufficiente, ad esempio le prenotazioni richieste per gli sconti per impegno di utilizzo, puoi configurare i job in modo che tentino di consumarli mentre non vengono utilizzati per provare a ottimizzare i costi sostenuti.

Per saperne di più sulle prenotazioni, consulta la documentazione di Compute Engine per le prenotazioni.

Prima di iniziare

Se non hai mai utilizzato Batch, consulta la Guida introduttiva all'utilizzo di Batch e abilita Batch completando i prerequisiti per progetti e utenti.
Assicurati di disporre delle autorizzazioni per creare una prenotazione o visualizzare una prenotazione esistente che vuoi che le VM di un job utilizzino in base alle esigenze.
Per ottenere le autorizzazioni necessarie per creare un job, chiedi all'amministratore di concederti i seguenti ruoli IAM:
- Editor job batch (roles/batch.jobsEditor) sul progetto
- Utente account di servizio (roles/iam.serviceAccountUser) nell'account di servizio del job, che per impostazione predefinita è l'account di servizio Compute Engine predefinito
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Oltre alle limitazioni generali per le prenotazioni, Batch dispone anche delle seguenti limitazioni:

Le VM di un job non possono utilizzare le prenotazioni condivise.
Le VM di un job non possono utilizzare le prenotazioni se specifica un criterio di posizionamento compatto.

Requisiti

Questa sezione riassume i requisiti per il consumo di una prenotazione da parte delle VM di un job. Per ulteriori informazioni su tutti i requisiti, consulta i requisiti generali per le prenotazioni nella documentazione di Compute Engine e la procedura per pianificare la configurazione più avanti in questo documento.

Affinché le VM di un job siano in grado di utilizzare in generale una prenotazione, devono essere soddisfatte tutte le seguenti condizioni:
- Il job e la prenotazione devono specificare proprietà della VM che corrispondono esattamente.
- Devi rispettare tutte le limitazioni riportate in questo documento e tutti gli altri requisiti generali per le prenotazioni.
Affinché ciascuna delle VM di un job utilizzi correttamente una prenotazione, questa deve avere capacità inutilizzata disponibile durante il tempo di esecuzione della VM.

La capacità inutilizzata di una prenotazione è la differenza tra il numero di VM e il numero di VM che la utilizzano. Le VM tentano di consumare le prenotazioni ogni volta che hai capacità di prenotazione inutilizzata. Di conseguenza, una VM può iniziare a utilizzare una prenotazione al momento della creazione o in un secondo momento. Una VM non smette di utilizzare una prenotazione finché la VM non viene arrestata o la prenotazione non viene eliminata.

A seconda della capacità di prenotazione totale inutilizzata, nessuna, alcune o tutte le VM di un job potrebbero consumare prenotazioni e la quantità di VM prenotate potrebbe variare durante il tempo di esecuzione del job.

Crea ed esegui un job che può consumare VM riservate

Pianifica la configurazione. Per assicurarti che il job e la prenotazione siano compatibili, completa i seguenti passaggi.

Se vuoi utilizzare una prenotazione già esistente, devi creare un job con una configurazione corrispondente. Altrimenti, se prevedi di creare una nuova prenotazione, seleziona le opzioni di configurazione che preferisci.
1. Determina le proprietà della prenotazione. A causa delle restrizioni, il tipo di condivisione deve essere single-project, che è l'opzione predefinita per una prenotazione. Determina i valori da utilizzare per le seguenti proprietà di prenotazione:
  - Tipo di consumo^*
  - Numero di VM^†
  ^* Il tipo di consumo della prenotazione (con target specifico o consumo automatico) determina quali VM possono utilizzare la prenotazione.
  
  ^†Il conteggio VM rappresenta la capacità totale di una prenotazione. Quando decidi questo valore, considera il numero di VM del job.
2. Determina le proprietà della VM per il job e la prenotazione. A causa delle restrizioni, né il job né la prenotazione possono specificare un criterio di posizionamento compatto, che è l'opzione predefinita sia per le prenotazioni che per i job. Determina i valori che vuoi utilizzare per le seguenti proprietà VM, che devono corrispondere esattamente alla prenotazione e al job:
  - Progetto
  - Zona^*
  - Tipo di macchina^†
  - Piattaforma CPU minima^† (se presente^‡)
  - Tipo e numero di GPU^† (se presenti^‡)
  - Tipo e numero di SSD locali^† (se presenti^‡)
  - Affinità prenotazione^†^#
  ^* Le VM del job devono trovarsi nella stessa zona delle VM prenotate. Devi includere questa zona nel campo allowedLocations[] del job oppure, se ometti il campo allowedLocations[], impostare la località del job sulla regione che contiene questa zona.
  
  ^†Il job deve definire tutte queste proprietà utilizzando i sottocampi policy o un modello di istanza VM. Un job non può specificare una combinazione di policy sottocampi e un modello.
  
  ^‡ Non è possibile definire un campo facoltativo per una risorsa ed essere omesso dall'altra. Definisci o ometti il campo facoltativo sia per la prenotazione che per il job. Se il job specifica un modello di istanza VM, questo si applica anche ai campi del modello specificato.
  
  ^#Il tipo di consumo della prenotazione determina l'affinità di prenotazione richiesta per le VM del job, che devi specificare nel job come segue:
  - Se il job utilizza un modello di istanza VM, il modello deve configurare l'affinità di prenotazione come spiegato nella documentazione delle prenotazioni.
  - Se il job non utilizza un modello e la prenotazione ha un target specifico, specifica il nome della prenotazione nel campo reservation del job.
  - Altrimenti, se il job non utilizza un modello e la prenotazione viene utilizzata automaticamente, ometti il campo reservation del job.
Prepara la prenotazione. Se non l'hai ancora fatto, crea la prenotazione che vuoi che venga utilizzata dalle VM del job. Assicurati che la prenotazione abbia le proprietà che hai pianificato.
Crea ed esegui il job. Puoi creare ed eseguire un job che consuma VM dalla prenotazione preparata utilizzando l'interfaccia a riga di comando gcloud o l'API Batch:

Importante: a causa di un problema noto, l'esecuzione dei job che utilizzano VM riservate potrebbe essere ritardata o bloccata in modo errato. Per risolvere il problema, aggiungi un'etichetta con il nome goog-batch-skip-quota-check e il valore true al campo labels a livello di job. Per maggiori informazioni, consulta Problemi noti.
gcloud
1. Crea un file JSON che specifichi i dettagli di configurazione del job in modo che i sottocampi delle risorse dell'istanza VM (instances[]) corrispondano esattamente alle proprietà VM di una prenotazione.
  
  Ad esempio, per creare un job di script di base che utilizzi le VM da una prenotazione, crea un file JSON con i seguenti contenuti:
```
{
  "taskGroups": [
    {
      "taskSpec": {
        "runnables": [
          {
            "script": {
              "text": "echo Hello world from task ${BATCH_TASK_INDEX}"
            }
          }
        ]
      },
      "taskCount": 3
    }
  ],
  "allocationPolicy": {
    "instances": [
      {
        VM_RESOURCES
      }
    ],
  },
  "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}
```
  Sostituisci VM_RESOURCES con le risorse VM corrispondenti alla prenotazione che il job deve utilizzare, specificando i sottocampi instances[] che hai pianificato nei passaggi precedenti.
  
  Ad esempio, inizia dal seguente valore per VM_RESOURCES:
```
"installGpuDrivers": INSTALL_GPU_DRIVERS,
"policy": {
  "machineType": "MACHINE_TYPE",
  "minCpuPlatform": "MIN_CPU_PLATFORM",
  "accelerators": [
    {
      "type": "GPU_TYPE",
      "count": GPU_COUNT
    }
  ],
  "disks": [
    {
      "newDisk": {
        "sizeGb": LOCAL_SSD_SIZE,
        "type": "local-ssd"
      },
      "deviceName": "LOCAL_SSD_NAME"
    }
  ],
  "reservation": "SPECIFIC_RESERVATION_NAME"
}
```
  Per utilizzare questo valore, apporta tutte le seguenti modifiche:
  1. Vuoi utilizzare un modello di istanza?
    
    Sì: sostituisci il campo policy con il campo instanceTemplate e specifica un modello di istanza VM esistente che corrisponda alla prenotazione. Ad esempio, consulta l'esempio di codice per l'utilizzo di un modello di istanza VM. Se la prenotazione utilizza GPU o SSD locali, devi configurare anche i campi installGpuDrivers e volumes[] del job rispettivamente. In caso contrario, ignora le modifiche rimanenti.
    
    No: sostituisci MACHINE_TYPE con lo stesso tipo di macchina della prenotazione.
  2. La prenotazione include una piattaforma CPU minima?
    
    Sì: sostituisci MIN_CPU_PLATFORM con la stessa piattaforma CPU minima.
    
    No: rimuovi il campo minCpuPlatform.
  3. La prenotazione include GPU?
    
    Sì: sostituisci INSTALL_GPU_DRIVERS, GPU_TYPE e GPU_COUNT in modo che corrispondano alla prenotazione. Ad esempio, consulta l'esempio di codice per l'utilizzo delle GPU.
    
    No: rimuovi i campi installGpuDrivers e accelerators[].
  4. La prenotazione include SSD locali?
    
    Sì: sostituisci LOCAL_SSD_SIZE e LOCAL_SSD_NAME in modo che corrispondano alla prenotazione e monta gli SSD locali aggiungendo il campo volumes[] al job. Ad esempio, consulta l'esempio di codice per l'utilizzo di SSD locali.
    
    No: rimuovi il campo disks[].
  5. La prenotazione utilizza il tipo di consumo target specifico?
    
    Sì: sostituisci SPECIFIC_RESERVATION_NAME con il nome della prenotazione.
    
    No: rimuovi il campo reservation.
  Ad esempio, supponi di utilizzare una prenotazione utilizzata automaticamente per le VM n2-standard-32 che non specifica alcuna piattaforma CPU minima, GPU o SSD locali. Inoltre, non vuoi specificare un modello di istanza VM. In questo caso, devi sostituire VM_RESOURCES con il seguente valore:
```
"policy": {
  "machineType": "n2-standard-32"
}
```
2. Per creare ed eseguire il job, utilizza il comando gcloud batch jobs submit:
```
gcloud batch jobs submit JOB_NAME \
  --location LOCATION \
  --config JSON_CONFIGURATION_FILE
```
  Sostituisci quanto segue:
  - JOB_NAME: il nome del job.
  - LOCATION: la località del job. A meno che il job non specifichi il campo allowedLocations[], questa deve essere la regione che contiene la zona della prenotazione.
  - JSON_CONFIGURATION_FILE: il percorso di un file JSON con i dettagli di configurazione del job.
API
Effettua una richiesta POST al metodo jobs.create, che imposta i sottocampi delle risorse dell'istanza VM (instances[]) in modo che corrispondano esattamente alle proprietà VM di una prenotazione.

Ad esempio, per creare un job di script di base che consuma VM da una prenotazione, effettua la seguente richiesta:
```
POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs?job_id=JOB_NAME
{
  "taskGroups": [
    {
      "taskSpec": {
        "runnables": [
          {
            "script": {
              "text": "echo Hello world from task ${BATCH_TASK_INDEX}"
            }
          }
        ]
      },
      "taskCount": 3
    }
  ],
  "allocationPolicy": {
    "instances": [
      {
        VM_RESOURCES
      }
    ],
  },
  "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto del progetto.
- LOCATION: la località del job. A meno che il job non specifichi il campo allowedLocations[], questa deve essere la regione che contiene la zona della prenotazione.
- JOB_NAME: il nome del job.
- VM_RESOURCES: le risorse VM corrispondenti alla prenotazione che vuoi che il job utilizzi specificando i sottocampi instances[] che hai pianificato nei passaggi precedenti.
  
  Ad esempio, inizia dal seguente valore per VM_RESOURCES:
```
"installGpuDrivers": INSTALL_GPU_DRIVERS,
"policy": {
  "machineType": "MACHINE_TYPE",
  "minCpuPlatform": "MIN_CPU_PLATFORM",
  "accelerators": [
    {
      "type": "GPU_TYPE",
      "count": GPU_COUNT
    }
  ],
  "disks": [
    {
      "newDisk": {
        "sizeGb": LOCAL_SSD_SIZE,
        "type": "local-ssd"
      },
      "deviceName": "LOCAL_SSD_NAME"
    }
  ],
  "reservation": "SPECIFIC_RESERVATION_NAME"
}
```
  Per utilizzare questo valore, apporta tutte le seguenti modifiche:
  1. Vuoi utilizzare un modello di istanza?
    
    Sì: sostituisci il campo policy con il campo instanceTemplate e specifica un modello di istanza VM esistente che corrisponda alla prenotazione. Ad esempio, consulta l'esempio di codice per l'utilizzo di un modello di istanza VM. Se la prenotazione utilizza GPU o SSD locali, devi configurare anche i campi installGpuDrivers e volumes[] del job rispettivamente. In caso contrario, ignora le modifiche rimanenti.
    
    No: sostituisci MACHINE_TYPE con lo stesso tipo di macchina della prenotazione.
  2. La prenotazione include una piattaforma CPU minima?
    
    Sì: sostituisci MIN_CPU_PLATFORM con la stessa piattaforma CPU minima.
    
    No: rimuovi il campo minCpuPlatform.
  3. La prenotazione include GPU?
    
    Sì: sostituisci INSTALL_GPU_DRIVERS, GPU_TYPE e GPU_COUNT in modo che corrispondano alla prenotazione. Ad esempio, consulta l'esempio di codice per l'utilizzo delle GPU.
    
    No: rimuovi i campi installGpuDrivers e accelerators[].
  4. La prenotazione include SSD locali?
    
    Sì: sostituisci LOCAL_SSD_SIZE e LOCAL_SSD_NAME in modo che corrispondano alla prenotazione e monta gli SSD locali aggiungendo il campo volumes[] al job. Ad esempio, consulta l'esempio di codice per l'utilizzo di SSD locali.
    
    No: rimuovi il campo disks[].
  5. La prenotazione utilizza il tipo di consumo target specifico?
    
    Sì: sostituisci SPECIFIC_RESERVATION_NAME con il nome della prenotazione.
    
    No: rimuovi il campo reservation.
  Ad esempio, supponi di utilizzare una prenotazione utilizzata automaticamente per le VM n2-standard-32 che non specifica alcuna piattaforma CPU minima, GPU o SSD locali. Inoltre, non vuoi specificare un modello di istanza VM. In questo caso, devi sostituire VM_RESOURCES con il seguente valore:
```
"policy": {
  "machineType": "n2-standard-32"
}
```

Passaggi successivi

In caso di problemi durante la creazione o l'esecuzione di un job, consulta Risoluzione dei problemi.
Visualizzare lavori e attività.
Scopri di più sulle opzioni per la creazione di job.