---
title: Rattacher un dépôt
description: Déclarer un dépôt GitHub dans un projet, le choisir dans la liste de la GitHub App et l'autoriser à travailler.
---

# Rattacher un dépôt

Rattacher un dépôt, c'est le déclarer dans un projet : son nom GitHub, sa branche de travail et son responsable GitHub. Le dépôt démarre à l'arrêt, et vous l'autorisez ensuite à travailler.

**Qui peut le faire :** un **Responsable** du projet ou un **Administrateur** pour le formulaire. L'affichage de la liste des dépôts de la GitHub App est réservé à l'**Administrateur**, avec une [vérification récente](../01-prise-en-main/05-session-et-verification-recente.md).

## Pas à pas

1. Ouvrez le projet depuis **Projets**.
2. Dans la carte **Rattacher un dépôt**, renseignez les champs :
   - **Dépôt GitHub (organisation/dépôt)** : le nom tel qu'il apparaît dans l'adresse GitHub, sans `https://github.com/`. Exemple : `atelier-exemple/site-vitrine`. Jusqu'à 140 caractères ;
   - **Branche par défaut** : le nom exact de la branche de travail, sans `refs/heads/`. La valeur proposée est `main` ;
   - **Identifiant du responsable GitHub** : le login GitHub, sans `@`, de la personne à prévenir. Exemple : `responsable-demo`. Voir [Responsable GitHub et notification](06-responsable-github-et-notification.md).
3. Cliquez sur **Rattacher le dépôt**.

Vous arrivez sur la page du dépôt, dont le badge indique **Arrêté**.

## Choisir le dépôt dans la liste de la GitHub App

Un Administrateur peut éviter la saisie du nom. Les dépôts proposés sont ceux où la GitHub App est installée.

1. Dans la carte **Rattacher un dépôt**, section **Dépôts de l'organisation**, cliquez sur **Afficher les dépôts de l'organisation**.
2. Tapez une partie du nom dans **Rechercher un dépôt**. Parcourez avec les flèches, validez avec Entrée.
3. Le choix remplit le nom et la branche par défaut annoncée par GitHub. Complétez le responsable GitHub.
4. Cliquez sur **Rattacher le dépôt**. Le rattachement à la GitHub App est vérifié dans la foulée.

Les dépôts déjà rattachés dans l'organisation s'affichent avec « Déjà rattaché dans l'organisation » et ne se choisissent pas.

| Message | Que faire |
| --- | --- |
| « La GitHub App n'est installée nulle part » | Installez la GitHub App sur l'organisation GitHub ou sur des dépôts, puis cliquez sur **Actualiser**. |
| « Liste indisponible » avec **Faire une vérification récente** | Faites une vérification récente, puis cliquez sur **Réessayer**. |
| « La liste est partielle » | Précisez la recherche ou saisissez le nom à la main. |
| « Un dépôt absent n'a pas l'App » | Installez la GitHub App sur ce dépôt, puis cliquez sur **actualiser la liste**. |

## Autoriser le dépôt à travailler

Un dépôt rattaché ne traite rien tant qu'il est arrêté.

1. Sur la page du dépôt, dans la carte **Identité et arrêt du dépôt**, cochez **Autoriser les travaux sur ce dépôt**.
2. Cliquez sur **Enregistrer le dépôt**.
3. Pour que les issues démarrent des exécutions, réglez aussi la politique. Voir [Surveillance et politique du dépôt](05-surveillance-et-politique.md).
4. Pour que les droits GitHub soient contrôlés, un Administrateur doit [lier le dépôt à la GitHub App](04-liaison-github-app.md).

Décocher la case, ou cliquer sur **Arrêter le dépôt**, coupe immédiatement les nouveaux travaux. Voir [Arrêter ou corriger un dépôt](09-arreter-corriger-un-depot.md).

## Ce qui se passe ensuite

Le rattachement est inscrit au journal des actions. Il est unique dans l'organisation : un même dépôt ne peut pas appartenir à deux projets. Aucun travail ne démarre avant l'autorisation et la liaison à la GitHub App.

## Erreurs et refus courants

| Message | Cause | Que faire |
| --- | --- | --- |
| « Vérifiez le nom du projet, le dépôt, la branche et le responsable GitHub. » | Un champ ne respecte pas le format. | Voir les règles ci-dessous. |
| « Cet identifiant est déjà utilisé ou les réglages ont changé. Rechargez la page. » | Le dépôt est déjà rattaché dans l'organisation, ou quelqu'un a modifié le projet entre-temps. | Rechargez la page et recommencez. |
| « Ce compte GitHub n'est pas membre de l'organisation du dépôt. Choisissez un membre dans la liste. » | Le responsable GitHub ne fait pas partie de l'organisation GitHub. | Choisissez un membre. |
| « Droits insuffisants. » | Vous n'êtes ni Responsable ni Administrateur. | Demandez-le à l'un d'eux. |

Règles de format : le nom est enregistré en minuscules. L'organisation compte 39 caractères au plus, le dépôt 100. Le login du responsable compte 39 caractères au plus ; un `@` initial est retiré. La branche ne contient ni espace, ni `..`, ni caractère spécial de Git.

## Pour continuer

Liez le dépôt à GitHub : [Lier le dépôt à la GitHub App](04-liaison-github-app.md).
