---
title: Lier le dépôt à la GitHub App
description: Vérifier et rattacher l'installation de la GitHub App, comprendre les statuts et utiliser le repli par identifiants.
---

# 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](../01-prise-en-main/05-session-et-verification-recente.md).

> [!NOTE]
> La GitHub App est configurée par l'exploitant. Voir [GitHub App et interrupteurs](../08-deploiement-et-exploitation/06-github-app-et-fonctionnalites.md). Si l'App n'est pas configurée, la vérification affiche « GitHub App doit être configurée sur le serveur. »

## 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é | 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](08-reception-des-issues.md).

## 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](../08-deploiement-et-exploitation/06-github-app-et-fonctionnalites.md).

## 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](09-arreter-corriger-un-depot.md). |
| « 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](05-surveillance-et-politique.md).
