

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.

# Le déclencheur AWS CodeBuild se construit automatiquement
<a name="build-triggers"></a>

Vous pouvez créer un déclencheur sur un projet pour planifier une génération une fois toutes les heures, tous les jours ou toutes les semaines. Vous pouvez également modifier un déclencheur pour utiliser une règle personnalisée avec une expression Amazon CloudWatch Cron. Par exemple, à l'aide d'une expression cron, vous pouvez planifier une génération à une heure précise chaque jour de la semaine. Pour plus d'informations sur la création et la modification de déclencheurs, reportez-vous [Création de AWS CodeBuild déclencheurs](#trigger-create) aux sections et[Modifier les AWS CodeBuild déclencheurs](triggers-edit.md).

**Topics**
+ [Création de AWS CodeBuild déclencheurs](#trigger-create)
+ [Modifier les AWS CodeBuild déclencheurs](triggers-edit.md)

## Création de AWS CodeBuild déclencheurs
<a name="trigger-create"></a>

Vous pouvez créer un déclencheur sur un projet pour planifier une génération une fois toutes les heures, tous les jours ou toutes les semaines. Vous pouvez également créer un déclencheur à l'aide d'une règle personnalisée avec une expression Amazon CloudWatch cron. Par exemple, à l'aide d'une expression cron, vous pouvez planifier une génération à une heure précise chaque jour de la semaine. 

**Note**  
Il n'est pas possible de démarrer une génération par lots à partir d'un déclencheur de génération, d'un EventBridge événement Amazon ou d'une AWS Step Functions tâche.

**Topics**
+ [Création de AWS CodeBuild déclencheurs (console)](#trigger-create-console)
+ [Création de AWS CodeBuild déclencheurs par programmation](#trigger-create-code)

### Création de AWS CodeBuild déclencheurs (console)
<a name="trigger-create-console"></a>

Utilisez la procédure suivante pour créer des déclencheurs à l'aide du AWS Management Console.

**Pour créer un déclencheur** 

1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1. Dans le volet de navigation, choisissez **Projets de génération**.

1. Sélectionnez le lien pour le projet de génération pour lequel vous voulez ajouter un déclencheur, puis choisissez l'onglet **Build triggers (Déclencheurs de génération)**.
**Note**  
Par défaut, les 100 projets de construction les plus récents sont affichés. Pour afficher plus de projets de génération, choisissez l'icône en forme d'engrenage, puis choisissez une autre valeur pour **Projects per page (Projets par page)** ou utilisez les flèches avant et arrière.

1. Choisissez **Create trigger**.

1. Saisissez un nom dans **Trigger name (Nom du déclencheur)**.

1. Dans la liste déroulante **Fréquence**, choisissez la fréquence de votre déclencheur. Si vous voulez créer une fréquence à l'aide d'une expression cron, choisissez **Custom (Personnalisé)**.

1. Spécifiez les paramètres de la fréquence de votre déclencheur. Vous pouvez saisir les tout premiers caractères de vos sélections dans la zone de texte pour filtrer les éléments du menu déroulant.
**Note**  
 Les heures et minutes de début sont basées sur zéro. La minute de début est un nombre compris entre zéro et 59. L'heure de début est un nombre compris entre zéro et 23. Par exemple, un déclencheur quotidien qui commence tous les jours à 12 h 15 a une heure de début de 12 heures et une minute de début de 15. Un déclencheur quotidien qui commence tous les jours à minuit a une heure de début de zéro et une minute de début de zéro. Un déclencheur quotidien qui commence tous les jours à 23 h 59 a une heure de début de 23 et une minute de départ de 59.   
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/build-triggers.html)

1.  Sélectionnez ** Enable this trigger (Activer ce déclencheur)**. 

1.  (Facultatif) Développez **Advanced section (Section avancée)**. Dans **Source version (Version de la source)**, saisissez une version de votre code source. 
   +  Pour Amazon S3, entrez l'ID de version qui correspond à la version de l'artefact d'entrée que vous souhaitez créer. Si le champ **Version de la source** reste vide, la dernière version est utilisée. 
   +  Pour AWS CodeCommit, saisissez un ID de validation. Si **Version de la source** est vide, l'ID de validation HEAD de la branche par défaut est utilisé. 
   + Pour GitHub ou GitHub Enterprise, saisissez un identifiant de validation, un identifiant de pull request, un nom de branche ou un nom de balise correspondant à la version du code source que vous souhaitez créer. Si vous spécifiez un ID de demande d'extraction, il doit utiliser le format `pr/pull-request-ID` (par exemple, `pr/25`). Si vous spécifiez un nom de branche, l'ID de validation HEAD de la branche est utilisé. Si **Version source** est vide, l'ID de validation HEAD de la branche par défaut est utilisé.
   + Pour Bitbucket, entrez un ID de validation, un nom de branche ou un nom de balise qui correspond à la version du code source à générer. Si vous spécifiez un nom de branche, l'ID de validation HEAD de la branche est utilisé. Si **Version source** est vide, l'ID de validation HEAD de la branche par défaut est utilisé.

1. (Facultatif) Spécifiez un délai compris entre 5 minutes et 2 160 minutes (36 heures). Cette valeur indique la durée des AWS CodeBuild tentatives de compilation avant qu'elle ne s'arrête. Si les **Hours (heures)** et **Minutes** sont laissées vides, la valeur de délai d'expiration par défaut spécifiée dans le projet est utilisée. 

1. Choisissez **Create trigger**.

### Création de AWS CodeBuild déclencheurs par programmation
<a name="trigger-create-code"></a>

CodeBuild utilise les EventBridge règles Amazon pour créer des déclencheurs. Vous pouvez utiliser l' EventBridge API pour créer par programmation des déclencheurs de build pour vos CodeBuild projets. Consultez le [manuel Amazon EventBridge API Reference](https://docs.aws.amazon.com/eventbridge/latest/APIReference/) pour plus d'informations.

# Modifier les AWS CodeBuild déclencheurs
<a name="triggers-edit"></a>

Vous pouvez modifier un déclencheur sur un projet pour planifier une génération une fois toutes les heures, tous les jours ou toutes les semaines. Vous pouvez également modifier un déclencheur pour utiliser une règle personnalisée avec une expression Amazon CloudWatch Cron. Par exemple, à l'aide d'une expression cron, vous pouvez planifier une génération à une heure précise chaque jour de la semaine. Pour plus d'informations sur la création d'un déclencheur, consultez [Création de AWS CodeBuild déclencheurs](build-triggers.md#trigger-create).

**Topics**
+ [Modifier les AWS CodeBuild déclencheurs (console)](#triggers-edit-console)
+ [Modifier les AWS CodeBuild déclencheurs par programmation](#trigger-edit-code)

## Modifier les AWS CodeBuild déclencheurs (console)
<a name="triggers-edit-console"></a>

Utilisez la procédure suivante pour modifier les déclencheurs à l'aide du AWS Management Console.

**Pour modifier un déclencheur**

1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1. Dans le volet de navigation, choisissez **Projets de génération**.

1. Sélectionnez le lien du projet de génération à modifier, puis choisissez l'onglet **Build triggers (Déclencheurs de génération)**.
**Note**  
Par défaut, les 100 projets de construction les plus récents sont affichés. Pour afficher plus de projets de génération, choisissez l'icône en forme d'engrenage, puis choisissez une autre valeur pour **Projects per page (Projets par page)** ou utilisez les flèches avant et arrière.

1. Sélectionnez la case d'option en regard du déclencheur à modifier, puis choisissez **Edit (Modifier)**.

1. Dans la liste déroulante **Fréquence**, choisissez la fréquence de votre déclencheur. Si vous voulez créer une fréquence à l'aide d'une expression cron, choisissez **Custom (Personnalisé)**.

1. Spécifiez les paramètres de la fréquence de votre déclencheur. Vous pouvez saisir les tout premiers caractères de vos sélections dans la zone de texte pour filtrer les éléments du menu déroulant.
**Note**  
 Les heures et minutes de début sont basées sur zéro. La minute de début est un nombre compris entre zéro et 59. L'heure de début est un nombre compris entre zéro et 23. Par exemple, un déclencheur quotidien qui commence tous les jours à 12 h 15 a une heure de début de 12 heures et une minute de début de 15. Un déclencheur quotidien qui commence tous les jours à minuit a une heure de début de zéro et une minute de début de zéro. Un déclencheur quotidien qui commence tous les jours à 23 h 59 a une heure de début de 23 heures et une minute de départ de 59.   
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/triggers-edit.html)

1.  Sélectionnez ** Enable this trigger (Activer ce déclencheur)**. 

**Note**  
Vous pouvez utiliser la CloudWatch console Amazon [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)pour modifier la version de la source, le délai d'expiration et d'autres options qui ne sont pas disponibles dans AWS CodeBuild.

## Modifier les AWS CodeBuild déclencheurs par programmation
<a name="trigger-edit-code"></a>

CodeBuild utilise les EventBridge règles d'Amazon pour créer des déclencheurs. Vous pouvez utiliser l' EventBridge API pour modifier par programmation les déclencheurs de génération de vos CodeBuild projets. Consultez le [manuel Amazon EventBridge API Reference](https://docs.aws.amazon.com/eventbridge/latest/APIReference/) pour plus d'informations.