Plugins

Plugins

Lexique

Un plugin core est un service de base de la chaîne DSO. Un plugin external est un service facultatif. Un hook est un point de déclenchement au cycle de vie par étapes : pre, main, post. Tout plugin s'enregistre sur un hook à une étape donnée.

Principe

1. Le plugin s'enregistre sur le hook, par exemple gitlab sur createProject à l'étape main.
2. Le contrôleur déclenche le hook avec un payload.
3. Le plugin reçoit le payload et exécute ses opérations.
4. Le plugin renvoie un result au contrôleur.
5. Le contrôleur enregistre le result en base et s'arrête si le status est en erreur.

Modèles

Le modèle entries porte les arguments du contrôleur et un résultat par plugin. Le modèle result porte un status avec OK ou KO et un message. Si un module réutilise son propre payload, il renvoie le payload précédent pour ne pas l'écraser. Le plugin gère les erreurs des étapes précédentes.

La référence complète vit dans misc/plugins.md du dépôt.