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.

Nello specifico, questa pagina descrive come visualizzare un elenco e i dettagli delle immagini del sistema operativo VM da Batch. Per scoprire di più sulle immagini del sistema operativo VM e su quali puoi utilizzare con Batch, consulta la 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 delle immagini di Compute Engine.

Prima di iniziare

  1. Se non hai mai utilizzato Batch, consulta la guida introduttiva all'utilizzo di Batch e attivalo completando i prerequisiti per progetti e utenti.

Visualizzare 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 l'interfaccia a riga di comando gcloud 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 da Batch.
  • Il flag --no-standard-images omette le immagini standard di Compute Engine.
  • (Facoltativo) Se devi visualizzare le immagini di batch ritirate, includi anche il flag --show-deprecated.

L'output per ogni immagine del sistema operativo della 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 del sistema operativo della VM. Ad esempio, il nome immagine batch-debian-11-official-20230802-00-p00 rappresenta la versione immagine -20230802-00-p00 (la versione del 2 agosto 2023) per la famiglia di immagini batch-debian-11-official.
  • IMAGE_PROJECT_ID: il ID progetto del progetto che contiene l'immagine. Ad esempio, tutte le immagini di Immagini batch 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, effettua 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 non più supportate 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 query ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

L'output per ogni immagine del sistema operativo della 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 del sistema operativo della VM. Ad esempio, il nome immagine batch-debian-11-official-20230802-00-p00 rappresenta la versione immagine -20230802-00-p00 (la versione del 2 agosto 2023) per la famiglia di immagini batch-debian-11-official.
  • IMAGE_PROJECT_ID: il ID progetto del progetto che contiene l'immagine. Ad esempio, tutte le immagini di Immagini batch 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.

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

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

gcloud

Per visualizzare i dettagli di un'immagine del sistema operativo della 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 del sistema operativo VM di Batch che vuoi descrivere.

API

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

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

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

Passaggi successivi