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.
Pas à pas#
- Ouvrez le projet depuis Projets.
- 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 estmain; - Identifiant du responsable GitHub : le login GitHub, sans
@, de la personne à prévenir. Exemple :responsable-demo. Voir Responsable GitHub et notification.
- Dépôt GitHub (organisation/dépôt) : le nom tel qu'il apparaît dans l'adresse GitHub, sans
- 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.
- 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.
- Tapez une partie du nom dans Rechercher un dépôt. Parcourez avec les flèches, validez avec Entrée.
- Le choix remplit le nom et la branche par défaut annoncée par GitHub. Complétez le responsable GitHub.
- 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é.
- 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.
- Cliquez sur Enregistrer le dépôt.
- Pour que les issues démarrent des exécutions, réglez aussi la politique. Voir Surveillance et politique du dépôt.
- Pour que les droits GitHub soient contrôlés, un Administrateur doit lier le dépôt à la GitHub App.
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.
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.