Relier le code de GitHub ou GitLab aux tâches

Les développeurs peuvent relier leur code aux tâches sans quitter GitHub ou GitLab. Lorsqu'un message de commit, un nom de branche ou une pull request (une merge request dans GitLab) mentionne le numéro d'une tâche, comme CBS-74-T357, il apparaît dans l'onglet Code lié de cette tâche. Cela fait partie de la formule Entreprise, et seuls les administrateurs peuvent connecter.

Connecter un dépôt

1. Ouvrez Paramètres et choisissez Intégrations.
2. Sous GitHub et GitLab, saisissez un Nom (par exemple Application mobile), choisissez GitHub ou GitLab, et appuyez sur Relier.
3. Kaam360 affiche une Adresse et un Secret. Copiez les deux maintenant : le secret ne s'affiche qu'une fois.
4. Dans GitHub, ouvrez le dépôt (ou votre organisation), puis Paramètres, Webhooks, Add webhook. Collez l'adresse dans Payload URL, choisissez application/json, collez le secret dans Secret, choisissez Let me select individual events, cochez Pushes et Pull requests, et appuyez sur Add webhook.
5. Dans GitLab, ouvrez le projet (ou votre groupe), puis Paramètres, Webhooks, Add new webhook. Collez l'adresse dans URL et le secret dans Secret token, cochez Push events et Merge request events, et appuyez sur Add webhook.

GitHub envoie immédiatement un message de test. La connexion affiche alors Actif, avec ce qu'a fait le dernier message.

Mentionner une tâche

Copiez le numéro de la tâche affiché en haut de celle-ci (par exemple CBS-74-T357) dans :

• un message de commit, comme Corrige le bouton de connexion (CBS-74-T357) ;
• un nom de branche, comme feature/CBS-74-T357-login ;
• le titre ou la description d'une pull request.

Le numéro doit inclure le code de son propre projet, pour qu'un numéro d'un autre projet ne soit jamais relié par erreur. Ouvrez la tâche et choisissez l'onglet Code lié pour voir chaque commit, branche et pull request liés, avec leur dépôt et leur auteur, et pour une pull request si elle est ouverte, fusionnée ou fermée. Appuyez sur une ligne pour l'ouvrir dans GitHub ou GitLab. L'historique de la tâche indique aussi quand du code a été relié.

Terminer les tâches lorsqu'une pull request est fusionnée

Cochez Marquer comme terminées les tâches qu'elle mentionne pour une connexion. Lorsqu'une pull request qui mentionne une tâche est fusionnée, la tâche passe à terminée, comme si l'administrateur qui a créé la connexion l'avait fait.

Garder la connexion sûre

• Kaam360 vérifie le secret à chaque message et refuse tout message qui ne l'a pas.
• Si le secret a pu fuiter, appuyez sur le bouton clé (Nouveau secret) et placez le nouveau secret dans les paramètres du webhook. L'ancien cesse aussitôt de fonctionner.
• Appuyez sur Mettre en pause pour arrêter un moment les liaisons, ou sur Retirer pour supprimer la connexion et les liens qu'elle a créés. Supprimez aussi le webhook dans GitHub ou GitLab.

En cas de problème

• Rien n'est relié : vérifiez que le numéro inclut le code du projet et le bon numéro de tâche, et que le webhook envoie les pushes et les pull requests.
• GitHub affiche une marque rouge sur une livraison : l'adresse ou le secret est erroné. Appuyez sur Nouveau secret et collez-le de nouveau.