Projets et dépôts

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#

  1. Ouvrez la page du dépôt.
  2. Dans la carte Installation GitHub App, cliquez sur Vérifier et rattacher.
  3. 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.
  4. 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éSensAction
Connexion GitHub à vérifierLe dépôt n'a jamais été lié.Cliquez sur Vérifier et rattacher.
Installation GitHub vérifiéeLe 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.

  1. Ouvrez-la.
  2. 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).
  3. 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#

MessageCauseQue 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.