View a markdown version of this page

Exécutez une compilation par lots (AWS CLI) - AWS CodeBuild

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écutez une compilation par lots (AWS CLI)

  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.

  2. Si vous exécutez la start-build-batch commande avec l'--project-nameoption, <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.

  3. Si vous exécutez la start-build-batch commande avec --idempotency-token cette option, un identifiant unique distinguant les 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, cela CodeBuild renvoie une erreur de non-concordance de paramètres.

  4. Si vous exécutez la start-build-batch commande avec l'--generate-cli-skeletonoption, JSON-formatted les données sont sorties dans le <json-file> fichier. 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, consultezExécutez une compilation (AWS CLI).

    Modifiez ce fichier pour ajouter tout remplacement de build et enregistrez vos résultats.

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

    L'buildBatchConfigOverrideobjet est une ProjectBuildBatchConfig structure qui contient les modifications de configuration de génération par lots pour cette génération.

    combineArtifacts

    Une valeur booléenne qui spécifie si les artefacts de génération pour la génération par lots doivent être combinés en un seul emplacement d'artefact.

    allowedComputeTypes

    Tableau de chaînes qui spécifient les types de calcul autorisés pour la construction par lots. Consultez les types de calcul de l'environnement de création 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.

  5. 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

  6. En cas de succès, la représentation JSON d'un BuildBatch objet apparaît dans la sortie de la console. Consultez la Syntaxe de StartBuildBatch réponse pour un exemple de ces données.