Projets
À quoi sert cet écran
L’onglet Projects déclare ce que votre organisation construit. Un projet (un système) regroupe des composants, et ce sont les composants qui apparaissent dans le Catalogue avec un propriétaire et un type.
C’est ainsi qu’un dépôt cesse d’être une ligne dans une table de configuration pour devenir quelque chose qu’un développeur peut trouver.
Avant de commencer
| Pour faire ceci | Il vous faut |
|---|---|
| Voir l’onglet | platform-settings.project.read |
| Ouvrir le détail d’un projet | platform-settings.project.view-details |
| Créer un projet | platform-settings.project.create |
| Le modifier | platform-settings.project.update |
| Le supprimer | platform-settings.project.delete |
| Définir le groupe propriétaire | platform-settings.project.assign-owner |
| Lier ou délier des composants | platform-settings.project.manage-components |
Créez d’abord le groupe propriétaire : un projet sans propriétaire produit des entrées de catalogue dont personne n’est responsable.
Ouvrir l’écran
- Settings › Development
- Sélectionnez l’onglet Projects (ouvert par défaut).
L’interface
📸 Capture d’écran : L’onglet Projects avec le tableau des systèmes et celui des composants. Repères : (1) le tableau des systèmes, (2) le tableau des composants, (3) la colonne du groupe propriétaire, (4) le type de composant, (5) l’action lier/délier.
| # | Élément | Ce qu’il fait | Quand l’utiliser |
|---|---|---|---|
| 1 | Tableau des systèmes | Les projets eux-mêmes | Créer ou renommer un projet |
| 2 | Tableau des composants | Les composants, chacun rattaché à un système | Ajouter un service ou une bibliothèque |
| 3 | Groupe propriétaire | Quel groupe possède l’entrée | Établir la responsabilité |
| 4 | Type de composant | De quelle nature est l’élément | Rendre les filtres du catalogue utiles |
| 5 | Lier / délier | Rattache un composant à un système, ou l’en détache | Réorganiser à mesure que le parc grandit |
Composants et systèmes sont deux tableaux distincts sur un même onglet. Un composant peut exister sans être rattaché à un système : il apparaîtra alors dans le catalogue sans parent, ce qui n’est généralement pas souhaité.
Procédures
Créer un projet et son premier composant
Nécessite platform-settings.project.create et .manage-components.
- Settings › Development › Projects.
- Créez le système et définissez son groupe propriétaire.
- Ajoutez un composant : nommez-le, choisissez son type et rattachez-le au système.
- Vérifiez dans le Catalogue : il doit y figurer avec le bon propriétaire.
Transférer un projet à une autre équipe
Nécessite platform-settings.project.assign-owner.
- Ouvrez le projet et changez le groupe propriétaire.
- Vérifiez les composants : ils peuvent porter leur propre propriété et ne pas suivre automatiquement le système.
Détacher un composant
Nécessite platform-settings.project.manage-components.
Délier ne supprime pas le composant. Il subsiste, sans système parent : rattachez-le ailleurs dans la foulée ou supprimez-le.
Scénario
Un nouveau service doit apparaître dans le catalogue, possédé par la bonne équipe.
- Vérifiez que le groupe propriétaire existe dans Personnes et accès › Groupes. Créez-le sinon.
- Settings › Development › Projects — si le service appartient à un projet existant, passez à l’étape 3 ; sinon créez le système et définissez son propriétaire.
- Ajoutez le composant. Choisissez le type correspondant à sa nature réelle : c’est ce qui rendra les filtres du catalogue utiles par la suite.
- Rattachez-le au système.
- Ouvrez le Catalogue et vérifiez qu’il apparaît avec le bon propriétaire.
- Si le service dispose de documentation, elle a désormais où se rattacher.
Faire l’étape 1 en dernier est l’erreur classique : un composant créé avant l’existence de son groupe se retrouve sans propriétaire, et personne ne s’en aperçoit avant que quelqu’un ait une question à poser à son sujet.
En cas de problème
| Symptôme | Cause | Comment vérifier | Solution |
|---|---|---|---|
| Le composant n’apparaît pas dans le catalogue | Non rattaché à un système, ou catalogue non rafraîchi | Le tableau des composants | Rattachez-le à un système ; attendez le rafraîchissement |
| Le composant n’affiche aucun propriétaire | Son système n’a pas de groupe propriétaire, ou le composant est délié | La colonne du propriétaire | Définissez le propriétaire sur le système et rattachez le composant |
| Impossible de changer le propriétaire | Exige platform-settings.project.assign-owner, distinct de .update |
Access Explorer | Demandez un rôle qui l’accorde |
| Le groupe propriétaire manque dans le sélecteur | Le groupe n’existe pas | Groupes | Créez-le, puis rouvrez le projet |
| Système supprimé, les composants subsistent | Supprimer un système ne supprime pas ses composants | Le tableau des composants | Rattachez-les ailleurs ou supprimez-les explicitement |