Visualizzare le immagini del sistema operativo VM per Batch

Questa pagina descrive come visualizzare le immagini del sistema operativo (OS) disponibili per le istanze di macchine virtuali (VM) che eseguono job Batch.

In particolare, questa pagina descrive come visualizzare un elenco e i dettagli delle immagini del sistema operativo VM da Batch. Per saperne di più sulle immagini del sistema operativo VM e su quali immagini del sistema operativo VM puoi utilizzare con Batch, consulta Panoramica dell'ambiente del sistema operativo VM. Se vuoi visualizzare altre immagini del sistema operativo VM, ad esempio immagini pubbliche di Compute Engine o immagini personalizzate, consulta la documentazione sulle immagini di Compute Engine.

Prima di iniziare

  1. Se non hai mai utilizzato Batch, consulta la sezione Guida introduttiva a Batch e attiva Batch completando i prerequisiti per progetti e utenti.

Visualizza un elenco di immagini del sistema operativo VM da Batch

Puoi visualizzare un elenco di tutte le immagini del sistema operativo VM da Batch utilizzando gcloud CLI o l'API Batch.

gcloud

Per elencare tutte le immagini del sistema operativo VM supportate da Batch, utilizza il seguente comando gcloud compute images list:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • Il flag --project=batch-custom-image è obbligatorio per elencare le immagini dal batch.
  • Il flag --no-standard-images omette le immagini standard da Compute Engine.
  • (Facoltativo) Se devi visualizzare le immagini Batch ritirate, includi anche il flag --show-deprecated.

L'output per ogni immagine del sistema operativo VM è simile al seguente:

NAME: IMAGE_NAME
PROJECT: IMAGE_PROJECT_ID
FAMILY: IMAGE_FAMILY
...

Questo output include i seguenti valori:

  • IMAGE_NAME: il nome dell'immagine. Un nome immagine rappresenta una versione specifica di un'immagine sistema operativo VM. Ad esempio, il nome dell'immagine batch-debian-11-official-20230802-00-p00 rappresenta la versione dell'immagine -20230802-00-p00 (la versione del 2 agosto 2023) per la famiglia di immagini batch-debian-11-official.
  • IMAGE_PROJECT_ID: l'ID progetto del progetto che contiene l'immagine. Ad esempio, tutte le immagini di Batch images si trovano nel progetto batch-custom-image.
  • IMAGE_FAMILY: la famiglia dell'immagine. Una famiglia di immagini include una o più immagini specifiche e rappresenta il tipo e la versione principale del sistema operativo. Ad esempio, la famiglia di immagini batch-debian-11-official contiene immagini Batch basate sulla versione 11 del sistema operativo Debian di Compute Engine.

API

Per elencare tutte le immagini del sistema operativo VM supportate da Batch, invia la seguente richiesta al metodo images.list:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • Il progetto batch-custom-image è necessario per elencare le immagini di Batch.
  • Il parametro di query ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omette le immagini obsolete utilizzando la codifica URL per impostare il campo filter su (-deprecated:*) OR (deprecated.state="ACTIVE").
    • (Facoltativo) Se devi visualizzare le immagini batch ritirate, rimuovi il parametro di ricerca ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

L'output per ogni immagine del sistema operativo VM è simile al seguente:

{
  ...
  "name": "IMAGE_NAME",
  ...
  "family": "IMAGE_FAMILY",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME",
  ...
}

Questo output include i seguenti valori:

  • IMAGE_NAME: il nome dell'immagine. Un nome immagine rappresenta una versione specifica di un'immagine sistema operativo VM. Ad esempio, il nome dell'immagine batch-debian-11-official-20230802-00-p00 rappresenta la versione dell'immagine -20230802-00-p00 (la versione del 2 agosto 2023) per la famiglia di immagini batch-debian-11-official.
  • IMAGE_PROJECT_ID: l'ID progetto del progetto che contiene l'immagine. Ad esempio, tutte le immagini di Batch images si trovano nel progetto batch-custom-image.
  • IMAGE_FAMILY: la famiglia dell'immagine. Una famiglia di immagini include una o più immagini specifiche e rappresenta il tipo e la versione principale del sistema operativo. Ad esempio, la famiglia di immagini batch-debian-11-official contiene immagini Batch basate sulla versione 11 del sistema operativo Debian di Compute Engine.

Visualizza i dettagli di un'immagine del sistema operativo VM da Batch

Puoi visualizzare tutti i dettagli di un'immagine sistema operativo VM utilizzando gcloud CLI o l'API Batch.

gcloud

Per visualizzare i dettagli di un'immagine del sistema operativo VM da Batch, utilizza il comando gcloud compute images describe e specifica batch-custom-image come progetto immagine:

gcloud compute images describe IMAGE_NAME --project=batch-custom-image

Sostituisci IMAGE_NAME con il nome dell'immagine sistema operativo VM di Batch che vuoi descrivere.

API

Per visualizzare i dettagli di un'immagine del sistema operativo VM da Batch, invia una richiesta al metodo images.get e specifica batch-custom-image come progetto dell'immagine:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME

Sostituisci IMAGE_NAME con il nome dell'immagine sistema operativo VM di Batch che vuoi descrivere.

Passaggi successivi