Intégration GitLab

Avec l’intégration GitLab, vous voyez les merge requests, pipelines, environnements et commits directement sur vos tâches dans FeatValue. Vos clients savent en termes simples si leur modification est en cours, sur staging pour être testée ou en ligne.

À quoi sert l’intégration GitLab

Les éditeurs de logiciels et les agences web reçoivent sans cesse la même question : « C’est déjà en ligne ? ». Avec l’intégration, FeatValue y répond sur la tâche :

  • Les branches, commits et merge requests contenant l’ID de la tâche apparaissent sur la tâche correspondante.
  • Les pipelines et les déploiements montrent si la modification a été testée et quel environnement elle a atteint.
  • FeatValue inscrit les étapes importantes sous forme de commentaires dans l’historique de la tâche.
  • Pour chaque projet, vous décidez ce que vos clients en voient.
  • Vous lancez les jobs manuels, comme un déploiement, directement depuis FeatValue.

Pour une vue d’ensemble, consultez la page sur l’intégration GitLab.

Prérequis

  • un compte FeatValue pour votre entreprise avec au moins un client et un projet (voir Créer des projets)
  • GitLab sur gitlab.com ou en instance auto-hébergée, accessible en https
  • au moins le rôle Maintainer dans les projets GitLab que vous voulez lier. C’est ce qui permet à FeatValue de créer le webhook.

Connecter GitLab

  1. Ouvrir l’app

    Cliquez sur Applications dans la barre latérale gauche, choisissez GitLab et cliquez sur Installer (voir Connecter des applications). La page Connecter GitLab s’affiche avec la question Où se trouve votre GitLab ?
  2. gitlab.com

    Choisissez gitlab.com et cliquez sur Continuer. Connectez-vous à GitLab et autorisez l’accès. FeatValue a ainsi accès à vos projets.
  3. Instance GitLab auto-hébergée

    Choisissez Instance GitLab auto-hébergée. Saisissez l’adresse https sous Adresse de l’instance, par exemple https://gitlab.example.com, et un token sous Personal access token. Cliquez sur Continuer.

De quel token ai-je besoin pour une instance auto-hébergée ?

Créez le token dans GitLab sous Préférences › Access tokens :

  • Portée : api. Les portées en lecture seule comme read_api ne suffisent pas, car FeatValue crée des webhooks et lance des jobs manuels.
  • Rôle : L’utilisateur du token doit avoir au moins le rôle Maintainer dans les projets.
  • Date d’expiration : Une fois le token expiré, plus aucune donnée n’arrive. Créez-en un nouveau et reconnectez GitLab.
Idéalement, utilisez un utilisateur dédié ou un token de groupe pour l’intégration. Ainsi, elle ne dépend pas du compte d’une seule personne.

Lier un dépôt à un projet

Chaque dépôt appartient à exactement un projet FeatValue. Seuls les dépôts liés arrivent dans FeatValue.

  1. Ouvrir Lier des dépôts

    Ouvrez Préférences › Entreprise › Intégrations et apps et choisissez GitLab (voir Apps connectées). La page s’intitule Lier des dépôts.
  2. Trouver le dépôt

    Vos dépôts sont listés sous Dépôts dans GitLab. Utilisez Rechercher un dépôt pour filtrer la liste.
  3. Choisir le projet et lier

    À côté du dépôt, choisissez le Projet FeatValue et cliquez sur Lier. FeatValue crée un webhook dans GitLab et récupère les derniers jours.

Toutes les liaisons figurent sous Dépôts liés. La colonne Mise à jour indique Immédiatement par webhook ou Toutes les 10 minutes. Avec Modifier, vous choisissez un autre projet, et avec Délier, vous supprimez la liaison ; FeatValue supprime alors aussi le webhook.

Bien utiliser l’ID de la tâche

Chaque tâche dans FeatValue a un ID, par exemple abc123-4. Vous le trouvez sur la tâche. Indiquez cet ID à l’un de ces endroits :

Où Exemple
Nom de la branche abc123-4-formulaire-contact
Message de commit abc123-4 Rendre le téléphone obligatoire
Titre ou description de la merge request Formulaire de contact : téléphone obligatoire (abc123-4)
  • Les majuscules et minuscules n’ont pas d’importance, et un # devant est autorisé.
  • Si l’ID figure dans le nom de la branche, seuls comptent les commits qui existent uniquement sur cette branche. Les commits de la branche par défaut repris lors de la création de la branche n’apparaissent pas sur la tâche.
  • Les commits d’autres branches n’apparaissent que si l’ID figure dans leur message de commit.
  • L’ID ne vaut qu’au sein du projet lié. FeatValue n’attribue jamais de dépôts liés à un autre projet ou non liés.
  • Les pipelines et les déploiements appartiennent à la tâche s’ils s’exécutent pour l’une de ses branches, l’un de ses commits ou l’une de ses merge requests.

Ce qui apparaît sur la tâche

La tâche affiche la section Développement avec une ligne compacte, par exemple : MR !12 fusionnée · Pipeline réussi · Déployé sur Staging. Cliquez sur Afficher les détails pour la déplier :

  • Pipelines avec leurs étapes, leurs jobs et leur statut
  • Environnements avec un lien pour les ouvrir, par exemple Staging et Production
  • Merge requests, Branches et Commits

