Explorer les événements

3 minutes

Les événements sont implémentés par la clause on dans une définition de workflow.

Il existe plusieurs types d’événements qui peuvent déclencher des workflows.

Événements planifiés

Avec ce type de déclencheur, une planification cron doit être fournie.

on:
    schedule:

        - cron: '0 8-17 * * 1-5'

Les planifications cron sont basées sur cinq valeurs :

Minute (0 - 59)
Heure (0 - 23)
Jour du mois (1 - 31)
Mois (1 - 12)
Jour de la semaine (0 - 6)

Les alias pour les mois sont JAN-DEC et pour les jours de la semaine SUN-SAT.

Un caractère générique signifie n’importe lequel. (* est une valeur spéciale en YAML, donc la chaîne cron devra être placée entre guillemets simples.)

Ainsi, dans l’exemple ci-dessus, la planification serait de 8 à 17 heures, du lundi au vendredi.

Événements de code

Les événements de code déclenchent la plupart des actions. Cela se passe lorsqu’un événement digne d’intérêt se produit dans le dépôt.

on:
    pull_request

L’événement ci-dessus se déclenche lors d’une demande de tirage (pull request).

on:
    [push, pull_request]

L’événement ci-dessus se déclenche lors d’une poussée (push) ou d’une demande de tirage (pull request).

on:
    pull_request:
        branches:

            - develop

L’événement montre comment être précis sur la section de code qui vous intéresse.

Ici, il se déclenche quand une demande de tirage se produit dans la branche develop.

Événements manuels

Un seul événement est utilisé pour déclencher manuellement les exécutions de workflow. Vous devez utiliser l’événement workflow_dispatch.

Votre workflow doit se trouver dans la branche par défaut du dépôt.

Événements de webhook

Les workflows peuvent être exécutés lorsqu’un webhook GitHub est appelé.

on:
    gollum

Cet événement se déclenche quand une personne met à jour (ou crée d’abord) une page Wiki.

Événements externes

Les événements peuvent être sur repository_dispatch. Cela permet aux événements de se déclencher à partir de systèmes externes.