Avec l’intégration GitHub, vous voyez les pull requests, runs GitHub Actions, 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 GitHub
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 pull requests contenant l’ID de la tâche apparaissent sur la tâche correspondante.
- Les runs GitHub Actions 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 relancez les runs échoués directement depuis FeatValue.
Pour une vue d’ensemble, consultez la page sur l’intégration GitHub.
Prérequis
- un compte FeatValue pour votre entreprise avec au moins un client et un projet (voir Créer des projets)
- un compte ou une organisation sur github.com
- le droit d’installer des apps sur ce compte ou cette organisation. Dans les organisations, ce sont les owners. Les autres membres peuvent demander l’installation, et un owner l’approuve ensuite dans GitHub.
Connecter GitHub
-
Ouvrir l’app
Cliquez sur
Applications dans la barre latérale gauche, choisissez
GitHub et cliquez sur
Installer (voir
Connecter des applications).
-
Se connecter avec GitHub
Cliquez sur
Se connecter avec GitHub. Une courte note indique les permissions demandées par l’app (voir
Permissions de la GitHub App). Cliquez sur
Continuer vers GitHub.
-
Se connecter à GitHub
Connectez-vous à GitHub et autorisez l’app FeatValue.
-
Installer l’app ou choisir les organisations
Si l’app n’est encore installée nulle part, GitHub ouvre directement l’installation : choisissez votre compte ou une organisation, puis All repositories ou, sous Only select repositories, les dépôts que FeatValue peut voir, et cliquez sur Install. Si l’app est déjà installée dans plusieurs organisations, vous choisissez sur une page de sélection les organisations à connecter. Vous revenez ensuite dans FeatValue.
Ne donnez accès qu’aux dépôts que vous voulez lier à des projets FeatValue. Vous pouvez modifier la sélection à tout moment dans GitHub, pour l’app FeatValue : sur un compte personnel sous Settings › Applications › Installed GitHub Apps, dans une organisation sous Organization settings › Third-party Access › GitHub Apps.
Permissions de la GitHub App
L’app FeatValue demande ces permissions à GitHub :
- Metadata: read : noms et données de base des dépôts autorisés
- Contents: read : commits et comparaisons de branches
- Pull requests: read : pull requests avec titre, statut et branche
- Actions: read & write : lire les runs GitHub Actions, écrire uniquement pour relancer un run
- Deployments: read : déploiements et environnements
La GitHub App demande un accès en lecture au contenu du dépôt (Contents: read), car GitHub ne fournit les commits et les comparaisons de branches qu’avec cette permission. FeatValue l’utilise uniquement pour lire les données des commits (message, auteur, date et heure) et les comparaisons de branches, jamais le code source, et n’enregistre aucun fichier.
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.
-
Ouvrir Lier des dépôts
Ouvrez
Préférences › Entreprise › Intégrations et apps et choisissez
GitHub (voir
Apps connectées). La page s’intitule
Lier des dépôts.
-
Trouver le dépôt
Les dépôts auxquels vous avez donné accès à l’app sont listés sous Dépôts dans GitHub. Utilisez Rechercher un dépôt pour filtrer la liste.
-
Choisir le projet et lier
À côté du dépôt, choisissez le Projet FeatValue et cliquez sur Lier. FeatValue récupère les derniers jours. Vous n’avez pas besoin de créer de webhook, les événements arrivent via l’app FeatValue.
Toutes les liaisons figurent sous Dépôts liés. La colonne Mise à jour indique Immédiatement par webhook. Avec Modifier, vous choisissez un autre projet, et avec Délier, vous supprimez la liaison.
Plusieurs organisations dans une connexion
Une connexion FeatValue peut utiliser l’app de toutes les organisations et de tous les comptes GitHub où elle est installée et auxquels vous avez accès lors de la connexion, par exemple votre propre organisation et celles de vos clients. La liste de la page Lier des dépôts est regroupée par organisation.
-
Ajouter une organisation
Ouvrez Préférences › GitHub (la page Lier des dépôts) et cliquez sur Ajouter une organisation.
-
Choisir l’organisation
Choisissez une organisation où l’app est déjà installée. Si elle n’apparaît pas, cliquez sur Installer dans une autre organisation et installez l’app dans GitHub.
-
Lier des dépôts
Les dépôts de l’organisation apparaissent dans la liste. Liez-les comme décrit plus haut.
Plusieurs entreprises FeatValue peuvent utiliser la même installation, par exemple votre agence et votre client avec son propre compte FeatValue.
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 pull 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 runs GitHub Actions 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 pull requests.
Ce qui apparaît sur la tâche
La tâche affiche la section Développement avec une ligne compacte, par exemple : PR #12 fusionnée · Workflow réussi · Déployé sur Staging. Cliquez sur Afficher les détails pour la déplier :
- Workflows : les runs GitHub Actions, par exemple CI #57, avec leurs jobs et leur statut
- Environnements issus de vos déploiements avec un lien pour les ouvrir, par exemple Staging et Production
- Pull 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 run de la branche par défaut. Cliquez sur Afficher toutes les exécutions de workflow pour voir les Dernières exécutions de workflow. 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 GitHub |
| 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, pull requests, workflows, 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.
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 :
- Pull request fusionnée
- Workflow réussi
- Workflow échoué (avec jobs échoués)
- 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 ?.
Relancer les runs échoués
Starter
Quand un run GitHub Actions échoue ou est annulé, vous le relancez directement dans FeatValue. Pour un run échoué, GitHub ne relance que les jobs en échec ; pour un run annulé, le run entier. Cette fonction est disponible à partir de l’offre Starter (voir Offres).
-
Autoriser des workflows
Dans le projet, ouvrez les Paramètres de la section Développement. Sous Relancer des workflows depuis FeatValue, vous trouvez les workflows pour lesquels GitHub a signalé jusqu’ici un run échoué, par exemple CI. Cochez les workflows qui doivent apparaître dans FeatValue et cliquez sur Enregistrer.
-
Aussi pour les clients
Si votre client doit pouvoir relancer les workflows sélectionnés, cochez Les clients peuvent aussi relancer les workflows sélectionnés.
-
Relancer
Un run échoué d’un workflow autorisé apparaît avec le bouton Relancer. Après le clic, FeatValue affiche Relancé, et vous suivez la suite sur le run.
Sécurité
- Uniquement les dépôts autorisés et liés : L’app FeatValue ne voit que les dépôts auxquels vous donnez accès lors de l’installation. FeatValue n’attribue les ID de tâche que dans les dépôts que vous avez liés à un projet, et uniquement au sein de ce projet.
- Pas de code source : FeatValue ne lit que les données des commits et les comparaisons de branches, jamais le code source, et n’enregistre aucun fichier de votre dépôt. C’est pour cela que l’app demande Contents: read (voir Permissions de la GitHub App).
- Webhooks vérifiés : GitHub signe chaque envoi à FeatValue. FeatValue n’accepte que les appels avec une signature valide.
- Peu de droits d’écriture : La seule chose que l’app peut modifier, c’est relancer des runs GitHub Actions, et uniquement pour les workflows que vous avez autorisés.
- Délier à tout moment : Délier supprime une liaison. Si vous désinstallez l’app dans GitHub, FeatValue délie automatiquement les dépôts de cette organisation.
Déconnecter et désinstaller l’app
Si vous déconnectez GitHub dans FeatValue, FeatValue supprime uniquement les liaisons des dépôts. Ce qui figure déjà sur les tâches est conservé. L’app reste installée dans GitHub jusqu’à ce que vous la désinstalliez :
- Organisation : Dans GitHub, ouvrez Organization settings › Third-party Access › GitHub Apps, cliquez sur Configure à côté de l’app FeatValue, puis tout en bas sur Uninstall.
- Compte personnel : Ouvrez Settings › Applications › Installed GitHub Apps, cliquez sur Configure à côté de l’app FeatValue, puis sur Uninstall.
Après la désinstallation, FeatValue délie automatiquement les dépôts de cette organisation.
Dépannage
Mon dépôt n’apparaît pas dans la liste
FeatValue n’affiche que les dépôts auxquels vous avez donné accès à l’app. Dans GitHub, ouvrez Settings › Applications › Installed GitHub Apps, choisissez l’app FeatValue et ajoutez le dépôt sous Repository access. Pour une organisation, ce réglage se trouve dans les paramètres de l’organisation.
L’installation attend une approbation
Si vous n’êtes pas owner de l’organisation, GitHub envoie la demande d’installation aux owners. Dès qu’un owner l’approuve, connectez à nouveau GitHub dans FeatValue.
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 pull request ?
- Si un envoi de GitHub se perd, FeatValue récupère les données dans un délai de 10 minutes.
Un run ne peut pas être relancé
La relance est disponible à partir de l’offre Starter. Le workflow doit aussi être autorisé dans les paramètres du projet, et le run doit avoir échoué ou avoir été annulé. Si Relance impossible s’affiche, vérifiez dans GitHub si l’app est toujours installée et peut voir le dépôt.
Une organisation manque dans la sélection
FeatValue n’affiche que les organisations où l’app est installée et auxquelles votre compte GitHub a accès. Installez l’app avec Installer dans une autre organisation ou demandez-le à un owner de l’organisation.