Ce qui apparaît dans le projet

Dans le projet, la section Développement affiche les environnements avec leur dernier déploiement ainsi que le dernier pipeline de la branche par défaut. Cliquez sur Afficher tous les pipelines pour voir les Derniers pipelines. C’est aussi là que se trouvent les Paramètres du projet.

Que voient les clients ?

Dans les Paramètres de la section Développement du projet, choisissez sous Que voient les clients ? :

Paramètre Votre client voit
Rien aucune information de GitLab
Statut simple une phrase sans termes techniques : En cours de réalisation, Mis en ligne sur Staging avec le lien tester ici, ou En ligne avec le lien voir maintenant
Détails les sections que vous cochez sous Détails pour les clients : commits, branches, merge requests, pipelines, environnements et commentaires d’historique

Les personnes de votre entreprise autorisées à modifier le projet peuvent changer ce paramètre. La façon dont votre client teste puis accepte est expliquée dans Revue et acceptation.

Configurer les commentaires d’historique

FeatValue inscrit les étapes importantes sous forme de commentaires dans l’historique de la tâche. Sous Commentaires d’historique sur la tâche, vous choisissez pour chaque projet quels événements créent un commentaire :

  • Merge request fusionnée
  • Pipeline réussi
  • Pipeline échoué (avec les jobs en échec)
  • Déployé sur l’environnement

Les événements décochés mettent toujours à jour le statut sur la tâche, mais ne créent plus de commentaire. Que votre client voie les commentaires dépend du paramètre sous Que voient les clients ?.

Lancer des jobs depuis FeatValue Starter

Vous lancez les jobs manuels de votre pipeline, par exemple deploy-production, directement dans FeatValue. Cette fonction est disponible à partir de l’offre Starter (voir Offres).

  1. Autoriser des jobs

    Dans le projet, ouvrez les Paramètres de la section Développement. Sous Lancer des jobs depuis FeatValue, vous trouvez les jobs manuels signalés jusqu’ici par GitLab. Cochez les jobs qui doivent apparaître dans FeatValue et cliquez sur Enregistrer.
  2. Aussi pour les clients

    Si votre client doit pouvoir lancer les jobs sélectionnés, cochez Les clients peuvent aussi lancer les jobs sélectionnés.
  3. Lancer un job

    Lorsqu’un job autorisé attend son lancement manuel, il apparaît avec le bouton Lancer. Après le clic, FeatValue affiche Lancé, et vous suivez la suite sur le pipeline.
Si le message Aucun job manuel signalé pour l’instant. s’affiche, aucun pipeline avec un job manuel n’a encore tourné. Dès que GitLab en signale un, vous pouvez l’autoriser.

Sécurité

  • Uniquement les dépôts liés : FeatValue ne lit que les dépôts que vous avez liés à un projet, et n’attribue les ID de tâche qu’au sein de ce projet.
  • Pas de code : FeatValue n’enregistre aucun fichier de votre dépôt, seulement des informations sur les branches, commits, merge requests, pipelines et environnements.
  • Webhook vérifié : Chaque webhook reçoit son propre token secret. FeatValue n’accepte que les appels qui envoient ce token.
  • Vos droits dans GitLab : FeatValue travaille avec les droits de la connexion ou du token. Il ne peut lancer que les jobs que vous avez autorisés.
  • Délier à tout moment : Délier supprime une liaison, et FeatValue supprime le webhook.

Dépannage

Mon dépôt n’apparaît pas dans la liste

FeatValue n’affiche que les dépôts dans lesquels vous avez au moins le rôle Maintainer. Vérifiez votre rôle dans GitLab ou cherchez le nom avec Rechercher un dépôt.

Le webhook n’a pas pu être créé

La liaison affiche alors Toutes les 10 minutes au lieu de Immédiatement par webhook. Dans ce cas, FeatValue interroge GitLab toutes les 10 minutes : rien ne se perd, cela arrive simplement plus tard. Causes fréquentes : il vous manque le rôle Maintainer, ou votre instance GitLab n’a pas le droit d’envoyer des requêtes vers Internet. Vérifiez ce point, puis cliquez sur Modifier et à nouveau sur Lier.

Rien n’apparaît sur la tâche

  • Le dépôt est-il lié au projet auquel appartient la tâche ?
  • L’ID complet de la tâche figure-t-il dans le nom de la branche, le message de commit ou la merge request ?
  • Sans webhook, il faut jusqu’à 10 minutes pour que les nouvelles données arrivent.

GitLab n’a pas accepté le token

Vérifiez l’adresse de l’instance, le token et la portée api. Le token ne doit pas avoir expiré.

Un job ne peut pas être lancé

Le lancement de jobs est disponible à partir de l’offre Starter. Le job doit aussi être autorisé dans les paramètres du projet et attendre actuellement son lancement manuel. Si Impossible de lancer s’affiche, vérifiez dans GitLab si la connexion a toujours le droit de lancer ce job.

Your question has not been answered?

We will be happy to help you. You can send us an e-mail or arrange a video conference:

Privacy Policy • Mentions légales • Terms and Conditions