Ce que cela vous apporte
Connecter GitHub à l'aide d'un jeton permet à un site de se déployer à partir de l'un de vos dépôts : poussez vers la branche et le site se met à jour. Cela nous permet également de publier sur GitHub Pages sur votre compte lorsque vous choisissez cette option comme hébergeur du site.
Si vos dépôts appartiennent à une organisation, préférez plutôt l'application GitHub Zinn® — consultez Installer l'application GitHub Zinn®. Un jeton appartient à une seule personne et cesse de fonctionner lorsqu'elle quitte l'organisation.
Avant de commencer
Un compte GitHub disposant d'un accès aux dépôts que vous souhaitez déployer. S'ils appartiennent à une organisation, un propriétaire devra peut-être approuver des jetons à granularité fine pour celle-ci.
1. Créer la clé sur GitHub
Sur GitHub, cliquez sur votre photo de profil, puis sur Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Donnez-lui un nom et choisissez une date d'expiration. Sous Repository access, choisissez Only select repositories et sélectionnez ceux que vous déployez — avec l'accès le plus restreint possible.
Sous Repository permissions, accordez l'accès Read and write pour :
- Contents
- Pages
- Administration
Appuyez sur Generate token et copiez-le — GitHub ne l'affiche qu'une seule fois.
2. L'associer ici
Ouvrez Integrations dans votre tableau de bord et choisissez Connect an account. Sélectionnez Code hosting comme groupe et GitHub comme compte, renseignez API token, puis appuyez sur Connect account.
Nous testons ce que vous collez avant qu'un enregistrement ne soit effectué. Une clé qui ne fonctionne pas n'est jamais stockée, et le message indique ce qui n'allait pas. Une clé valide est conservée de manière chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n'est plus jamais affichée, pas même pour vous.
Que se passe-t-il ensuite
- Un site peut se déployer directement à partir d'un dépôt de ce compte : choisissez-le dans
la connexion de dépôt du site, sélectionnez le dépôt et la branche, et un envoi (push) déclenche le déploiement.
- Chaque autre branche peut disposer de son propre aperçu, vous permettant ainsi de vérifier une modification avant qu'elle n'atteigne
le site en production.
- Les hébergeurs statiques basés sur Git tels que Render et Azure Static Web Apps utilisent cette connexion comme source
du code du site.
En cas de problème de connexion
Un dépôt n'apparaît pas. L'accès aux dépôts configuré pour le jeton ne l'inclut pas. Modifiez le jeton sur GitHub et ajoutez le dépôt.
La connexion a fonctionné puis s'est arrêtée. Les jetons à granularité fine expirent à la date que vous avez choisie. Générez-new un nouveau jeton et connectez-le ; GitHub vous envoie un e-mail avant l'expiration d'un jeton.
Un message indique que la clé a été rejetée. C'est presque toujours l'une de ces trois causes : un espace ou un saut de ligne copié avec la clé, une clé expirée, ou une clé révoquée ou régénérée après que vous l'avez copiée. Créez-en une nouvelle et collez-la à nouveau.
La connexion s'établit, mais une action ultérieure échoue. La clé s'authentifie correctement mais il lui manque une autorisation requise par l'action. Créez une nouvelle clé dotée des autorisations listées ci-dessus, puis déconnectez l'ancienne connexion et connectez la nouvelle clé.
Déconnexion
Ouvrez Integrations, trouvez le compte et appuyez sur Disconnect. Cela supprime immédiatement la clé stockée. Tout service qui l'utilisait s'arrête lors de sa prochaine action, et les écrans qui en dépendaient l'indiquent clairement au lieu d'échouer silencieusement.
La déconnexion n'annule pas ce qui a déjà été fait — les enregistrements, les déploiements ou les paramètres que nous avons modifiés sur votre compte restent inchangés. Si vous pensez que la clé elle-même a pu être compromise, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la sienne.