GitScrum / Docs
Toutes les Bonnes Pratiques

Intégration Git Projet | GitScrum

Connectez GitHub, GitLab et Bitbucket directement à vos tâches GitScrum pour un suivi unifié où commits, branches et PRs sont liés au travail.

6 min de lecture

Quand les dépôts Git et la gestion de projet vivent dans des mondes séparés, les équipes perdent la visibilité sur quel code supporte quelles tâches. GitScrum s'intègre avec GitHub, GitLab et Bitbucket pour connecter commits, branches et pull requests.

Le Problème de Déconnexion

Git séparé de la gestion de projet crée de la friction:

  • Mises à jour manuelles — Marquer les tâches complètes après les merges
  • Contexte perdu — Pas de visibilité sur quels commits supportent quelles tâches
  • Effort dupliqué — Écrire descriptions de PR et mises à jour de tâches
  • Lacunes d'audit — Tracer les fonctionnalités aux exigences originales
  • Surcharge de reporting — Corréler manuellement code et progrès

Intégrations Git de GitScrum

Connectez vos dépôts à GitScrum:

Plateformes Supportées

PlateformeFonctionnalités
GitHubCommits, branches, PRs, sync d'issues
GitLabCommits, branches, MRs, sync d'issues
BitbucketCommits, branches, PRs

Ce Qui Est Connecté

  • Commits liés aux tâches via ID de tâche dans message de commit
  • Branches suivis par tâche
  • Pull/Merge Requests visibles dans timeline de tâche
  • Changements de statut reflétés automatiquement

Configurer l'Intégration Git

Setup GitHub

  • Aller dans Paramètres Projet → Intégrations
  • Sélectionner GitHub
  • S'authentifier avec OAuth
  • Sélectionner les dépôts à connecter
  • Configurer les options de sync

    • Setup GitLab

  • Aller dans Paramètres Projet → Intégrations
  • Sélectionner GitLab
  • Entrer le token d'accès personnel
  • Sélectionner les projets à connecter
  • Configurer les notifications webhook

    • Setup Bitbucket

  • Aller dans Paramètres Projet → Intégrations
  • Sélectionner Bitbucket
  • S'authentifier avec OAuth
  • Sélectionner les dépôts à connecter
  • Configurer les options de sync

    • Lier les Commits aux Tâches

    Utilisez les IDs de tâche dans les messages de commit:

    Format de Message de Commit

    git commit -m "Add user authentication [GS-234]"

    Formats Alternatifs

    # Forme courte
git commit -m "Fix login bug #234"

# Avec description
git commit -m "Implement OAuth flow

Adds Google OAuth support for user authentication.
Closes GS-234"

# Tâches multiples
git commit -m "Refactor auth module [GS-234] [GS-235]"

    Ce Qui Apparaît dans GitScrum

    Tâche #234: Implémenter login OAuth
├── Statut: En Cours
├── Activité Git:
│   ├── Commit abc123: "Add user authentication [GS-234]"
│   ├── Branch: feature/oauth-login
│   └── PR #45: "OAuth Implementation" (Ouvert)
└── Dernière mise à jour: il y a 5 minutes

    Suivi des Branches

    GitScrum suit les branches associés aux tâches:

    Convention de Nommage des Branches

    feature/GS-234-oauth-login
bugfix/GS-456-login-error
hotfix/GS-789-security-patch

    Visibilité des Branches

    • Voir les branches actifs par tâche
    • Suivre le statut du branch (ouvert, fusionné, supprimé)
    • Voir l'historique du branch dans la timeline

    Intégration Pull Request

    Visibilité des PRs dans les Tâches

    Quand les PRs référencent des IDs de tâche: 
    Tâche #234: Implémenter login OAuth
├── Pull Requests:
│   └── #45: "OAuth Implementation"
│       ├── Statut: Ouvert
│       ├── Auteur: @developer
│       ├── Reviewers: @senior-dev
│       ├── Checks: ✓ Tous passent
│       └── Commentaires: 3

    Mises à Jour Automatiques de Statut

    Configurer les auto-transitions:
    • PR ouvert → Tâche passe à "En Review"
    • PR fusionné → Tâche passe à "Terminé"
    • PR fermé → Tâche revient à "En Cours"

    Timeline d'Activité

    Chaque tâche montre l'activité Git chronologiquement:

    Tâche #234: Implémenter login OAuth
Timeline:
├── 18 Déc, 10:00 — PR #45 fusionné par @senior-dev
├── 18 Déc, 09:30 — PR #45 approuvé par @senior-dev
├── 17 Déc, 16:00 — PR #45 ouvert par @developer
├── 17 Déc, 15:45 — Commit def456: "Add OAuth callback handling"
├── 17 Déc, 14:00 — Commit abc123: "Add OAuth initialization"
├── 16 Déc, 10:00 — Branch feature/GS-234-oauth-login créé
└── 15 Déc, 09:00 — Tâche créée par @pm

    Lien Bidirectionnel

    De GitScrum vers Git

    • Voir commits, branches, PRs dans les détails de tâche
    • Cliquer pour aller sur GitHub/GitLab/Bitbucket
    • Voir statut PR et commentaires de review

    De Git vers GitScrum

    • Ajouter liens vers tâches dans descriptions PR
    • Voir contexte de tâche lors de la review de PRs
    • Accéder aux exigences de tâche depuis l'historique de commits

    Meilleures Pratiques

    Standards de Messages de Commit

  • Inclure ID de tâche — Chaque commit référence une tâche
  • Être descriptif — Expliquer quoi et pourquoi
  • Garder atomique — Un changement logique par commit
  • Utiliser format conventionnel — type(scope): message [task-id]

    • Stratégie de Branches

  • Utiliser ID de tâche dans nom de branch — Liaison automatique
  • Garder branches de courte durée — Fusionner fréquemment
  • Supprimer après fusion — Dépôt propre

    • Workflow PR

  • Référencer tâche dans titre ou description PR
  • Utiliser template PR qui demande lien de tâche
  • Revoir exigences de tâche avant d'approuver

    • Opportunités d'Automatisation

    Auto-Déplacer Tâches sur Événements Git

    Événement GitTransition de Tâche
    Branch crééÀ Faire → En Cours
    PR ouvertEn Cours → Code Review
    PR approuvéCode Review → Prêt à Fusionner
    PR fusionnéPrêt à Fusionner → Terminé
    PR fermé (non fusionné)Code Review → En Cours

    Notifications Webhook

    Envoyer événements Git à GitScrum:
    • Push de commits
    • Changements de statut PR
    • Création/suppression de branches
    • Demandes de review

    Solutions Connexes