Responsable GitHub et notification avant publication
Avant d'écrire sur GitHub, 101Maintain prévient une personne : le responsable GitHub du dépôt. Deux réglages la concernent : son identifiant, puis le canal de la notification.
Qui peut le faire : l'identifiant se règle par un Responsable ou un Administrateur. Le canal de notification est réservé à l'Administrateur, avec une vérification récente.
Indiquer le responsable GitHub#
Le champ Identifiant du responsable GitHub figure dans le formulaire Rattacher un dépôt ou, plus tard, dans Identité et arrêt du dépôt. La personne désignée reçoit la notification avant publication et la demande de revue sur les PR brouillon.
- Saisissez le login sans
@. Exemple :responsable-demo. Il compte 40 caractères au plus. - Ou cliquez sur Choisir parmi les membres de l'organisation, puis cherchez dans Rechercher un membre de l'organisation. Le choix remplit le champ.
- Enregistrez avec Rattacher le dépôt ou Enregistrer le dépôt.
À l'enregistrement, la plateforme vérifie que le login est membre de l'organisation GitHub du dépôt. Sinon : « Ce compte GitHub n'est pas membre de l'organisation du dépôt. Choisissez un membre dans la liste. »
Un dépôt sans identifiant affiche À renseigner sur sa page : complétez le champ et enregistrez.
Quand la liste des membres n'est pas disponible#
Le message Saisie manuelle apparaît alors, avec l'une de ces raisons :
| Raison affichée | Que faire |
|---|---|
| La GitHub App n'a pas la permission « Members : lecture » sur l'organisation | Un propriétaire de l'organisation GitHub doit accepter la permission. Saisissez le login en attendant. Voir GitHub App et interrupteurs. |
| Le dépôt appartient à un compte personnel | GitHub n'a pas de liste de membres. Saisissez le login. |
| La GitHub App n'est pas installée sur l'organisation | Installez-la, ou saisissez le login. |
| La GitHub App n'est pas configurée sur ce serveur | Saisissez le login. |
| Le dépôt n'est pas encore renseigné | Saisissez d'abord Dépôt GitHub (organisation/dépôt). |
La liste est limitée à 500 membres. Si elle est partielle, un message l'indique : saisissez alors le login à la main.
Choisir le canal de notification#
La carte Notification avant publication apparaît sur la page du dépôt pour un Administrateur.
- Dans Canal, choisissez :
- E-mail du responsable : la notification part par e-mail à un compte 101Maintain vérifié ;
- Webhook d'équipe : elle part sur le canal d'équipe configuré sur le serveur par l'exploitant.
- Pour l'e-mail, choisissez le compte dans Compte vérifié (pour l'e-mail). Il doit être actif, avoir une adresse vérifiée et un accès au projet. Avec le webhook, ce champ est ignoré.
- Cliquez sur Enregistrer le canal.
Ce qui se passe ensuite#
Avant chaque écriture sur GitHub (PR brouillon, correctif, demande de revue), la plateforme envoie la notification, puis attend l'accusé du canal. Il n'y a pas de clic d'approbation : la notification informe, elle ne demande pas d'autorisation. Les états du reçu et leurs effets sont décrits dans Notification avant publication.
Si le responsable GitHub, le canal ou la politique change entre-temps, l'écriture préparée est bloquée. Un message renvoyé par le fournisseur d'e-mail comme non délivré empêche aussi l'écriture.
Erreurs et refus courants#
| Message | Cause | Que faire |
|---|---|---|
| « Configuration indisponible, refusée ou modifiée. » | Vous n'êtes pas Administrateur, la vérification récente manque, le compte choisi n'est pas valable, ou la configuration a changé entre-temps. | Faites une vérification récente, rechargez la page, choisissez un autre compte. |
| « Droits insuffisants. » | Vous n'êtes ni Responsable ni Administrateur. | Demandez-le à l'un d'eux. |
| Canal E-mail du responsable sans compte choisi | Le compte est obligatoire pour l'e-mail. | Choisissez un compte dans la liste. |
Pour continuer#
Réglez les rôles de l'équipe : Membres et rôles du projet.