Afficher les images de système d'exploitation de VM pour Batch

Cette page explique comment afficher les images de système d'exploitation (OS) disponibles pour les instances de machine virtuelle (VM) qui exécutent des jobs Batch.

Plus précisément, cette page explique comment afficher une liste et les détails des images d'OS de VM à partir de Batch. Pour en savoir plus sur les images d'OS de VM et sur celles que vous pouvez utiliser avec Batch, consultez la présentation de l'environnement d'OS de VM. Si vous souhaitez afficher d'autres images d'OS de VM, telles que des images publiques images de Compute Engine ou des images personnalisées, consultez plutôt la documentation sur les images Compute Engine.

Avant de commencer

  1. Si vous n'avez jamais utilisé Batch, consultez la section Premiers pas avec Batch et activez Batch en remplissant les prérequis pour les projets et les utilisateurs.

Afficher la liste des images d'OS de VM à partir de Batch

Vous pouvez afficher la liste de toutes les images d'OS de VM à partir de Batch à l'aide de gcloud CLI ou de l'API Batch.

gcloud

Pour lister toutes les images d'OS de VM compatibles à partir de Batch, utilisez la commande gcloud compute images listsuivante :

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • L'indicateur --project=batch-custom-image est obligatoire pour lister les images à partir de Batch.
  • L'indicateur --no-standard-images omet les images standards de Compute Engine.
  • Facultatif : si vous devez afficher les images Batch obsolètes, incluez également l'indicateur --show-deprecated.

Le résultat de chaque image d'OS de VM est semblable à ce qui suit :

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

Ce résultat inclut les valeurs suivantes :

  • IMAGE_NAME : nom de l'image. Un nom d'image représente une version spécifique d'une image d'OS de VM. Par exemple, le nom d'image batch-debian-11-official-20230802-00-p00 représente la version d'image -20230802-00-p00 (version du 2 août 2023) pour la famille d'images batch-debian-11-official.
  • IMAGE_PROJECT_ID : ID de projet du projet contenant l'image. Par exemple, toutes les images de Batch se trouvent dans le projet batch-custom-image.
  • IMAGE_FAMILY : famille de l'image. Une famille d'images inclut une ou plusieurs images spécifiques et représente le type et la version majeure de l'OS. Par exemple, la famille d'images batch-debian-11-official contient des images Batch basées sur la version 11 de l'OS Debian de Compute Engine.

API

Pour lister toutes les images d'OS de VM compatibles à partir de Batch, envoyez la requête suivante à la images.list méthode :

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • Le projet batch-custom-image est obligatoire pour lister les images à partir de Batch.
  • Le paramètre de requête ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omet les images obsolètes en utilisant l'encodage d'URL pour définir le champ filter sur (-deprecated:*) OR (deprecated.state="ACTIVE").
    • Facultatif : si vous devez afficher les images Batch obsolètes, supprimez le paramètre de requête ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

Le résultat de chaque image d'OS de VM est semblable à ce qui suit :

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

Ce résultat inclut les valeurs suivantes :

  • IMAGE_NAME : nom de l'image. Un nom d'image représente une version spécifique d'une image d'OS de VM. Par exemple, le nom d'image batch-debian-11-official-20230802-00-p00 représente la version d'image -20230802-00-p00 (version du 2 août 2023) pour la famille d'images batch-debian-11-official.
  • IMAGE_PROJECT_ID : ID de projet du projet contenant l'image. Par exemple, toutes les images de Batch se trouvent dans le projet batch-custom-image.
  • IMAGE_FAMILY : famille de l'image. Une famille d'images inclut une ou plusieurs images spécifiques et représente le type et la version majeure de l'OS. Par exemple, la famille d'images batch-debian-11-official contient des images Batch basées sur la version 11 de l'OS Debian de Compute Engine.

Afficher les détails d'une image d'OS de VM à partir de Batch

Vous pouvez afficher tous les détails d'une image d'OS de VM à l'aide de gcloud CLI ou de l'API Batch.

gcloud

Pour afficher les détails d'une image d'OS de VM à partir de Batch, utilisez la gcloud compute images describe commande et spécifiez batch-custom-image comme projet d'image :

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

Remplacez IMAGE_NAME par le nom de l'image d'OS de VM de Batch que vous souhaitez décrire.

API

Pour afficher les détails d'une image d'OS de VM à partir de Batch, envoyez une requête à la images.get méthode et spécifiez batch-custom-image comme projet d'image :

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

Remplacez IMAGE_NAME par le nom de l'image d'OS de VM de Batch que vous souhaitez décrire.

Étape suivante