Intégration GitLab ZapierAutomatiser GitLab avec Zapier.
L'intégration GitLab Zapier compte 11 déclencheurs, 8 actions et 3 recherches. Neuf déclencheurs sont instantanés : un ticket ouvert ou un commentaire de revue part vers ton Zap sans attendre, même sur le plan gratuit. Voici ce que fait chaque opération, et où elle coince.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Ce que l'intégration GitLab Zapier fait vraiment
L'intégration GitLab Zapier relie tes projets GitLab à Zapier. Un événement dans un dépôt (un ticket, une merge request, un commentaire, un job de CI) lance alors une suite d'étapes, sans clic humain. Zapier appelle cette suite un Zap : un événement de départ, puis une ou plusieurs étapes qui s'exécutent à chaque fois que cet événement se reproduit.
Dans une agence web ou une ESN, un premier montage utile consiste à mettre un ticket en route. New Group Issue Event surveille tous les projets d'un groupe et Create Branch prépare la branche dès qu'un ticket apparaît : le développeur qui le prend n'a plus qu'à s'y placer.
Deuxième résultat type, un suivi de revue qui se tient tout seul. Merge Request Review Request repère qu'on te demande une relecture, et Add Note to Merge Request laisse un mot sur la merge request pour signaler que c'est noté.
Troisième résultat, une trace écrite des incidents de CI. New Job Event lance le Zap sur un job de pipeline, Create Issue ouvre le ticket dans le bon projet.
Ce que Zapier ne fait pas avec GitLab, maintenant. Aucune opération ne supprime quoi que ce soit : ni branche, ni ticket, ni merge request. Les trois recherches ne trouvent que des merge requests, jamais un ticket ou un commit. Et deux déclencheurs sur onze ne sont pas instantanés (New Commit et Merge Request Review Request) : sur le plan gratuit, ils peuvent réagir avec jusqu'à 15 minutes de retard.
La même app existe ailleurs : l'intégration GitLab n8n et l'intégration GitLab Make suivent la même méthode, pratique si ton outil n'est pas encore choisi.
Le vocabulaire Zapier en une minute
Sept mots reviennent partout sur cette page. Les voici une bonne fois, en français courant.
- Zap
- L'automatisation que tu montes dans Zapier : un événement de départ, puis une ou plusieurs étapes, rejouées à chaque nouvel événement.
- Déclencheur
- L'événement qui lance le Zap, par exemple un commentaire posté sur un ticket GitLab. Une fois le Zap allumé, Zapier l'attend.
- Action
- Ce que le Zap fait une fois lancé : l'étape qui crée, écrit ou publie à ta place, comme une branche ou un ticket GitLab.
- Tâche
- L'unité que Zapier facture. Une tâche, c'est une action réussie ; ton plan fixe combien tu en as chaque mois.
- Interrogation ou instantané
- Un déclencheur par interrogation est vérifié par Zapier à intervalle fixe. Un déclencheur instantané est signalé par l'app elle-même, sur le coup.
- Filtre
- Une étape qui laisse passer le Zap seulement si ce qui arrive respecte ta condition, et l'arrête sans bruit dans les autres cas.
- Étape de recherche
- Une étape qui retrouve un élément existant, ici une merge request GitLab, pour que les étapes suivantes réutilisent ce qu'elle a trouvé.
Combien coûte un Zap GitLab
GitLab ne fait pas partie des apps que Zapier réserve aux plans payants : elle fonctionne dès le plan gratuit. La facture se compte en tâches, et les règles réservent quelques surprises.
- Plan gratuit100 tâches par mois, Zaps illimités
- Étapes sur le gratuit2 : un déclencheur, une action
- Réservée aux plans payantsNon, GitLab marche dès le gratuit
- Déclencheurs instantanés9 sur 11, sans attente quel que soit le plan
Le déclencheur ne coûte rien. Le passage de Zapier pour chercher de nouveaux commits non plus, quelle que soit sa fréquence. Seule une action qui aboutit est décomptée, et une action ratée ne l'est pas. Dans un Zap à plusieurs actions, chaque action réussie compte à part : trois actions, c'est trois fois plus de tâches qu'une seule. Le vrai piège pour une équipe GitLab tient au plan gratuit, limité à deux étapes. Dès que tu ajoutes un filtre pour trier les événements de tickets, ou une recherche de merge request, le Zap devient multi-étapes et demande un plan payant.
Connecter ton compte GitLab à Zapier
- 01
Ouvre la page Apps de Zapier
Dans Zapier, va sur Apps puis clique sur + Add connection. Une connexion, c'est ton compte GitLab relié une fois, puis réutilisé par chaque Zap qui touche à GitLab.
- 02
Choisis GitLab dans la fenêtre
Tape GitLab dans le champ de recherche de la fenêtre, sélectionne l'app, puis clique sur Add connection. Un nouvel onglet s'ouvre sur la page de connexion de GitLab.
- 03
Connecte-toi et autorise l'accès
Identifie-toi avec le compte GitLab au nom duquel les Zaps agiront, puis accorde l'accès à Zapier. Il te faut un compte GitLab, et des droits de lecture ou d'écriture sur chaque projet dont tu n'es pas propriétaire et que le Zap doit toucher.
Ton premier Zap GitLab : une branche par ticket
ObjectifDès qu'un ticket arrive dans un projet du groupe, préparer automatiquement une branche de travail dans GitLab.
- 01
Crée le Zap et choisis le déclencheur
Lance un nouveau Zap depuis ton tableau de bord Zapier. Dans la première étape, choisis GitLab, puis l'événement
New Group Issue Event, et sélectionne le groupe à surveiller. - 02
Teste le déclencheur
Lance le test : Zapier remonte les trois événements de ticket les plus récents du groupe. Tu en choisis un vrai, ce qui te servira à remplir les champs de l'action plus loin.
- 03
Ajoute un filtre
Clique sur l'icône plus, choisis Filter, puis indique le champ à regarder, la règle et la valeur. Une mise à jour de ticket est aussi un événement : garde seulement ce qui doit créer une branche. Ce filtre rend le Zap multi-étapes, donc payant.
- 04
Pose l'action Create Branch
Ajoute une étape GitLab avec l'action
Create Branch. Choisis le projet, puis construis le nom de la branche à partir des infos du ticket remontées par le test. - 05
Teste puis publie
Teste l'action une fois et vérifie que la branche apparaît dans GitLab. Si tout est bon, clique sur Publish : le Zap tourne désormais pour chaque nouveau ticket retenu par le filtre.
Les déclencheurs GitLab sur Zapier
11 événements démarrent un Zap quand quelque chose se passe dans GitLab, et 9 d'entre eux sont instantanés : l'app prévient Zapier tout de suite, quel que soit ton plan.
New Code Snippet Comment
Déclencheur instantanéDans Zapier“Triggers when a new comment is made on a code snippet in the selected project”
Lance le Zap dès qu'une personne commente un snippet de code du projet choisi. Les snippets partagés (bouts de config, scripts d'équipe) reçoivent des remarques ; ce déclencheur les fait remonter là où l'équipe travaille.
New Commit
Déclencheur par interrogationDans Zapier“Trigger when a commit is made on the specified project.”
Part à chaque nouveau commit sur le projet sélectionné. C'est le point d'entrée pour garder une trace des changements de code ailleurs que dans le dépôt, ou pour enchaîner une étape dans GitLab après chaque envoi.
New Commit Comment
Déclencheur instantanéDans Zapier“Triggers when a new comment is made on a commit in the selected project”
Réagit au commentaire posté sur un commit du projet choisi. La remarque peut alors alimenter un ticket ou une note, au lieu de rester sur la page du commit.
New Group Issue Event
Déclencheur instantanéDans Zapier“Triggers on group issue events, e.g. when an issue is opened, updated, or closed.”
Surveille les tickets d'un groupe entier, pas d'un seul projet : un ticket ouvert, modifié ou fermé dans n'importe quel projet du groupe lance le Zap. Un seul Zap couvre ainsi tous les dépôts d'une équipe.
New Group Merge Request Event
Déclencheur instantanéDans Zapier“Triggers on an open, merge, close, or update merge request event.”
Écoute les merge requests de tout un groupe. Une ouverture, une fusion, une fermeture ou une mise à jour dans l'un de ses projets suffit à lancer le Zap.
New Issue Comment
Déclencheur instantanéDans Zapier“Triggers when a new comment is made on an issue in the selected project”
Démarre au moment où un commentaire est ajouté à un ticket du projet choisi. La discussion autour d'un ticket peut alors piloter d'autres étapes, sans copier-coller.
New Project Issue Event
Déclencheur instantanéDans Zapier“Triggers on project issue events, e.g. when an issue is opened, updated, or closed.”
La version à un seul projet du déclencheur de groupe. Ticket ouvert, modifié ou fermé dans ce dépôt précis, et le Zap démarre ; le reste du groupe est ignoré.
New Job Event
Déclencheur instantanéDans Zapier“Triggers for a specified job event in a project.”
Branche Zapier sur la CI d'un projet : l'événement de job que tu précises lance le Zap. C'est le pont entre tes pipelines et tout ce qui doit suivre, du ticket au commentaire.
New Merge Request Comment
Déclencheur instantanéDans Zapier“Triggers when a new comment is made on a merge request in the selected project”
Capte chaque nouveau commentaire laissé sur une merge request du projet. Les échanges de relecture deviennent un signal qu'un Zap peut exploiter.
New Project Merge Request Event
Déclencheur instantanéDans Zapier“Triggers on an open, merge, close, or update merge request event.”
Suit les merge requests d'un seul projet : ouverture, fusion, fermeture ou mise à jour. À choisir quand un seul dépôt doit alimenter le Zap.
Merge Request Review Request
Déclencheur par interrogationDans Zapier“Triggers when you are requested to review a merge request.”
Se déclenche quand on te demande de relire une merge request. Il suit le compte connecté et non un projet : chaque relecteur le monte donc sur sa propre connexion.
Les actions GitLab sur Zapier
GitLab te donne 8 actions. Pour chacune : ce qu'elle fait pour toi, le moment où tu la choisis, et ce qu'il faut surveiller.
Create Branch
ActionDans Zapier“Creates a new branch.”
Crée une nouvelle branche dans le projet choisi : le travail démarre sur une base propre, sans commande git tapée à la main.
Create Commit
ActionDans Zapier“Creates a new commit. Supports creating or updating a file.”
Écrit un commit sur une branche en créant ou en modifiant un fichier. C'est la seule action qui touche au code du dépôt lui-même.
Create Issue
ActionDans Zapier“Creates a new issue.”
Ouvre un ticket dans un projet. N'importe quel événement de déclencheur devient ainsi une tâche avec un responsable.
Add Note to Issue
ActionDans Zapier“Adds a new note.”
Ajoute un commentaire, qu'on appelle note dans GitLab, sur un ticket existant. L'historique du ticket reste complet sans que personne ne rédige de point d'étape.
Create Merge Request
ActionDans Zapier“Creates a new merge request.”
Ouvre une merge request depuis une branche source, avec l'option d'écraser ses commits en un seul ou de supprimer la branche après fusion.
Add Note to Merge Request
ActionDans Zapier“Adds a new note.”
Laisse un commentaire sur une merge request existante, pour donner aux relecteurs un contexte venu d'ailleurs.
Update Merge Request
ActionDans Zapier“Updates an existing merge request.”
Modifie une merge request déjà ouverte. Tu désignes le projet et la merge request, puis ce qui doit changer.
API Request (Beta)
ActionDans Zapier“This is an advanced action which makes a raw HTTP request that includes this integration's authentication.”
La porte de sortie avancée : une requête brute envoyée à GitLab, avec ta connexion déjà attachée, pour tout ce que les autres actions ne couvrent pas.
Les recherches GitLab sur Zapier
3 étapes de recherche vont chercher une donnée qui existe déjà dans GitLab, pour qu'une étape suivante s'en serve.
Les trois recherches retrouvent des merge requests, à trois échelles différentes. Elles se trouvent en bas de la liste des événements, sous SEARCH. Une recherche ajoute une étape : le Zap devient multi-étapes et passe sur un plan payant. Trois réglages décident de la suite quand le résultat n'est pas celui attendu.
Find Group Merge Requests
RechercheDans Zapier“Find Merge Requests for a Group”
Cherche des merge requests à l'intérieur d'un seul groupe GitLab, sans regarder les autres groupes visibles par ton compte.
Find All Merge Requests
RechercheDans Zapier“Finds all Merge Requests that the authenticated user has access to.”
Balaie toutes les merge requests auxquelles le compte connecté a accès, tous groupes et projets confondus.
Find Project Merge Requests
RechercheDans Zapier“Finds Merge Requests for a Project”
Restreint la recherche à un seul projet, ce qui est en général le bon réflexe avant une mise à jour ou une note.
Les trois réglages que toute recherche expose
- Successful if no search results are found?Laissé par défaut, une recherche vide arrête le Zap là, et les étapes qui en dépendaient sont sautées. Activé, le Zap continue les mains vides.
- Create X if it doesn't exist yet?Cette case transforme une recherche en « trouver ou créer ». GitLab n'en propose aucune sur Zapier : ses recherches trouvent, elles ne créent jamais de merge request manquante.
- If multiple search results are found?Trois issues quand plusieurs merge requests correspondent : garder la première, ce qui est le choix par défaut, arrêter le Zap, ou les transmettre toutes.
Quand un Zap GitLab casse
Zapier ne rattache aucun article d'aide aux erreurs GitLab : les pièges ci-dessous sont les limites générales qui frappent le plus fort sur cette app.
Un Zap GitLab en panne, renvoie en général à l'un des cas ci-dessous : un rôle insuffisant, une boucle entre déclencheur et action sur le même projet, ou un pipeline qui crache soudain beaucoup plus d'événements que d'habitude. Pour une méthode complète, la page Dépannage Zapier reprend tout pas à pas.
Le projet n'apparaît pas
La plupart des déclencheurs instantanés ne listent que les projets où tu es Maintainer ou Owner. En dessous, GitLab refuse le hook, et Zapier n'affiche pas le projet.Le Zap se relance sans fin
Un Zap qui ajoute une note ou un ticket là où son propre déclencheur regarde se relance en boucle, et vide vite ton quota de tâches du mois.L'historique n'est pas repris
Un Zap ne réagit qu'à ce qui se passe après sa publication. Les tickets, commits et merge requests existants sont ignorés ; les reprendre est un autre chantier.Un afflux est mis en attente
Après un import massif de tickets ou une migration de projets, la vague d'événements peut être retenue par la protection anti-afflux de Zapier.
Besoin d'aide pour automatiser GitLab avec Zapier ?
Une personne lit chaque message.
