View a markdown version of this page

Référence des spécifications de construction par lots - 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.

Référence des spécifications de construction par lots

Cette rubrique contient la référence buildspec pour les propriétés de génération par lots.

lot

Mappage facultatif. Les paramètres de génération par lots pour le projet.

échec rapide ou par lots

Facultatif. Spécifie le comportement de la génération par lots lorsqu'une ou plusieurs tâches de génération échouent.

false

La valeur par défaut. Toutes les versions en cours d'exécution seront terminées.

true

Toutes les versions en cours d'exécution seront arrêtées en cas d'échec de l'une des tâches de génération.

Par défaut, toutes les tâches de génération par lots sont exécutées avec les paramètres de génération tels que env etphases, spécifiés dans le fichier buildspec. Vous pouvez remplacer les paramètres de génération par défaut en spécifiant des env valeurs différentes ou un fichier buildspec différent dans le paramètre. batch/<batch-type>/buildspec

Le contenu de la batch propriété varie en fonction du type de génération par lots spécifié. Les types de construction par lots possibles sont les suivants :

batch/build-graphique

Définit un graphe de construction. Un graphe de génération définit un ensemble de tâches qui dépendent des autres tâches du lot. Pour de plus amples informations, veuillez consulter Créer un graphique.

Cet élément contient un tableau de tâches de création. Chaque tâche de génération contient les propriétés suivantes.

identifiant

Obligatoire. Identifiant de la tâche.

spécifications de construction

Facultatif. Le chemin et le nom du fichier buildspec à utiliser pour cette tâche. Si ce paramètre n'est pas spécifié, le fichier buildspec actuel est utilisé.

session de débogage

Facultatif. Valeur booléenne qui indique si le débogage de session est activé pour cette génération par lots. Pour plus d'informations sur le débogage de session, consultezDéboguer les builds avec le gestionnaire de session.

false

Le débogage de session est désactivé.

true

Le débogage de session est activé.

dépendre

Facultatif. Tableau d'identificateurs de tâches dont dépend cette tâche. Cette tâche ne sera pas exécutée tant que ces tâches ne seront pas terminées.

env

Facultatif. L'environnement de génération remplace la tâche. Il peut contenir les propriétés suivantes :

type d'ordinateur

Identifiant du type de calcul à utiliser pour la tâche. Voir ComputeType dans Modes et types de calcul de l'environnement de création pour les valeurs possibles.

flotte

Identifiant de la flotte à utiliser pour la tâche. Pour plus d’informations, consultez Exécutez des builds sur des flottes à capacité réservée.

image

Identifiant de l'image à utiliser pour la tâche. Voir Identifiant de l'image dans Images Docker fournies par CodeBuild pour les valeurs possibles.

mode privilégié

Valeur booléenne qui indique s'il faut exécuter le démon Docker dans un conteneur Docker. Défini sur true uniquement si le projet de génération est utilisé pour créer des images Docker. À défaut, une génération qui tente d'interagir avec le démon Docker échoue. Le paramètre par défaut est false.

type

Identifiant du type d'environnement à utiliser pour la tâche. Consultez la section Type d'environnement Modes et types de calcul de l'environnement de création pour connaître les valeurs possibles.

variables

Les variables d'environnement qui seront présentes dans l'environnement de génération. Pour plus d’informations, consultez env/variables.

Note

Notez que le type de calcul et la flotte ne peuvent pas être fournis dans le même identifiant d'une seule version.

ignore-échec

Facultatif. Valeur booléenne qui indique si l'échec de cette tâche de génération peut être ignoré.

false

La valeur par défaut. Si cette tâche de génération échoue, la génération par lots échouera.

true

Si cette tâche de génération échoue, la génération par lots peut toujours réussir.

Voici un exemple d'entrée buildspec d'un graphe de génération :

batch: fast-fail: false build-graph: - identifier: build1 env: variables: BUILD_ID: build1 ignore-failure: false - identifier: build2 buildspec: build2.yml env: variables: BUILD_ID: build2 depend-on: - build1 - identifier: build3 env: variables: BUILD_ID: build3 depend-on: - build2 - identifier: build4 env: compute-type: ARM_LAMBDA_1GB - identifier: build5 env: fleet: fleet_name

batch/build-liste

Définit une liste de construction. Une liste de construction est utilisée pour définir un certain nombre de tâches qui s'exécutent en parallèle. Pour de plus amples informations, veuillez consulter Créer une liste.

Cet élément contient un tableau de tâches de création. Chaque tâche de génération contient les propriétés suivantes.

identifiant

Obligatoire. Identifiant de la tâche.

spécifications de construction

Facultatif. Le chemin et le nom du fichier buildspec à utiliser pour cette tâche. Si ce paramètre n'est pas spécifié, le fichier buildspec actuel est utilisé.

session de débogage

Facultatif. Valeur booléenne qui indique si le débogage de session est activé pour cette génération par lots. Pour plus d'informations sur le débogage de session, consultezDéboguer les builds avec le gestionnaire de session.

false

Le débogage de session est désactivé.

true

Le débogage de session est activé.

env

Facultatif. L'environnement de génération remplace la tâche. Il peut contenir les propriétés suivantes :

type d'ordinateur

Identifiant du type de calcul à utiliser pour la tâche. Voir ComputeType dans Modes et types de calcul de l'environnement de création pour les valeurs possibles.

flotte

Identifiant de la flotte à utiliser pour la tâche. Pour plus d’informations, consultez Exécutez des builds sur des flottes à capacité réservée.

