Lier le dépôt à la GitHub App
La plateforme lit et écrit sur GitHub par l'intermédiaire d'une GitHub App. Tant qu'un dépôt n'est pas lié à son installation, aucun traitement ne démarre dessus.
Qui peut le faire : un Administrateur, avec une vérification récente.
Vérifier et rattacher#
- Ouvrez la page du dépôt.
- Dans la carte Installation GitHub App, cliquez sur Vérifier et rattacher.
- Si la vérification est récente, le serveur retrouve l'installation à partir du nom du dépôt. Aucun identifiant numérique n'est à saisir.
- Le message « Installation GitHub vérifiée et rattachée. » confirme le résultat.
Répéter la vérification sans changement répond « Installation GitHub déjà vérifiée et rattachée. » et ne crée aucune nouvelle version.
Les trois statuts#
| Statut affiché | Sens | Action |
|---|---|---|
| Connexion GitHub à vérifier | Le dépôt n'a jamais été lié. | Cliquez sur Vérifier et rattacher. |
| Installation GitHub vérifiée | Le dépôt est lié. Les droits sont recontrôlés avant chaque traitement. | Aucune. |
| Accès GitHub retiré | L'installation a été supprimée ou suspendue, ou le dépôt a été retiré de l'installation. | Rétablissez l'accès sur GitHub, puis cliquez de nouveau sur Vérifier et rattacher. |
Quand l'accès est retiré, les demandes d'exécution en attente sont annulées et les nouvelles issues sont ignorées.
Si l'App n'est pas installée sur le dépôt#
Le serveur répond « La GitHub App n'est pas installée sur ce dépôt. Installez-la sur ce dépôt, puis vérifiez de nouveau. » Un lien Installer la GitHub App sur ce dépôt s'ouvre dans un nouvel onglet. Installez l'App, puis revenez cliquer sur Vérifier et rattacher.
Dépôt renommé sur GitHub#
Après rattachement, la plateforme suit le dépôt par son identifiant GitHub. Si le dépôt est renommé sur GitHub, cliquez sur Vérifier et rattacher : le nom local est mis à jour et le message « Dépôt renommé sur GitHub : nom mis à jour et installation vérifiée. » s'affiche.
Tant que cette vérification n'a pas eu lieu, les issues du dépôt sous son nouveau nom ne sont pas reçues. Voir Réception des issues.
Repli : identifiants numériques#
La section repliable Avancé : identifiants numériques sert quand un dépôt est transféré vers une autre installation GitHub.
- Ouvrez-la.
- Saisissez Identifiant de l'installation GitHub (le nombre en fin d'adresse des réglages de l'installation) et Identifiant du dépôt GitHub (le champ « id » de l'API GitHub).
- Cliquez sur Vérifier avec ces identifiants.
Les mêmes contrôles d'identité s'appliquent : un autre dépôt GitHub n'est jamais accepté à la place du dépôt rattaché.
Permissions de la GitHub App#
La liste des dépôts et la lecture des issues utilisent les permissions de base de l'App. La liste des membres de l'organisation GitHub, qui aide à choisir le responsable GitHub, demande en plus la permission d'organisation Members en lecture. Sans elle, vous voyez le message Saisie manuelle et vous saisissez le login à la main. Un propriétaire de l'organisation GitHub doit accepter la nouvelle permission. Le détail se trouve dans GitHub App et interrupteurs.
Erreurs courantes#
| Message | Cause | Que faire |
|---|---|---|
| « Administration et vérification récente requises. » | Vous n'êtes pas Administrateur, ou la vérification date de plus de 5 minutes. | Faites une vérification récente. |
| « GitHub signale que ce dépôt a été renommé ou transféré. Corrigez le nom organisation/dépôt, puis vérifiez de nouveau. » | Le nom saisi ne correspond plus. | Corrigez le nom si le dépôt n'a jamais été lié, voir Arrêter ou corriger un dépôt. |
| « L'installation n'autorise pas ce dépôt, est suspendue, ou le dépôt est archivé ou désactivé. » | L'accès n'est pas complet. | Réglez l'installation sur GitHub. |
| « Ce dépôt GitHub est déjà rattaché ou son nom est déjà utilisé dans l'organisation. » | Doublon. | Vérifiez qu'il n'est pas déjà dans un autre projet. |
| « Vérification GitHub indisponible. » | GitHub ne répond pas. | Réessayez plus tard. |
Pour continuer#
Réglez le comportement du dépôt : Surveillance et politique du dépôt.