Embarquer une équipe sur un projet
Camille, Administrateur d'Atelier Exemple, prépare le projet Site vitrine et y fait entrer son équipe.
Objectif#
Une équipe de trois personnes travaille sur le projet Site vitrine, dont le dépôt atelier-exemple/site-vitrine est rattaché, actif et surveillé.
Rôles nécessaires#
| Personne | Rôle visé |
|---|---|
| Camille | Administrateur (déjà en place) |
| Morgan | Responsable du projet |
| Dominique | Opérateur |
| Alex | Lecteur |
Prérequis#
- L'instance est installée et la messagerie fonctionne. Voir Installer une instance de zéro.
- La GitHub App de l'instance est installée sur
atelier-exemple/site-vitrine, et ses identifiants sont configurés par l'exploitant. Voir GitHub App et interrupteurs. - Camille a fait une vérification récente : depuis Sécurité, Vérifier à nouveau mon identité. Elle dure 5 minutes ; Camille la renouvelle au besoin entre les étapes.
Étapes#
Inviter l'équipe#
- Camille ouvre Utilisateurs.
- Dans Inviter un collaborateur, elle saisit Nom du collaborateur
Morgan Exempleet Adresse e-mail du collaborateurmorgan@maintain.example, puis clique sur Créer l'invitation. - Elle répète pour
dominique@maintain.exampleetalex@maintain.example. - Les trois comptes apparaissent à l'état Invité. Chacun reçoit un e-mail, choisit son mot de passe et se connecte. Les comptes passent à Actif.
Voir Comptes et invitations.
Créer le projet#
- Camille ouvre Projets. Dans Créer un projet, elle saisit Nom du projet
Site vitrineet Identifiant courtsite-vitrine, puis clique sur Créer le projet.
Voir Portefeuille et création d'un projet.
Rattacher le dépôt#
- Sur la page du projet, dans Rattacher un dépôt, elle clique sur Afficher les dépôts de l'organisation, cherche
site-vitrinedans Rechercher un dépôt et le choisit. Le nom et la Branche par défaut se remplissent. - Dans Identifiant du responsable GitHub, elle saisit le login
responsable-demo, sans@, ou clique sur Choisir parmi les membres de l'organisation. - Elle clique sur Rattacher le dépôt. Le rattachement à la GitHub App est vérifié dans la foulée.
- Sur la page du dépôt, dans Identité et arrêt du dépôt, elle coche Autoriser les travaux sur ce dépôt, puis clique sur Enregistrer le dépôt. Un dépôt naît toujours à l'arrêt.
Voir Rattacher un dépôt et Lier le dépôt à la GitHub App.
Attribuer les rôles#
- Sur la page du projet, carte Membres du projet, elle choisit Morgan dans Compte, Responsable dans Rôle, puis clique sur Attribuer le rôle.
- Elle répète avec Dominique en Opérateur et Alex en Lecteur.
Voir Membres et rôles du projet.
Régler la surveillance#
- Morgan, désormais Responsable, fait une vérification récente, puis ouvre la page du dépôt, carte Paramètres de maintenance.
- Il coche Surveiller les nouvelles issues. Il laisse Nombre maximal d'exécutions à 1 pour commencer et règle Nombre maximal de tokens selon le budget convenu.
- Il clique sur Enregistrer les paramètres.
Voir Surveillance et politique du dépôt.
Préparer la notification avant publication#
- Camille, Administrateur, ouvre la carte Notification avant publication du dépôt. Dans Canal, elle choisit l'e-mail et, dans Compte vérifié (pour l'e-mail), le compte de Morgan. Elle clique sur Enregistrer le canal.
Voir Responsable GitHub et notification avant publication.
Résultat attendu#
| Personne | Ce qu'elle voit |
|---|---|
| Morgan | Le projet Site vitrine, la carte Paramètres de maintenance modifiable, la gestion des membres |
| Dominique | Le projet, le bouton Demander une exécution sur les issues, le lancement d'audits |
| Alex | Le projet en lecture seule |
Dans le journal des actions, filtré sur le projet, figurent la création du projet, le rattachement, les rôles et le changement de politique.
Si ça bloque#
| Symptôme | Cause probable | Voir |
|---|---|---|
| « Authentification complète et récente requise. » | Vérification de plus de 5 minutes | Session et vérification récente |
| Aucun dépôt listé | GitHub App absente de l'organisation | Lier le dépôt à la GitHub App |
| Saisie manuelle du responsable GitHub imposée | Permission Members non accordée à l'App | GitHub App et interrupteurs |
| Un compte n'apparaît pas dans Compte | Compte encore Invité | Comptes et invitations |
Pour continuer#
L'équipe est prête à traiter sa première issue : De l'issue à la PR brouillon.