Connecter GitHub

Une fois GitHub connecté, PostShip publie un Check Run sur le commit déployé après chaque vérification déclenchée par un webhook de déploiement : vert si tout passe, rouge sinon, avec le Ship Score en titre et le détail par URL en résumé. Vous voyez le verdict dans la pull request sans quitter GitHub — et vous pouvez en faire une condition de fusion (bloquer un merge).

Prérequis

Le Check se rattache au commit du déploiement. Il faut donc qu'un webhook qui apporte ce commit soit branché :

Installer l'app GitHub (recommandé)

Rien à créer, rien à faire tourner, et la révocation se fait d'un clic côté GitHub. Aucun secret n'est stocké chez PostShip : l'app obtient un jeton d'une heure à chaque Check Run.

1. Sur Projet → Intégrations, carte GitHub, cliquez sur Connecter GitHub.
2. Sur l'écran GitHub, choisissez le compte ou l'organisation, puis Only select repositories et le dépôt du site surveillé. La seule permission demandée est Checks : Read and write (plus Metadata : Read-only, que GitHub ajoute seul). PostShip ne lit jamais votre code.
3. Autorisez : GitHub vous ramène sur PostShip. La carte affiche « App installée — choisissez le dépôt à surveiller » : sélectionnez-le dans la liste et enregistrez. La carte passe à Connecté.

Si le dépôt appartient à une organisation

GitHub peut exiger l'accord d'un propriétaire. L'installation part alors en demande d'approbation et PostShip vous le dit ; la connexion se termine une fois la demande acceptée, en relançant Connecter GitHub.

Avec un token, à la place

L'ancien chemin reste supporté, replié sous Utiliser un token à la place, pour qui préfère un jeton qu'il contrôle.

1. Sur GitHub : Settings → Developer settings → Personal access tokens → Fine-grained tokens, limité au dépôt concerné, avec la permission Checks en Read and write — aucune autre.
2. Sur la carte, renseignez le dépôt au format owner/repo et collez le jeton (github_pat_…), puis Enregistrer. Il est chiffré et jamais réaffiché.

Ce que le Check contient

• Nom : PostShip. C'est ce nom que la protection de branche cherche.
• Titre : PostShip · 92, le Ship Score. Suivi de la raison quand le Check est rouge : (seuil 80), (pack argent), (déployé pendant le gel : …).
• Résumé : une ligne par URL vérifiée, les échecs décrits comme dans une alerte, et la ligne des liens de la page d'accueil.
• Sur une preview : Preview vérifiée, ou Preview : 2 page(s) en échec — sans score, parce que la moitié de ce qui le compose n'a pas de sens sur un hôte *.vercel.app.

Ce qui fait passer le Check au rouge est réglable sur la carte : Exiger un ship vert pour merger (le défaut) ou Ne bloquer que sur le pack argent. Le détail est sur Bloquer un merge.

Se déconnecter

Déconnecter GitHub retire le dépôt et l'identifiant d'installation du projet. Pour retirer l'app elle-même de votre compte GitHub : Settings → Applications → Installed GitHub Apps.

Limites et plans

Free n'a pas de webhook de déploiement, donc pas de commit à annoter. Voir les plans.

Dépannage

Pourquoi aucun Check n'apparaît sur mes commits ?

Trois causes, dans l'ordre : le déploiement ne portait pas de commit (déploiement lancé depuis un terminal, Cloudflare, webhook générique) ; le dépôt enregistré n'est pas celui d'où part le déploiement ; l'app n'a plus accès au dépôt (retiré de l'installation). La carte ne le signale pas : un Check qui n'a pas pu être posé ne fait jamais échouer le webhook.

Pourquoi « Rattachement GitHub indisponible » ?

PostShip ne peut pas, sur ce site, vérifier que l'installation vous appartient (l'app GitHub n'est pas entièrement configurée côté serveur). Les projets déjà rattachés continuent de recevoir leurs Check Runs ; utilisez le token en attendant.

Pourquoi « Cette installation GitHub est déjà rattachée à un autre compte PostShip » ?

Une installation ne se rattache qu'à un seul compte — un collègue de la même organisation l'a prise, le plus souvent. Demandez-lui de la détacher (Déconnecter GitHub sur son projet), de vous inviter sur son projet, ou installez l'app sur un autre compte GitHub. « Cette installation GitHub n'est pas la vôtre » signifie que votre compte GitHub n'a pas accès à l'installation choisie.