image

Identifiant de l'image à utiliser pour la tâche. Voir Identifiant de l'image dans Images Docker fournies par CodeBuild pour les valeurs possibles.

mode privilégié

Valeur booléenne qui indique s'il faut exécuter le démon Docker dans un conteneur Docker. Défini sur true uniquement si le projet de génération est utilisé pour créer des images Docker. À défaut, une génération qui tente d'interagir avec le démon Docker échoue. Le paramètre par défaut est false.

type

Identifiant du type d'environnement à utiliser pour la tâche. Consultez la section Type d'environnement Modes et types de calcul de l'environnement de création pour connaître les valeurs possibles.

variables

Les variables d'environnement qui seront présentes dans l'environnement de génération. Pour plus d’informations, consultez env/variables.

Note

Notez que le type de calcul et la flotte ne peuvent pas être fournis dans le même identifiant d'une seule version.

ignore-échec

Facultatif. Valeur booléenne qui indique si l'échec de cette tâche de génération peut être ignoré.

false

La valeur par défaut. Si cette tâche de génération échoue, la génération par lots échouera.

true

Si cette tâche de génération échoue, la génération par lots peut toujours réussir.

Voici un exemple d'entrée buildspec de liste de construction :

batch: fast-fail: false build-list: - identifier: build1 env: variables: BUILD_ID: build1 ignore-failure: false - identifier: build2 buildspec: build2.yml env: variables: BUILD_ID: build2 ignore-failure: true - identifier: build3 env: compute-type: ARM_LAMBDA_1GB - identifier: build4 env: fleet: fleet_name - identifier: build5 env: compute-type: GENERAL_LINUX_XLAGRE

batch/build-matrice

Définit une matrice de construction. Une matrice de génération définit des tâches avec différentes configurations qui s'exécutent en parallèle. CodeBuild crée une version distincte pour chaque combinaison de configuration possible. Pour de plus amples informations, veuillez consulter Construire une matrice.

statique

Les propriétés statiques s'appliquent à toutes les tâches de génération.

ignore-échec

Facultatif. Valeur booléenne qui indique si l'échec de cette tâche de génération peut être ignoré.

false

La valeur par défaut. Si cette tâche de génération échoue, la génération par lots échouera.

true

Si cette tâche de génération échoue, la génération par lots peut toujours réussir.

env

Facultatif. L'environnement de génération prévaut pour toutes les tâches.

mode privilégié

Valeur booléenne qui indique s'il faut exécuter le démon Docker dans un conteneur Docker. Défini sur true uniquement si le projet de génération est utilisé pour créer des images Docker. À défaut, une génération qui tente d'interagir avec le démon Docker échoue. Le paramètre par défaut est false.

type

Identifiant du type d'environnement à utiliser pour la tâche. Consultez la section Type d'environnement Modes et types de calcul de l'environnement de création pour connaître les valeurs possibles.

dynamique

Les propriétés dynamiques définissent la matrice de construction.

spécifications de construction

Facultatif. Tableau contenant le chemin et les noms de fichiers des fichiers buildspec à utiliser pour ces tâches. Si ce paramètre n'est pas spécifié, le fichier buildspec actuel est utilisé.

env

Facultatif. L'environnement de génération remplace ces tâches.

type d'ordinateur

Tableau contenant les identifiants des types de calcul à utiliser pour ces tâches. Voir ComputeType dans Modes et types de calcul de l'environnement de création pour les valeurs possibles.

image

Tableau contenant les identifiants des images à utiliser pour ces tâches. Voir Identifiant de l'image Images Docker fournies par CodeBuild pour les valeurs possibles.

variables

Tableau contenant les variables d'environnement qui seront présentes dans les environnements de génération pour ces tâches. Pour plus d’informations, consultez env/variables.

Voici un exemple d'entrée buildspec de matrice de construction :

batch: build-matrix: static: ignore-failure: false dynamic: buildspec: - matrix1.yml - matrix2.yml env: variables: MY_VAR: - VALUE1 - VALUE2 - VALUE3

Pour de plus amples informations, veuillez consulter Construire une matrice.

batch/build-fanout

Définit un fanout de build. Un fanout de build est utilisé pour définir une tâche divisée en plusieurs builds exécutés en parallèle. Pour de plus amples informations, veuillez consulter Exécuter des tests parallèles dans des builds par lots.

Cet élément contient une tâche de génération qui peut être divisée en plusieurs versions. La build-fanout section contient les propriétés suivantes.

parallélisme

Obligatoire. Le nombre de versions qui exécuteront des tests en parallèle.

ignore-échec

Facultatif. Valeur booléenne qui indique si l'échec de l'une des tâches de génération de fanout peut être ignoré. Cette valeur d'ignore-failure sera appliquée à toutes les versions de fanout.

false

La valeur par défaut. Si une tâche de génération de fanout échoue, la génération par lots échouera.

true

Si une tâche de génération de fanout échoue, la génération par lots peut toujours réussir.

Voici un exemple d'entrée buildspec de build fanout :

version: 0.2 batch: fast-fail: false build-fanout: parallelism: 5 ignore-failure: false phases: install: commands: - npm install build: commands: - mkdir -p test-results - cd test-results - | codebuild-tests-run \ --test-command 'npx jest --runInBand --coverage' \ --files-search "codebuild-glob-search '**/test/**/*.test.js'" \ --sharding-strategy 'equal-distribution'

Pour plus d'informations, consultez Créez un fanout et Utilisez la commande CLI codebuild-tests-run.