Docs

À propos de la plateforme

À quoi sert cette page

Ce qu’est Fenwave, comment ses pièces s’assemblent, et où vivent les valeurs d’identité de la plateforme. Il s’agit de contexte plutôt que d’une tâche : à lire quand vous voulez la forme de l’ensemble plutôt qu’une procédure.

Avant de commencer

Rien. Cette page décrit la plateforme, elle ne la configure pas.

La plateforme

Fenwave est une plateforme de développement interne bâtie sur Backstage. Elle réunit quatre préoccupations qui vivent d’ordinaire dans quatre outils différents :

Préoccupation Ce que fournit Fenwave
Savoir ce qui existe Un catalogue de composants, systèmes et APIs avec leurs propriétaires, et une documentation servie à côté du code
Créer Des modèles qui génèrent un dépôt, câblent la CI/CD et enregistrent le résultat
Exploiter Des paliers d’environnement, des releases avec runbooks, et un accès direct au cluster
Gouverner Un contrôle d’accès par rôles, cantonné à des clusters et environnements précis

La valeur ne tient à aucune de ces quatre prises isolément. Elle tient au fait qu’elles renvoient au même registre : le composant que vous trouvez dans le catalogue est celui que vous déployez, et la permission qui vous autorise à le déployer est cantonnée au cluster sur lequel il tourne.

Comment les pièces s’articulent

Settings › Infrastructure     les clusters et environnements s'enregistrent ici
        ↓
Settings › Development        dépôts et CI/CD s'y connectent
        ↓
Build                         les modèles créent des composants sur cette base
        ↓
Explore                       les composants apparaissent au catalogue avec leurs propriétaires
        ↓
Deploy                        les composants tournent dans les environnements enregistrés
        ↓
Cost / Analytics              ce que cela coûte et comment cela se passe

Lu de haut en bas, c’est aussi l’ordre de mise en place d’une installation neuve — voir le Guide de démarrage rapide.

Où vivent la version et les informations de support

Le nom de la plateforme, sa version, son slogan, sa description, l’URL de documentation et le contact support s’affichent dans Settings › General. Ils ne sont volontairement pas repris ici : une valeur recopiée dans la documentation est une valeur qui se périme en silence.

Procédures

Rien à exécuter ici. Pour savoir de quoi la plateforme est faite, voir Composants.

Scénario

Présenter Fenwave à quelqu’un qui hésite à l’adopter.

  1. Commencez par le tableau ci-dessus — quatre préoccupations, un seul registre. C’est le registre unique qui distingue une plateforme de quatre outils reliés par des liens.
  2. Montrez-lui Explore › Catalogue filtré sur un propriétaire : c’est la réponse au « qu’est-ce qu’on a » qu’il obtient aujourd’hui en demandant autour de lui.
  3. Montrez Explore › Architecture sur le même ensemble. La question du périmètre d’impact est généralement celle qui porte.
  4. Montrez Settings › People & Access › Policies et le cantonnement par cluster et environnement. Une gouvernance réelle plutôt qu’affichée est ce qui sépare ceci d’un wiki.
  5. Soyez honnête sur le coût : tout ce qui précède dépend de choses enregistrées. Un composant que personne n’enregistre est invisible partout. La plateforme récompense cette discipline, et ne fait rien sans elle.

En cas de problème

Symptôme Cause Comment vérifier Solution
Le catalogue est presque vide Les composants n’ont pas été enregistrés Projets Enregistrez-les
Deploy n’affiche rien Aucun cluster ni environnement enregistré Infrastructure Enregistrez-les et validez-les
La version affichée n’est pas celle attendue Elle vient du build déployé, pas d’un réglage Settings › General Vérifiez quelle image est déployée

Pour aller plus loin