# GitLab - déclencheur - Déclencheur de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/gitlab_trigger

Language: fr

Réagir aux push, tags et merge requests GitLab par webhook ou polling.

## Utilisation et spécificités

Publiez le workflow et configurez le webhook ou le polling du dépôt. Les événements, branches et filtres limitent les déclenchements. Le token doit autoriser l’accès au dépôt et, si nécessaire, la création du webhook.

Type technique : `gitlab_trigger`. Runtime : `nodulz`.

## Identifiants et prérequis

- [Créer et configurer l’identifiant : git](/docs/credentials/git)

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le [guide des identifiants](/docs/credentials) pour les accès et la rotation.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `rateLimitEnabled` | `boolean` | - | - |
| `rateLimitMax` | `number` | - | -; > 0 |
| `rateLimitWindowMs` | `number` | - | -; > 0 |
| `allowedIps` | `array` | - | -; max 256 |
| `blockedIps` | `array` | - | -; max 256 |
| `provider` | `literal` | `"gitlab"` | `gitlab` |
| `events` | `array` | `["push"]` | - |
| `branch` | `string` | `""` | - |
| `mergedOnly` | `boolean` | `true` | - |
| `repo` | `string` | `""` | - |
| `credentialId` | `string` | - | - |
| `mode` | `enum` | `"webhook"` | `auto`, `webhook`, `poll` |
| `pollInterval` | `string` | `"2m"` | - |
| `secret` | `string` | - | - |
| `testPayload` | `string` | `""` | - |
| `rules` | `object` | - | - |
| `rules.ignorePathPatterns` | `array` | `[]` | - |
| `rules.requirePathPatterns` | `array` | `[]` | - |
| `deliveryMode` | `enum` | - | `manual`, `webhook`, `poll` |
| `webhookId` | `union` | - | - |
| `pollState` | `object` | - | - |
| `pollState.branchShas` | `record` | - | - |
| `pollState.tagShas` | `record` | - | - |
| `pollState.lastMergedPrIds` | `array` | - | - |
| `setupError` | `string` | - | - |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `repo`<br>URL du dépôt | URL HTTPS du dépôt à surveiller. À la publication, nodulz tente de créer le webhook automatiquement. |
| `mode`<br>Mode de déclenchement | Webhook : déclenchement instantané via un webhook sur le dépôt. Poll : vérification régulière du dépôt. |
| `pollInterval`<br>Intervalle de polling | Format : 30s, 2m, 1h ou expression cron. |
| `provider`<br>Fournisseur Git | Détermine comment parser et vérifier les événements entrants. |
| `branch`<br>Branche | Filtre sur la branche poussée ou la branche cible d'une PR/MR. |
| `mergedOnly`<br>Pull/Merge requests : uniquement après fusion | Ne déclenche que lorsque la PR/MR est fusionnée (pas à l'ouverture). |
| `testPayload`<br>Payload de test | JSON simulé pour les tests dans l'éditeur. Objet simple = corps de l'événement push. |

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "provider": "gitlab",
  "events": [
    "push"
  ],
  "branch": "",
  "mergedOnly": true,
  "repo": "",
  "mode": "webhook",
  "pollInterval": "2m"
}
```

## Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)