Créer et exécuter un job qui utilise des disques de démarrage personnalisés

Cette page explique comment personnaliser les disques persistants utilisés pour démarrer chaque instance de machine virtuelle (VM) sur laquelle une tâche s'exécute.

Plus précisément, vous pouvez personnaliser la taille, le type et/ou l'image du système d'exploitation (OS) de VM d'un disque de démarrage. Si vous souhaitez uniquement personnaliser l'image de l'OS de la VM, consultez plutôt la section Spécifier l'image de l'OS de la VM pour une tâche.

Pour en savoir plus sur les disques de démarrage et savoir quand les configurer, consultez la page Présentation de l'environnement d'OS des VM.

Avant de commencer

Si vous n'avez jamais utilisé Batch, consultez la page Premiers pas avec Batch et activez Batch en remplissant les conditions préalables pour les projets et les utilisateurs.
Afin d'obtenir les autorisations nécessaires pour créer une tâche, demandez à votre administrateur de vous attribuer les rôles IAM suivants:
- Éditeur de tâches par lot (roles/batch.jobsEditor) sur le projet
- Utilisateur du compte de service (roles/iam.serviceAccountUser) sur le compte de service de la tâche, qui est par défaut le compte de service Compute Engine par défaut
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Créer et exécuter un job qui utilise un disque de démarrage personnalisé

Spécifiez un disque de démarrage personnalisé 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 un disque de démarrage personnalisé préexistant. Si vous souhaitez utiliser un modèle d'instance de VM lors de la création de ce job ou un disque de démarrage personnalisé préexistant, procédez comme suit:
1. Créez ou identifiez un disque de démarrage personnalisé.
  
  Pour connaître la configuration requise pour le disque de démarrage pour Batch, consultez ce document et la page Présentation de l'environnement d'OS des VM. Pour savoir comment créer un disque de démarrage, consultez la section Créer un disque de démarrage personnalisé dans la documentation Compute Engine.
2. Créez ou identifiez un modèle d'instance de VM qui inclut ce disque de démarrage personnalisé.
  
  Pour découvrir comment créer un modèle d'instance de VM, consultez la section Créer des modèles d'instance dans la documentation Compute Engine.
3. Créez et exécutez un job qui inclut ce modèle d'instance de VM.
  
  Pour savoir comment créer et exécuter le job, consultez la page Définir les ressources d'un job à l'aide d'un modèle d'instance de VM.
Utilisez le champ "Boot disk" (Disque de démarrage) pour spécifier un nouveau disque de démarrage personnalisé. Comme expliqué dans les instructions suivantes, vous pouvez définir un nouveau disque de démarrage personnalisé à l'aide du champ disque de démarrage (bootDisk) lorsque vous créez et exécutez une tâche à l'aide de gcloud CLI ou de l'API Batch.

Plus précisément, vous pouvez personnaliser le disque de démarrage en configurant les sous-champs Image de l'OS de VM (image), type de disque persistant (type) et/ou taille (sizeGb). Batch définit une valeur par défaut pour chacun de ces sous-champs que vous choisissez d'omettre.

gcloud

Créez un fichier JSON qui spécifie les détails de configuration de votre job. Pour spécifier un nouveau disque de démarrage personnalisé pour les VM du job, incluez le champ et les sous-champs bootDisk.

Par exemple, pour créer une tâche de script de base qui utilise un nouveau disque de démarrage personnalisé, 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",
              "type": "BOOT_DISK_TYPE",
              "sizeGb": BOOT_DISK_SIZE
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}
```
Remplacez les éléments suivants :
- 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.
- BOOT_DISK_TYPE: type de disque du disque de démarrage (pd-standard, pd-balanced, pd-ssd ou pd-extreme).
- BOOT_DISK_SIZE: taille du nouveau disque de démarrage persistant en Go. Cette valeur doit respecter toutes les exigences de taille du disque de démarrage.
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 et les sous-champs bootDisk. Par exemple, pour créer une tâche de script de base qui utilise un nouveau disque de démarrage personnalisé, 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",
              "type": "BOOT_DISK_TYPE",
              "sizeGb": BOOT_DISK_SIZE
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

Remplacez les éléments suivants :

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.
BOOT_DISK_TYPE: type de disque du disque de démarrage (pd-standard, pd-balanced, pd-ssd ou pd-extreme).
BOOT_DISK_SIZE: taille du nouveau disque de démarrage persistant en Go. Cette valeur doit respecter toutes les exigences de taille du disque de démarrage.

Étapes suivantes

Si vous rencontrez des problèmes pour créer ou exécuter un job, consultez la section Dépannage.
En savoir plus sur les disques de démarrage et les images d'OS de VM
Découvrez comment créer une tâche.
Découvrez comment afficher des tâches et des tâches.