DocumentaciónAide

Connecter GitHub ou GitLab

Liez des branches, des commits et des pull ou merge requests aux éléments de vos espaces agiles, et faites changer l'élément de statut à l'ouverture de la PR ou au merge.

Sur cette page

Avec cette intégration, chaque branche, commit et pull request (GitHub) ou merge request (GitLab) qui mentionne la clé d'un élément, par exemple APP-123, est lié à cet élément dans votre espace agile. En option, l'élément change automatiquement de statut à l'ouverture de la PR ou de la MR et au merge.

Les cartes GitHub et GitLab portent la mention Proposé : la conception de cette intégration peut encore changer.

Avant de commencer

  • Dans Elion ITSM, vous devez disposer du niveau Administrer dans le module Paramètres (par exemple, le rôle Administrateur).

  • Dans GitHub ou GitLab, vous devez avoir l'autorisation de créer des webhooks dans le dépôt ou le projet.

  • Vous pouvez créer une connexion par dépôt, ou une seule et utiliser son URL dans plusieurs dépôts.

Étape 1 : connecter dans Elion ITSM

  1. Ouvrez Paramètres → Intégrations.

  2. Dans la carte GitHub ou GitLab, cliquez sur Connecter.

  3. Remplissez :

    • Nom : par exemple, le nom du dépôt.

    • Espaces agiles où chercher les éléments (aucun coché = tous) : cochez les espaces dont les éléments peuvent être mentionnés.

    • Règles facultatives (elles ne font qu'avancer l'élément) :

      • À l'ouverture de la PR, passer à (statut) (dans GitLab, À l'ouverture de la MR, passer à (statut)) : review par défaut.

      • Au merge, passer à (statut) : qa par défaut.

      Saisissez la clé du statut en minuscules, telle qu'elle apparaît dans les réglages de l'espace. Laissez vide pour ne pas déplacer l'élément.

  4. Cliquez sur Connecter.

Une fenêtre s'ouvre ; elle n'est affichée qu'une seule fois et contient l'URL du webhook et le Secret du webhook (dans GitLab, Secret token). Utilisez Copier l'URL et Copier le secret. Ne la fermez pas avant d'avoir terminé l'étape 2.

Étape 2 : créer le webhook dans le dépôt

Dans GitHub

  1. Dans le dépôt, ouvrez Settings → Webhooks → Add webhook.

  2. Dans Payload URL, collez l'URL. Dans Content type, choisissez application/json. Dans Secret, collez le secret.

  3. Dans les événements, cochez Pushes et Pull requests.

  4. Enregistrez le webhook.

Dans GitLab

  1. Dans le projet, ouvrez Settings → Webhooks.

  2. Dans URL, collez l'URL. Dans Secret token, collez le secret.

  3. Cochez Push events et Merge request events.

  4. Enregistrez le webhook.

Revenez dans Elion ITSM et cliquez sur C'est bon, je l'ai copié.

Et ensuite

  • Quand vous faites un push ou ouvrez une PR ou une MR qui mentionne APP-123 dans le nom de la branche, dans un commit ou dans le titre, l'élément APP-123 est lié.

  • Si vous avez défini des règles, l'élément passe au statut indiqué à l'ouverture de la PR ou de la MR et au merge. Les règles ne font qu'avancer l'élément.

  • La connexion affiche Dernier contact avec la date du dernier événement reçu.

Demandez à l'équipe de nommer ses branches avec la clé de l'élément, par exemple APP-123-login-con-google. C'est la façon la plus simple de tout lier.

Renouveler l'URL et le secret

Si vous pensez que l'URL ou le secret ont fuité, cliquez sur Renouveler l'URL et le secret et confirmez avec Renouveler. Les valeurs actuelles cessent immédiatement de fonctionner : collez les nouvelles dans le webhook du dépôt.

Voir aussi

Rechercher dans Elion ITSM

Saisissez au moins 2 caractères pour rechercher dans Elion ITSM.

↑↓ naviguer · Enter ouvrir · Esc fermer