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
trueuniquement 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 estfalse. - 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
trueuniquement 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 estfalse. - 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
trueuniquement 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 estfalse. - 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.