Aller au contenu principal

Intégration GitHub

Open in QuickMonitoring→ Sites → [Votre site] → Paramètres → GitHub

Connectez votre compte GitHub à QuickMonitoring et associez un dépôt à votre site. À chaque push, GitHub envoie un webhook à QuickMonitoring qui déclenche automatiquement un scan QA — le niveau de scan s'adapte au volume de fichiers modifiés.

Ce que vous verrez​

Dans Paramètres → GitHub de votre site, vous trouverez :

  • Statut de la connexion GitHub : indique si votre compte GitHub est connecté à l'organisation QuickMonitoring
  • Dépôt sélectionné : le dépôt GitHub associé à ce site, sélectionnable dans une liste déroulante de vos dépôts accessibles
  • Filtre de branche : un champ texte optionnel permettant de restreindre les scans à certaines branches (valeurs séparées par des virgules)
  • Statut du webhook : confirmation que le webhook a bien été installé sur le dépôt GitHub
  • Historique des déclenchements : les derniers pushes reçus avec le nombre de fichiers modifiés, le niveau de scan déclenché et le statut

Comment configurer l'intégration​

Étape 1 — Connecter votre compte GitHub​

  1. Rendez-vous dans Paramètres de l'organisation → Intégrations.
  2. Cliquez sur Connecter GitHub.
  3. Vous êtes redirigé vers GitHub pour autoriser QuickMonitoring via OAuth.
  4. Acceptez les permissions demandées — QuickMonitoring a besoin d'accéder à vos dépôts pour installer des webhooks.
  5. Une fois l'autorisation accordée, vous êtes redirigé vers QuickMonitoring et votre compte GitHub apparaît comme connecté.

Étape 2 — Associer un dépôt à votre site​

  1. Rendez-vous dans Sites et sélectionnez votre site.
  2. Cliquez sur Paramètres dans la barre de navigation latérale.
  3. Ouvrez l'onglet GitHub.
  4. Dans la liste déroulante Dépôt, sélectionnez le dépôt correspondant à ce site.
  5. Optionnellement, renseignez un filtre de branche : saisissez les noms de branches séparés par des virgules (ex. : main, production). Laissez ce champ vide pour scanner sur tous les pushes, quelle que soit la branche.
  6. Cliquez sur Enregistrer.

QuickMonitoring installe automatiquement un webhook sur le dépôt GitHub sélectionné. Aucune action manuelle sur GitHub n'est requise.

Niveaux de scan selon le volume de modifications​

QuickMonitoring adapte le niveau de scan au nombre de fichiers modifiés dans le push :

Fichiers modifiésNiveau de scan déclenché
1 à 5 fichiersScan rapide
6 à 20 fichiersScan standard
21 fichiers et plusScan complet

Les pushes contenant uniquement des fichiers documentaires (.md, .txt, fichiers de verrouillage de dépendances) sont automatiquement ignorés — aucun scan n'est déclenché.

Délai de refroidissement​

Un délai de refroidissement de 10 minutes est appliqué entre deux scans déclenchés par GitHub. Si plusieurs pushes se succèdent rapidement, seul le premier déclenchera un scan. Les suivants seront ignorés jusqu'à l'expiration du délai. Cela évite les scans en double lors de séries de commits rapides.

Drapeaux de saut dans les messages de commit​

Ajoutez l'un des drapeaux suivants dans le message de votre commit pour empêcher QuickMonitoring de déclencher un scan sur ce push :

  • [skip-scan]
  • [no-scan]
  • [skip-qa]

Exemple :

git commit -m "fix: mise à jour du README [skip-scan]"

E-mail de régression​

Après chaque scan déclenché par GitHub, QuickMonitoring compare les résultats avec le scan précédent. Si de nouveaux problèmes sont détectés — erreurs, liens brisés, fautes d'orthographe ou violations d'accessibilité absentes du scan précédent — un e-mail de régression est envoyé aux membres de l'équipe concernés. Cet e-mail liste les régressions par catégorie et inclut un lien direct vers le rapport qualité du scan.

Condition de réussite​

✅ Vous obtenez ce badge lorsqu'un dépôt GitHub est associé à votre site, que le webhook est correctement installé, et qu'au moins un scan a été déclenché automatiquement par un push.

Problèmes fréquents​

  • Le webhook n'est pas installé — Vérifiez que vous avez bien accordé à QuickMonitoring les permissions d'accès aux dépôts lors de l'autorisation OAuth. Si vous avez d'abord autorisé QuickMonitoring en accès limité, rendez-vous dans vos paramètres GitHub → Applications → QuickMonitoring et étendez les permissions au dépôt concerné, puis réenregistrez la configuration dans QuickMonitoring.

  • Les pushes sur ma branche ne déclenchent pas de scan — Vérifiez le champ Filtre de branche dans Paramètres → GitHub. Si un filtre est défini, seules les branches listées déclenchent des scans. Assurez-vous que le nom de votre branche correspond exactement (sensible à la casse).

  • Un push a été ignoré à cause du délai de refroidissement — C'est le comportement attendu. Le scan du premier push de la série couvre l'ensemble des modifications. Attendez 10 minutes avant de pousser à nouveau si vous souhaitez déclencher un scan supplémentaire.

  • Les pushes documentaires ne déclenchent pas de scan — C'est intentionnel. Les commits contenant uniquement des fichiers .md, .txt ou des fichiers de verrouillage ne modifient pas le site en production et sont automatiquement ignorés pour économiser vos quotas de scan.

  • Je ne vois pas mon dépôt dans la liste déroulante — Vérifiez que QuickMonitoring a bien accès au dépôt dans vos paramètres GitHub. Pour les dépôts d'une organisation GitHub, un administrateur de l'organisation doit approuver l'accès OAuth de QuickMonitoring.