Connectez votre compte GitHub à l’aide d’un jeton afin que vos sites soient déployés depuis un dépôt

Ce que cette connexion vous apporte

Connecter GitHub avec un jeton permet à un site d’être déployé depuis l’un de vos dépôts : publiez sur la branche et le site se met à jour. Cela nous permet également de publier sur GitHub Pages sur votre compte lorsque vous le choisissez comme hébergeur d’un site.

Si vos dépôts appartiennent à une organisation, préférez l’application GitHub Zinn® — consultez Installer l’application GitHub Zinn®. Un jeton appartient à une seule personne et cesse de fonctionner lorsqu’elle s’en va.

Avant de commencer

Un compte GitHub avec accès aux dépôts que vous souhaitez déployer. S’ils appartiennent à une organisation, un propriétaire devra peut-être approuver les 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 — l’accès le plus restreint qui fonctionne.

Sous Repository permissions, accordez Read and write sur :

• Contents
• Pages
• Administration

Appuyez sur Generate token et copiez-le — GitHub ne l’affiche qu’une seule fois.

2. La connecter 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 que quoi que ce soit ne soit enregistré. Une clé qui ne fonctionne pas n’est jamais stockée, et la réponse indique ce qui n’allait pas. Une clé fonctionnelle est conservée sous forme chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n’est plus jamais affichée, même à vous.

Ce qui se passe ensuite

• Un site peut être déployé directement depuis un dépôt sur ce compte : choisissez-le sur la connexion de dépôt du site, sélectionnez le dépôt et la branche, et un push déclenche le déploiement.
• Toutes les autres branches peuvent obtenir leur propre aperçu, ce qui vous permet 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 d’échec de la connexion

Un dépôt n’apparaît pas. L’accès aux dépôts défini pour le jeton ne l’inclut pas. Modifiez le jeton sur GitHub et ajoutez le dépôt.

Cela fonctionnait, puis s’est arrêté. Les jetons à granularité fine expirent à la date que vous avez choisie. Générez-en un nouveau et connectez-le ; GitHub vous envoie un e-mail avant qu’un jeton n’expire.

Un message indique que la clé a été rejetée. Il s’agit presque toujours de 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 réussit, mais une action ultérieure échoue. La clé s’authentifie mais ne dispose pas d’une autorisation requise pour l’action. Créez une nouvelle clé avec les autorisations indiquées ci-dessus, puis déconnectez l’ancienne connexion et associez la nouvelle clé.

Déconnexion

Ouvrez Integrations, trouvez le compte et appuyez sur Disconnect. Cela supprime immédiatement la clé stockée. Tout élément qui l’utilisait s’arrête à sa prochaine action, et les écrans qui en dépendaient l’indiquent au lieu d’échouer silencieusement.

La déconnexion n’annule pas ce qui a déjà été fait — les enregistrements, déploiements ou paramètres que nous avons modifiés sur votre compte restent tels quels. Si vous pensez que la clé elle-même a pu fuiter, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la leur.