Projets et dépôts

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#

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

MessageQue 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écenteFaites 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.
  4. 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#

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