Exemples de mise en place

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#

PersonneRôle visé
CamilleAdministrateur (déjà en place)
MorganResponsable du projet
DominiqueOpérateur
AlexLecteur

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#

  1. Camille ouvre Utilisateurs.
  2. Dans Inviter un collaborateur, elle saisit Nom du collaborateur Morgan Exemple et Adresse e-mail du collaborateur morgan@maintain.example, puis clique sur Créer l'invitation.
  3. Elle répète pour dominique@maintain.example et alex@maintain.example.
  4. 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#

  1. Camille ouvre Projets. Dans Créer un projet, elle saisit Nom du projet Site vitrine et Identifiant court site-vitrine, puis clique sur Créer le projet.

Voir Portefeuille et création d'un projet.

Rattacher le dépôt#

  1. Sur la page du projet, dans Rattacher un dépôt, elle clique sur Afficher les dépôts de l'organisation, cherche site-vitrine dans Rechercher un dépôt et le choisit. Le nom et la Branche par défaut se remplissent.
  2. Dans Identifiant du responsable GitHub, elle saisit le login responsable-demo, sans @, ou clique sur Choisir parmi les membres de l'organisation.
  3. Elle clique sur Rattacher le dépôt. Le rattachement à la GitHub App est vérifié dans la foulée.
  4. 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#

  1. 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.
  2. Elle répète avec Dominique en Opérateur et Alex en Lecteur.

Voir Membres et rôles du projet.

Régler la surveillance#

  1. Morgan, désormais Responsable, fait une vérification récente, puis ouvre la page du dépôt, carte Paramètres de maintenance.
  2. 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.
  3. Il clique sur Enregistrer les paramètres.

Voir Surveillance et politique du dépôt.

Préparer la notification avant publication#

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

PersonneCe qu'elle voit
MorganLe projet Site vitrine, la carte Paramètres de maintenance modifiable, la gestion des membres
DominiqueLe projet, le bouton Demander une exécution sur les issues, le lancement d'audits
AlexLe 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ômeCause probableVoir
« Authentification complète et récente requise. »Vérification de plus de 5 minutesSession et vérification récente
Aucun dépôt listéGitHub App absente de l'organisationLier le dépôt à la GitHub App
Saisie manuelle du responsable GitHub imposéePermission Members non accordée à l'AppGitHub App et interrupteurs
Un compte n'apparaît pas dans CompteCompte encore InvitéComptes et invitations

Pour continuer#

L'équipe est prête à traiter sa première issue : De l'issue à la PR brouillon.