Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Exécuter une compilation par lots (AWS CLI)
<a name="run-batch-build-cli"></a>

1. Exécutez la commande `start-build-batch` de l'une des manières suivantes :

   ```
   aws codebuild start-build-batch --project-name <project-name>
   ```

   Utilisez cette commande si vous souhaitez exécuter une génération utilisant la dernière version de l'artefact d'entrée de génération et les paramètres existants du projet de génération.

   ```
   aws codebuild start-build-batch --generate-cli-skeleton > <json-file>
   ```

   Utilisez cette commande si vous souhaitez exécuter une génération avec une version précédente de l'artefact d'entrée de génération, ou si vous souhaitez remplacer les paramètres pour les artefacts de sortie, les variables d'environnement, le fichier buildspec ou le délai d'expiration de génération par défaut.

1. Si vous exécutez la **start-build-batch** commande avec l'`--project-name`option, *<project-name>* remplacez-la par le nom du projet de génération, puis passez à l'étape 6 de cette procédure. Pour obtenir une liste de projets de génération, consultez [Afficher les noms des projets de construction](view-project-list.md).

1. Si vous exécutez la **start-build-batch** commande avec l'`--idempotency-token`option, un identifiant unique distinguant majuscules et minuscules, ou jeton, est inclus dans la `start-build-batch` demande. Le jeton est valide pendant 5 minutes après la demande . Si vous répétez la `start-build-batch` demande avec le même jeton, mais que vous modifiez un paramètre, CodeBuild renvoie une erreur de non-concordance des paramètres.

1. Si vous exécutez la **start-build-batch** commande avec l'`--generate-cli-skeleton`option, les données au format JSON sont sorties dans le fichier. *<json-file>* Ce fichier est similaire au squelette produit par la **start-build** commande, avec l'ajout de l'objet suivant. Pour plus d'informations sur les objets courants, consultez[Exécution d'une génération (AWS CLI)](run-build-cli.md).

   Modifiez ce fichier pour ajouter des remplacements de build et enregistrez vos résultats.

   ```
     "buildBatchConfigOverride": {
       "combineArtifacts": combineArtifacts,
       "restrictions": {
         "computeTypesAllowed": [
           allowedComputeTypes
         ],
         "maximumBuildsAllowed": maximumBuildsAllowed
       },
       "serviceRole": "batchServiceRole",
       "timeoutInMins": batchTimeout
     }
   ```

   L'`buildBatchConfigOverride`objet est une [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html)structure qui contient les remplacements de configuration de génération par lots pour cette version.  
*combineArtifacts*  
Un booléen qui indique si les artefacts de construction pour la génération par lots doivent être combinés dans un seul emplacement d'artefact.  
*allowedComputeTypes*  
Tableau de chaînes qui spécifient les types de calcul autorisés pour la construction par lots. Reportez-vous [à la section Types de calcul de l'environnement](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html) de génération pour ces valeurs.   
*maximumBuildsAllowed*  
Spécifie le nombre maximal de builds autorisés.  
*batchServiceRole*  
Spécifie l'ARN du rôle de service pour le projet de génération par lots.  
*batchTimeout*  
Spécifie la durée maximale, en minutes, pendant laquelle la génération du lot doit être terminée.

1. Placez-vous dans le répertoire contenant le fichier que vous venez d'enregistrer, puis exécutez à nouveau la commande `start-build-batch`.

   ```
   aws codebuild start-build-batch --cli-input-json file://start-build.json
   ```

1. En cas de succès, la représentation JSON d'un [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html)objet apparaît dans la sortie de la console. Voir la [syntaxe de StartBuildBatch réponse](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax) pour un exemple de ces données.