Référence de la spécification de construction par Batch - AWS CodeBuild
lotbatch/build-graphbatch/build-listbatch/build-matrix

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 de la spécification de construction par Batch

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.

lotfast-fail

Facultatif. Spécifie le comportement de la génération par lots en cas d'échec d'une ou de plusieurs tâches de génération.

false

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

true

Toutes les versions en cours seront arrêtées lorsque l'une des tâches de génération échoue.

Par défaut, toutes les tâches de génération par lots s'exécutent avec les paramètres de génération tels queenvetphases, spécifié dans le fichier buildspec. Vous pouvez remplacer les paramètres de génération par défaut en spécifiant différents paramètres de générationenvvaleurs ou un fichier de spécification de construction différent dans lebatch/<batch-type>/buildspec  Paramètre .

Contenu du documentbatchvarie en fonction du type de génération par lot qui est spécifié. Les types de génération par lots possibles sont les suivants :

batch/build-graph

Définit ungénération d'un graphe. Un graphique de génération définit un ensemble de tâches qui dépendent d'autres tâches du lot. Pour plus d'informations, consultez Construire un graphe.

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

identificateur

Obligatoire. Identifiant de la tâche.

Buildspec

Facultatif. Chemin et 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. Une valeur booléenne qui indique si le débogage de session est activé pour cette génération par lot. Pour de plus amples informations sur le débogage de session, veuillez consulterAfficher une version en cours d'exécution dans le Gestionnaire de session.

false

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

true

Le débogage de session est activé.

dépend

Facultatif. Un ensemble 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 de calcul

Identificateur du type de calcul à utiliser pour la tâche. VoircomputeTypedansModes et types de calcul de l'environnement de créationpour connaître les valeurs possibles.

image

Identifiant de l'image à utiliser pour la tâche. VoirIdentificateur de l'imagedansImages Docker fournies par CodeBuildpour connaître les valeurs possibles.

mode privilégié

Une valeur booléenne qui indique s'il convient d'exécuter le démon Docker dans un conteneur Docker. Définis surtrueuniquement si le projet de génération est utilisé pour générer 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

Identificateur du type d'environnement à utiliser pour la tâche. VoirType d'environnementdansModes et types de calcul de l'environnement de créationpour connaître les valeurs possibles.

variables

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

ignore-échec

Facultatif. Valeur booléenne qui indique si un é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.

L'exemple suivant est celui d'une entrée buildspec du 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

batch/build-list

Définit unliste de construction. Une liste de génération permet de définir un certain nombre de tâches exécutées en parallèle. Pour plus d'informations, consultez Construire une liste.

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

identificateur

Obligatoire. Identifiant de la tâche.

Buildspec

Facultatif. Chemin et 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. Une valeur booléenne qui indique si le débogage de session est activé pour cette génération par lot. Pour de plus amples informations sur le débogage de session, veuillez consulterAfficher une version en cours d'exécution dans 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 de calcul

Identificateur du type de calcul à utiliser pour la tâche. VoircomputeTypedansModes et types de calcul de l'environnement de créationpour connaître les valeurs possibles.

image

Identifiant de l'image à utiliser pour la tâche. VoirIdentificateur de l'imagedansImages Docker fournies par CodeBuildpour connaître les valeurs possibles.

mode privilégié

Une valeur booléenne qui indique s'il convient d'exécuter le démon Docker dans un conteneur Docker. Définis surtrueuniquement si le projet de génération est utilisé pour générer 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

Identificateur du type d'environnement à utiliser pour la tâche. VoirType d'environnementdansModes et types de calcul de l'environnement de créationpour connaître les valeurs possibles.

variables

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

ignore-échec

Facultatif. Valeur booléenne qui indique si un é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.

L'exemple suivant est celui d'une entrée buildspec de liste de génération :

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

batch/build-matrix

Définit unmatrice de génération. Une matrice de génération définit les tâches avec différentes configurations exécutées en parallèle. CodeBuild crée une version distincte pour chaque combinaison de configuration possible. Pour plus d'informations, consultez 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 un é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 remplace toutes les tâches.

mode privilégié

Une valeur booléenne qui indique s'il convient d'exécuter le démon Docker dans un conteneur Docker. Définis surtrueuniquement si le projet de génération est utilisé pour générer 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

Identificateur du type d'environnement à utiliser pour la tâche. VoirType d'environnementdansModes et types de calcul de l'environnement de créationpour connaître les valeurs possibles.

dynamique

Les propriétés dynamiques définissent la matrice de génération.

Buildspec

Facultatif. Tableau contenant le chemin d'accès 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 de calcul

Tableau contenant les identificateurs des types de calcul à utiliser pour ces tâches. VoircomputeTypedansModes et types de calcul de l'environnement de créationpour connaître les valeurs possibles.

image

Tableau contenant les identificateurs des images à utiliser pour ces tâches. VoirIdentificateur de l'imagedansImages Docker fournies par CodeBuildpour connaître 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.

L'exemple suivant est celui d'une entrée buildspec de génération de matrice de génération :

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.