Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md).
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.
# Démarrage d'un flux de travail exécuté automatiquement à l'aide de déclencheurs
Vous pouvez démarrer un CodeCatalyst flux de travail Amazon exécuté automatiquement à l'aide d'un déclencheur de flux de travail.
Un *déclencheur de flux* de travail, ou simplement un *déclencheur*, vous permet de démarrer automatiquement un flux de travail lorsque certains événements se produisent, comme un envoi de code. Vous souhaiterez peut-être configurer des déclencheurs pour éviter à vos développeurs de logiciels d'avoir à lancer des exécutions de flux de travail manuellement via la CodeCatalyst console.
Vous pouvez utiliser trois types de déclencheurs :
+ **Push** : un déclencheur de code push déclenche l'exécution d'un flux de travail chaque fois qu'un commit est envoyé.
+ **Demande** d'extraction : un déclencheur de demande d'extraction entraîne le démarrage d'un flux de travail chaque fois qu'une demande d'extraction est créée, révisée ou fermée.
+ **Planification** : un déclencheur de planification entraîne le démarrage d'un flux de travail selon un calendrier que vous définissez. Envisagez d'utiliser un déclencheur de planification pour exécuter des versions nocturnes de votre logiciel afin que les développeurs puissent travailler sur la dernière version le lendemain matin.
Vous pouvez utiliser les déclencheurs push, pull request et schedule seuls ou en combinaison dans le même flux de travail.
Les déclencheurs sont facultatifs : si vous n'en configurez aucun, vous ne pouvez démarrer un flux de travail que manuellement.
**Astuce**
Pour voir un déclencheur en action, lancez un projet avec un plan. La plupart des plans contiennent un flux de travail avec un déclencheur. Recherchez la `Trigger` propriété dans le fichier de définition du flux de travail du plan. Pour plus d'informations sur les modèles de présentation, consultez [Création d'un projet à l'aide d'un plan](projects-create.md#projects-create-console-template).
**Topics**
+ [Exemples : déclencheurs dans les flux de travail](workflows-add-trigger-examples.md)
+ [Directives d'utilisation pour les déclencheurs et les branches](workflows-add-trigger-considerations.md)
+ [Ajouter des déclencheurs aux flux de travail](workflows-add-trigger-add.md)
# Exemples : déclencheurs dans les flux de travail
Les exemples suivants montrent comment ajouter différents types de déclencheurs dans un fichier de définition de CodeCatalyst flux de travail Amazon.
Pour plus d'informations sur les déclencheurs, consultez [Démarrage d'un flux de travail exécuté automatiquement à l'aide de déclencheurs](workflows-add-trigger.md).
**Topics**
+ [Exemple : un simple déclencheur push à code](#workflows-add-trigger-examples-push-simple)
+ [Exemple : un simple déclencheur « push to main »](#workflows-add-trigger-examples-push-main)
+ [Exemple : un simple déclencheur de pull request](#workflows-add-trigger-examples-pull-simple)
+ [Exemple : un simple déclencheur de planification](#workflows-add-trigger-examples-schedule-simple)
+ [Exemple : un déclencheur avec un calendrier et des branches](#workflows-add-trigger-examples-schedule-branches)
+ [Exemple : un déclencheur avec un calendrier, un push et des branches](#workflows-add-trigger-examples-schedule-push-branches)
+ [Exemple : une gâchette avec une traction et des branches](#workflows-add-trigger-examples-pull-branches)
+ [Exemple : un déclencheur avec un pull, des branches et un événement « CLOSED »](#workflows-add-trigger-examples-push-pull-close)
+ [Exemple : un déclencheur avec un push, des branches et des fichiers](#workflows-add-trigger-examples-push-multi)
+ [Exemple : un déclencheur manuel](#workflows-add-trigger-examples-manual)
+ [Exemple : déclencheurs dans une configuration à CI/CD flux de travail multiples](#workflows-add-trigger-usecases)
## Exemple : un simple déclencheur push à code
L'exemple suivant montre un déclencheur qui lance l'exécution d'un flux de travail chaque fois que du code est *envoyé* à une branche de votre référentiel source.
Lorsque ce déclencheur est activé, CodeCatalyst lance un flux de travail exécuté à l'aide des fichiers de la branche vers laquelle vous *pointez* (c'est-à-dire la branche de destination).
Par exemple, si vous envoyez un commit à`main`, CodeCatalyst lance un flux de travail exécuté à l'aide du fichier de définition du flux de travail et d'autres fichiers source. `main`
Autre exemple, si vous envoyez un commit à`feature-branch-123`, CodeCatalyst lance un flux de travail exécuté à l'aide du fichier de définition du flux de travail et d'autres fichiers source. `feature-branch-123`
```
Triggers:
- Type: PUSH
```
**Note**
Si vous souhaitez qu'un flux de travail ne démarre que lorsque vous appuyez dessus`main`, consultez[Exemple : un simple déclencheur « push to main »](#workflows-add-trigger-examples-push-main).
## Exemple : un simple déclencheur « push to main »
L'exemple suivant montre un déclencheur qui lance l'exécution d'un flux de travail chaque fois que du code est transmis à la `main` branche (et *uniquement* à la `main` branche) de votre référentiel source.
```
Triggers:
- Type: PUSH
Branches:
- main
```
## Exemple : un simple déclencheur de pull request
L'exemple suivant montre un déclencheur qui lance l'exécution d'un flux de travail chaque fois qu'une pull request est créée ou révisée dans votre référentiel source.
Lorsque ce déclencheur est activé, CodeCatalyst lance un flux de travail exécuté à l'aide du fichier de définition du flux de travail et des autres fichiers source de la branche *d'*où vous effectuez l'extraction (c'est-à-dire la branche source).
Par exemple, si vous créez une pull request avec une branche source appelée `feature-123` et une branche de destination appelée`main`, CodeCatalyst lance un flux de travail exécuté à l'aide du fichier de définition du flux de travail et d'autres fichiers source. `feature-123`
```
Triggers:
- Type: PULLREQUEST
Events:
- OPEN
- REVISION
```
## Exemple : un simple déclencheur de planification
L'exemple suivant montre un déclencheur qui lance un flux de travail exécuté à minuit (UTC\$10) du lundi au vendredi.
Lorsque ce déclencheur est activé, CodeCatalyst lance une seule exécution de flux de travail pour chaque branche de votre référentiel source contenant un fichier de définition de flux de travail avec ce déclencheur.
Par exemple, si votre référentiel source comporte trois branches,, `main` `release-v1``feature-123`, et que chacune de ces branches contient un fichier de définition de flux de travail avec le déclencheur suivant, CodeCatalyst lance trois exécutions de flux de travail : une utilisant les fichiers dans`main`, une autre utilisant les fichiers dans `release-v1` et une autre utilisant les fichiers dans`feature-123`.
```
Triggers:
- Type: SCHEDULE
Expression: "0 0 ? * MON-FRI *"
```
Pour plus d'exemples d'expressions cron que vous pouvez utiliser dans la `Expression` propriété, consultez[Expression](workflow-reference.md#workflow.triggers.expression).
## Exemple : un déclencheur avec un calendrier et des branches
L'exemple suivant montre un déclencheur qui lance un flux de travail exécuté à 18h15 (UTC\$10) tous les jours.
Lorsque ce déclencheur est activé, CodeCatalyst lance un flux de travail à l'aide des fichiers de la `main` branche et lance des exécutions supplémentaires pour chaque branche commençant par`release-`.
Par exemple, si vous avez des branches nommées`main`, `release-v1``bugfix-1`, `bugfix-2` dans votre référentiel source, CodeCatalyst démarre deux exécutions de flux de travail : l'une utilisant les fichiers dans`main`, l'autre utilisant les fichiers dans`release-v1`. Il ne lance *pas* les exécutions de flux de travail pour les `bugfix-1` branches `bugfix-1` et.
```
Triggers:
- Type: SCHEDULE
Expression: "15 18 * * ? *"
Branches:
- main
- release\-.*
```
Pour plus d'exemples d'expressions cron que vous pouvez utiliser dans la `Expression` propriété, consultez[Expression](workflow-reference.md#workflow.triggers.expression).
## Exemple : un déclencheur avec un calendrier, un push et des branches
L'exemple suivant montre un déclencheur qui lance un flux de travail exécuté à minuit (UTC\$10) tous les jours, et chaque fois que le code est envoyé à la branche. `main`
Dans cet exemple :
+ L'exécution d'un flux de travail commence tous les jours à minuit. Le flux de travail exécuté utilise le fichier de définition du flux de travail et les autres fichiers source de la `main` branche.
+ Une exécution de flux de travail démarre également chaque fois que vous envoyez un commit à la `main` branche. Le flux de travail exécuté utilise le fichier de définition du flux de travail et les autres fichiers source de la branche de destination (`main`).
```
Triggers:
- Type: SCHEDULE
Expression: "0 0 * * ? *"
Branches:
- main
- Type: PUSH
Branches:
- main
```
Pour plus d'exemples d'expressions cron que vous pouvez utiliser dans la `Expression` propriété, consultez[Expression](workflow-reference.md#workflow.triggers.expression).
## Exemple : une gâchette avec une traction et des branches
L'exemple suivant montre un déclencheur qui lance l'exécution d'un flux de travail chaque fois que quelqu'un ouvre ou modifie une pull request avec une branche de destination appelée`main`. Bien que la branche spécifiée dans la `Triggers` configuration le soit`main`, le flux de travail exécuté utilisera le fichier de définition du flux de travail et les autres fichiers *source de la branche source* (qui est la branche dont vous *extrayez*).
```
Triggers:
- Type: PULLREQUEST
Branches:
- main
Events:
- OPEN
- REVISION
```
## Exemple : un déclencheur avec un pull, des branches et un événement « CLOSED »
L'exemple suivant montre un déclencheur qui lance l'exécution d'un flux de travail chaque fois qu'une pull request est fermée sur une branche commençant par`main`.
Dans cet exemple :
+ Lorsque vous fermez une pull request dont la branche de destination commence par`main`, l'exécution du flux de travail démarre automatiquement en utilisant le fichier de définition du flux de travail et les autres fichiers source de la branche source (désormais fermée).
+ Si vous avez configuré votre dépôt source pour supprimer automatiquement les branches après la fusion d'une pull request, ces branches n'auront jamais la possibilité d'entrer dans l'`CLOSED`état. Cela signifie que les branches fusionnées n'activeront pas le `CLOSED` déclencheur de pull request. Dans ce scénario, le seul moyen d'activer le `CLOSED` déclencheur est de fermer la pull request sans la fusionner.
```
Triggers:
- Type: PULLREQUEST
Branches:
- main.*
Events:
- CLOSED
```
## Exemple : un déclencheur avec un push, des branches et des fichiers
L'exemple suivant montre un déclencheur qui lance l'exécution d'un flux de travail chaque fois qu'une modification est apportée au `filename.txt` fichier, ou à tout autre fichier du `src` répertoire, sur la `main` branche.
Lorsque ce déclencheur est activé, CodeCatalyst lance un flux de travail exécuté à l'aide du fichier de définition du flux de travail et des autres fichiers source de la `main` branche.
```
Triggers:
- Type: PUSH
Branches:
- main
FilesChanged:
- filename.txt
- src\/.*
```
## Exemple : un déclencheur manuel
Pour configurer un déclencheur manuel, omettez la `Triggers` section dans le fichier de définition du flux de travail. Sans cette section, les utilisateurs sont obligés de démarrer le flux de travail manuellement en cliquant sur le bouton **Exécuter** de la CodeCatalyst console. Pour de plus amples informations, veuillez consulter [Démarrage manuel de l’exécution d’un flux de travail](workflows-manually-start.md).
## Exemple : déclencheurs dans une configuration à CI/CD flux de travail multiples
Cet exemple décrit comment configurer des déclencheurs lorsque vous souhaitez utiliser des CodeCatalyst flux de travail Amazon distincts pour l'intégration continue (CI) et le déploiement continu (CD).
Dans ce scénario, vous configurez deux flux de travail :
+ un **flux de travail CI** : ce flux de travail crée et teste votre application lorsqu'une pull request est créée ou révisée.
+ un **flux de travail sur CD** : ce flux de travail crée et déploie votre application lorsqu'une pull request est fusionnée.
Le fichier de définition du **flux de travail CI** ressemblerait à ceci :
```
Triggers:
- Type: PULLREQUEST
Branches:
- main
Events:
- OPEN
- REVISION
Actions:
BuildAction:
instructions-for-building-the-app
TestAction:
instructions-for-test-the-app
```
Le `Triggers` code indique de démarrer automatiquement un flux de travail chaque fois qu'un développeur de logiciel crée une pull request (ou en [modifie une](pull-requests-update.md)) demandant de fusionner sa branche de fonctionnalités avec la `main` branche. CodeCatalyst lance le flux de travail exécuté à l'aide du code source dans la branche source (qui est la branche des fonctionnalités).
Le fichier de définition du **flux de travail du CD** ressemblerait à ceci :
```
Triggers:
- Type: PUSH
Branches:
- main
Actions:
BuildAction:
instructions-for-building-the-app
DeployAction:
instructions-for-deploying-the-app
```
Le `Triggers` code indique de démarrer le flux de travail automatiquement lorsqu'une fusion a `main` lieu. CodeCatalyst lance l'exécution du flux de travail à l'aide du code source de la `main` branche.
# Directives d'utilisation pour les déclencheurs et les branches
Cette section décrit certaines des principales directives relatives à la configuration des CodeCatalyst déclencheurs Amazon incluant des succursales.
Pour plus d'informations sur les déclencheurs, consultez [Démarrage d'un flux de travail exécuté automatiquement à l'aide de déclencheurs](workflows-add-trigger.md).
+ **Règle 1 :** Pour les déclencheurs de requêtes push et pull, si vous souhaitez spécifier une branche, vous devez spécifier la branche de destination (ou « vers ») dans la configuration du déclencheur. Ne spécifiez jamais la branche source (ou « de »).
Dans l'exemple suivant, une commande push depuis n'importe quelle branche `main` active le flux de travail.
```
Triggers:
- Type: PUSH
Branches:
- main
```
Dans l'exemple suivant, une pull request provenant de n'importe quelle branche `main` active le flux de travail.
```
Triggers:
- Type: PULLREQUEST
Branches:
- main
Events:
- OPEN
- REVISION
```
+ **Règle 2 :** Pour les déclencheurs push, une fois le flux de travail activé, le flux de travail s'exécute à l'aide du fichier de définition du flux de travail et des fichiers source dans la branche de *destination*.
+ **Règle 3 :** Pour les déclencheurs de pull request, une fois le flux de travail activé, le flux de travail s'exécute à l'aide du fichier de définition du flux de travail et des fichiers *source de la branche source* (même si vous avez spécifié la branche de destination dans la configuration du déclencheur).
+ **Règle 4 :** Le même déclencheur dans une branche peut ne pas s'exécuter dans une autre branche.
Considérez le déclencheur suivant :
```
Triggers:
- Type: PUSH
Branches:
- main
```
Si le fichier de définition du flux de travail contenant ce déclencheur existe dans `main` et est cloné dans celui-ci`test`, le flux de travail ne démarrera jamais automatiquement en utilisant les fichiers dans `test` (bien que vous puissiez démarrer le flux de travail *manuellement* pour qu'il utilise les fichiers dans`test`). Consultez la **directive 2** pour comprendre pourquoi le flux de travail ne s'exécutera jamais automatiquement en utilisant les fichiers contenus dans`test`.
Tenez également compte du déclencheur de pull request suivant :
```
Triggers:
- Type: PULLREQUEST
Branches:
- main
Events:
- OPEN
- REVISION
```
Si le fichier de définition du flux de travail contenant ce déclencheur existe dans`main`, le flux de travail ne s'exécutera jamais à l'aide des fichiers contenus dans`main`. (Toutefois, si vous créez une `test` branche à partir de`main`, le flux de travail s'exécutera en utilisant les fichiers contenus dans`test`.) Consultez **la directive 3** pour comprendre pourquoi.
# Ajouter des déclencheurs aux flux de travail
Suivez les instructions suivantes pour ajouter un déclencheur push, pull ou de planification à votre CodeCatalyst flux de travail Amazon.
Pour plus d'informations sur les déclencheurs, consultez [Démarrage d'un flux de travail exécuté automatiquement à l'aide de déclencheurs](workflows-add-trigger.md).
------
#### [ Visual ]
**Pour ajouter un déclencheur (éditeur visuel)**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez **Modifier**.
1. Choisissez **Visual**.
1. Dans le diagramme du flux de travail, sélectionnez la case **Source** et **déclencheurs**.
1. Dans le volet de configuration, choisissez **Ajouter un déclencheur**.
1. Dans la boîte de dialogue **Ajouter un déclencheur**, entrez les informations dans les champs, comme suit.
**Type de déclencheur**
Spécifiez le type de déclencheur. Vous pouvez utiliser l'une des valeurs suivantes :
+ **Push** (éditeur visuel) ou `PUSH` (éditeur YAML)
Un déclencheur push lance l'exécution d'un flux de travail lorsqu'une modification est transmise à votre référentiel source. Le flux de travail exécuté utilisera les fichiers de la branche *vers* laquelle vous transférez (c'est-à-dire la branche de destination).
+ **Pull request** (éditeur visuel) ou `PULLREQUEST` (éditeur YAML)
Un déclencheur de pull request lance un flux de travail lorsqu'une pull request est ouverte, mise à jour ou fermée dans votre référentiel source. *Le flux de travail exécuté utilisera les fichiers de la branche d'où vous les extrayez (c'est-à-dire la branche source).*
+ **Calendrier** (éditeur visuel) ou `SCHEDULE` (éditeur YAML)
Un déclencheur de planification lance des exécutions de flux de travail selon un calendrier défini par une expression cron que vous spécifiez. Un flux de travail distinct démarrera pour chaque branche de votre référentiel source à l'aide des fichiers de la branche. (Pour limiter les branches sur lesquelles le déclencheur est activé, utilisez le champ **Branches** (éditeur visuel) ou la `Branches` propriété (éditeur YAML).)
Lorsque vous configurez un déclencheur de planification, suivez les instructions suivantes :
+ N'utilisez qu'un seul déclencheur de planification par flux de travail.
+ Si vous avez défini plusieurs flux de travail dans votre CodeCatalyst espace, nous vous recommandons de ne pas en planifier plus de 10 pour qu'ils démarrent simultanément.
+ Assurez-vous de configurer l'expression cron du déclencheur avec un délai suffisant entre les exécutions. Pour de plus amples informations, veuillez consulter [Expression](workflow-reference.md#workflow.triggers.expression).
Pour obtenir des exemples, consultez [Exemples : déclencheurs dans les flux de travail](workflows-add-trigger-examples.md).
**Événements pour la pull request**
Ce champ n'apparaît que si vous avez sélectionné le type de déclencheur de **demande Pull**.
Spécifiez le type d'événements de pull request qui lanceront l'exécution d'un flux de travail. Les valeurs valides sont les suivantes :
+ **Une pull request est créée** (éditeur visuel) ou `OPEN` (éditeur YAML)
L'exécution du flux de travail démarre lorsqu'une pull request est créée.
+ La **pull request est fermée** (éditeur visuel) ou `CLOSED` (éditeur YAML)
L'exécution du flux de travail démarre lorsqu'une pull request est fermée. Le comportement de l'`CLOSED`événement est délicat et il est préférable de le comprendre à l'aide d'un exemple. Pour plus d’informations, consultez [Exemple : un déclencheur avec un pull, des branches et un événement « CLOSED »](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-pull-close).
+ **Une nouvelle révision est apportée à la pull request** (éditeur visuel) ou `REVISION` (éditeur YAML)
L'exécution du flux de travail démarre lorsqu'une révision d'une pull request est créée. La première révision est créée lors de la création de la pull request. Ensuite, une nouvelle révision est créée chaque fois que quelqu'un envoie un nouveau commit vers la branche source spécifiée dans la pull request. Si vous incluez l'`REVISION`événement dans votre déclencheur de pull request, vous pouvez l'`OPEN`omettre, car il s'`REVISION`agit d'un sur-ensemble de. `OPEN`
Vous pouvez spécifier plusieurs événements dans le même déclencheur de pull request.
Pour obtenir des exemples, consultez [Exemples : déclencheurs dans les flux de travail](workflows-add-trigger-examples.md).
**Schedule**
Ce champ n'apparaît que si vous avez sélectionné le type de déclencheur **Schedule**.
Spécifiez l'expression cron qui décrit le moment où vous souhaitez que votre flux de travail planifié ait lieu.
Les expressions Cron CodeCatalyst utilisent la syntaxe à six champs suivante, où chaque champ est séparé par un espace :
*minutes* *hours* *days-of-month* *month* *days-of-week* *year*
**Exemples d'expressions cron**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/workflows-add-trigger-add.html)
Lorsque vous spécifiez des expressions cron dans CodeCatalyst, assurez-vous de suivre les instructions suivantes :
+ Spécifiez une seule expression cron par `SCHEDULE` déclencheur.
+ Mettez l'expression cron entre guillemets (`"`) dans l'éditeur YAML.
+ Spécifiez l'heure en temps universel coordonné (UTC). Les autres fuseaux horaires ne sont pas pris en charge.
+ Configurez au moins 30 minutes entre les exécutions. Une cadence plus rapide n'est pas prise en charge.
+ Spécifiez le *days-of-week* champ *days-of-month* ou, mais pas les deux. Si vous spécifiez une valeur ou un astérisque (`*`) dans l'un des champs, vous devez utiliser un point d'interrogation (`?`) dans l'autre. L'astérisque signifie « tout » et le point d'interrogation signifie « tout ».
Pour plus d'exemples d'expressions cron et des informations sur les caractères génériques tels que`?`, et `*``L`, consultez la [référence des expressions Cron](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html) dans le guide de l'utilisateur *Amazon EventBridge *. Les expressions Cron entrent EventBridge et CodeCatalyst fonctionnent exactement de la même manière.
Pour des exemples de déclencheurs de planification, voir[Exemples : déclencheurs dans les flux de travail](workflows-add-trigger-examples.md).
**Branches** et **modèle de branches**
(Facultatif)
Spécifiez les branches de votre référentiel source que le déclencheur surveille afin de savoir quand démarrer une exécution de flux de travail. Vous pouvez utiliser des modèles regex pour définir les noms de vos branches. Par exemple, utilisez `main.*` pour faire correspondre toutes les branches commençant par`main`.
Les branches à spécifier sont différentes selon le type de déclencheur :
+ Pour un déclencheur, spécifiez les branches *vers* lesquelles vous poussez, c'est-à-dire les branches de *destination*. Une exécution de flux de travail démarrera par branche correspondante, en utilisant les fichiers de la branche correspondante.
Exemples : `main.*`, `mainline`
+ Pour un déclencheur de pull request, spécifiez les branches *vers* lesquelles vous pointez, c'est-à-dire les branches de *destination*. Une exécution de flux de travail démarrera par branche correspondante, en utilisant le fichier de définition du flux de travail et les fichiers **source de la branche source** (et *non* de la branche correspondante).
Exemples :`main.*`,`mainline`, `v1\-.*` (correspond aux branches commençant par`v1-`)
+ Pour un déclencheur de planification, spécifiez les branches contenant les fichiers que vous souhaitez que votre exécution planifiée utilise. Une exécution de flux de travail démarrera par branche correspondante, en utilisant le fichier de définition du flux de travail et les fichiers source de la branche correspondante.
Exemples : `main.*`, `version\-1\.0`
**Note**
Si vous *ne spécifiez pas* de branches, le déclencheur surveille toutes les branches de votre référentiel source et lancera l'exécution d'un flux de travail à l'aide du fichier de définition du flux de travail et des fichiers source dans :
La branche vers laquelle vous poussez (*pour* les déclencheurs). Pour de plus amples informations, veuillez consulter [Exemple : un simple déclencheur push à code](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-simple).
La branche d'où vous effectuez *l'*extraction (pour les déclencheurs de pull request). Pour de plus amples informations, veuillez consulter [Exemple : un simple déclencheur de pull request](workflows-add-trigger-examples.md#workflows-add-trigger-examples-pull-simple).
Toutes les succursales (pour les déclencheurs de calendrier). Une exécution de flux de travail démarrera par branche de votre référentiel source. Pour de plus amples informations, veuillez consulter [Exemple : un simple déclencheur de planification](workflows-add-trigger-examples.md#workflows-add-trigger-examples-schedule-simple).
Pour plus d'informations sur les branches et les déclencheurs, consultez[Directives d'utilisation pour les déclencheurs et les branches](workflows-add-trigger-considerations.md).
Pour obtenir plus d’exemples, consultez [Exemples : déclencheurs dans les flux de travail](workflows-add-trigger-examples.md).
**Fichiers modifiés**
Ce champ n'apparaît que si vous avez sélectionné le type de déclencheur de **demande **Push** ou Pull**.
Spécifiez les fichiers ou les dossiers de votre référentiel source que le déclencheur surveille afin de savoir quand démarrer une exécution de flux de travail. Vous pouvez utiliser des expressions régulières pour faire correspondre les noms de fichiers ou les chemins.
Pour obtenir des exemples, consultez [Exemples : déclencheurs dans les flux de travail](workflows-add-trigger-examples.md).
1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.
1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.
------
#### [ YAML ]
**Pour ajouter un déclencheur (éditeur YAML)**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez **Modifier**.
1. Choisissez **YAML.**
1. Ajoutez une `Triggers` section et les propriétés sous-jacentes en utilisant l'exemple suivant comme guide. Pour en savoir plus, consultez [Triggers](workflow-reference.md#triggers-reference) dans la rubrique [Définition du flux de travail YAML](workflow-reference.md).
Un déclencheur de code push peut ressembler à ceci :
```
Triggers:
- Type: PUSH
Branches:
- main
```
Un déclencheur de pull request peut ressembler à ceci :
```
Triggers:
- Type: PULLREQUEST
Branches:
- main.*
Events:
- OPEN
- REVISION
- CLOSED
```
Un déclencheur de planification peut ressembler à ceci :
```
Triggers:
- Type: SCHEDULE
Branches:
- main.*
# Run the workflow at 1:15 am (UTC+0) every Friday until the end of 2023
Expression: "15 1 ? * FRI 2022-2023"
```
Pour plus d'exemples d'expressions cron que vous pouvez utiliser dans la `Expression` propriété, consultez[Expression](workflow-reference.md#workflow.triggers.expression).
Pour plus d'exemples de déclencheurs push, pull request et schedule, consultez[Exemples : déclencheurs dans les flux de travail](workflows-add-trigger-examples.md).
1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.
1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.
------