Spécifier l'image de l'OS de la VM pour un job

Cette page explique comment spécifier l'image du système d'exploitation (OS) des instances de machine virtuelle (VM) sur lesquelles une tâche s'exécute. Si vous souhaitez également personnaliser d'autres propriétés des disques de démarrage du job, consultez plutôt la section Créer et exécuter un job qui utilise des disques de démarrage personnalisés.

Pour en savoir plus sur les images d'OS de VM et sur les images d'OS de VM que vous pouvez utiliser, consultez la section Présentation de l'environnement d'OS de VM.

Avant de commencer

Créer et exécuter un job qui utilise une image de l'OS de VM spécifique

Spécifiez l'image de l'OS de la VM lorsque vous créez un job en sélectionnant l'une des méthodes suivantes:

  • Utilisez un modèle d'instance Compute Engine qui spécifie une image de l'OS de VM. Si vous souhaitez utiliser un modèle d'instance de VM lors de la création de ce job, vous devez spécifier l'image de l'OS de la VM dans le modèle d'instance de VM. Pour obtenir des instructions, consultez la page Définir des ressources de job à l'aide d'un modèle d'instance de VM.

  • Utilisez le champ "Image de l'OS de la VM". Comme expliqué dans les instructions suivantes, vous pouvez spécifier l'image de l'OS de la VM dans le champ image à l'aide de gcloud CLI ou de l'API Batch.

gcloud

  1. Créez un fichier JSON qui spécifie les détails de configuration de votre job. Pour spécifier l'image de l'OS de la VM pour la tâche, incluez le champ image.

    Par exemple, pour créer une tâche de script de base qui utilise une image de système d'exploitation de VM spécifique, créez un fichier JSON avec le contenu suivant:

    {
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}."
                        }
                    }
                ]
            },
            "taskCount": 3,
            "parallelism": 1
        }
    ],
    "allocationPolicy": {
      "instances": [
        {
          "policy": {
            "bootDisk": {
              "image": "VM_OS_IMAGE_URI"
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

    Remplacez VM_OS_IMAGE_URI par un nom de ressource relatif de l'image de l'OS de la VM. Utilisez l'une des options suivantes :

    • Spécifiez un préfixe Batch OS. Pour utiliser la dernière image d'un système d'exploitation Batch spécifique, utilisez le format suivant:

      BATCH_OS_PREFIX

      Remplacez BATCH_OS_PREFIX par l'un des préfixes d'image d'OS de VM par lot. Par exemple, batch-debian est le préfixe de l'OS Debian Batch.

    • Spécifiez une famille d'images. Pour utiliser la dernière image d'une famille d'images spécifique, utilisez le format suivant:

      projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY

      Remplacez les éléments suivants :

      • IMAGE_PROJECT_ID: ID du projet contenant l'image. Par exemple, pour toutes les images par lot, spécifiez batch-custom-image.
      • IMAGE_FAMILY: famille d'images, qui comprend une ou plusieurs images spécifiques et représente le type et la version majeure de l'OS. Par exemple, pour afficher toutes les familles d'images d'OS de VM de Batch, affichez la liste des images d'OS de VM.

    • Spécifiez une version d'image. Pour utiliser une version spécifique d'une image d'OS de VM, utilisez le format suivant:

      projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME

      Remplacez les éléments suivants :

      • IMAGE_PROJECT_ID: ID du projet contenant l'image. Par exemple, pour toutes les images par lot, spécifiez batch-custom-image.
      • IMAGE_NAME: nom de l'image, qui représente une version spécifique d'une image d'OS de VM. Par exemple, pour afficher toutes les versions d'image d'OS de VM de Batch, affichez la liste des images d'OS de VM.

  2. Pour créer la tâche, exécutez la commande gcloud batch jobs submit suivante:

    gcloud batch jobs submit JOB_NAME \
    --location LOCATION \
    --config JSON_CONFIGURATION_FILE

    Remplacez les éléments suivants :

    • JOB_NAME: nom de cette tâche.
    • LOCATION: lieu de cette tâche.
    • JSON_CONFIGURATION_FILE: chemin d'accès au fichier JSON contenant les détails de configuration de la tâche.

API

Pour créer une tâche à l'aide de l'API Batch, utilisez la méthode jobs.create et spécifiez les détails de configuration de votre tâche. Pour spécifier l'image de l'OS de la VM pour la tâche, incluez le champ image. Par exemple, pour créer une tâche de script de base qui utilise une image de système d'exploitation de VM spécifique, exécutez la requête POST suivante:

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,
            "parallelism": 1
        }
    ],
    "allocationPolicy": {
      "instances": [
        {
          "policy": {
            "bootDisk": {
              "image": "VM_OS_IMAGE_URI"
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

Remplacez les éléments suivants :

  • PROJECT_ID: ID de projet de votre projet.
  • LOCATION: emplacement de cette tâche.
  • JOB_NAME: nom de cette tâche.

  • VM_OS_IMAGE_URI: nom de ressource relatif de l'image de l'OS de la VM. Utilisez l'une des options suivantes :

    • Spécifiez un préfixe Batch OS. Pour utiliser la dernière image d'un système d'exploitation Batch spécifique, utilisez le format suivant:
    BATCH_OS_PREFIX

    Remplacez BATCH_OS_PREFIX par l'un des préfixes d'image d'OS de VM par lot. Par exemple, batch-debian est le préfixe de l'OS Debian Batch.

    • Spécifiez une famille d'images. Pour utiliser la dernière image d'une famille d'images spécifique, utilisez le format suivant:

      projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY

      Remplacez les éléments suivants :

      • IMAGE_PROJECT_ID: ID du projet contenant l'image. Par exemple, pour toutes les images par lot, spécifiez batch-custom-image.
      • IMAGE_FAMILY: famille d'images, qui comprend une ou plusieurs images spécifiques et représente le type et la version majeure de l'OS. Par exemple, pour afficher toutes les familles d'images d'OS de VM de Batch, affichez la liste des images d'OS de VM.

    • Spécifiez une version d'image. Pour utiliser une version spécifique d'une image d'OS de VM, utilisez le format suivant:

      projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME

      Remplacez les éléments suivants :

      • IMAGE_PROJECT_ID: ID du projet contenant l'image. Par exemple, pour toutes les images par lot, spécifiez batch-custom-image.
      • IMAGE_NAME: nom de l'image, qui représente une version spécifique d'une image d'OS de VM. Par exemple, pour afficher toutes les versions d'image d'OS de VM de Batch, affichez la liste des images d'OS de VM.

Étapes suivantes