Guide de démarrage rapide
À quoi sert cette page
Le chemin utile le plus court dans Fenwave, en deux parcours : mettre la plateforme en place en tant qu’administrateur, et devenir productif en tant que développeur. Suivez celui qui correspond à votre métier.
Avant de commencer
Vous êtes connecté — voir Accéder à la plateforme. Au-delà, les deux parcours ont des prérequis distincts, indiqués dans chacun.
Les deux parcours
| Vous êtes | Commencez par | Vous obtenez |
|---|---|---|
| Administrateur sur une installation neuve | Mise en place administrateur | Une plateforme utilisable par vos développeurs |
| Développeur rejoignant une équipe | Premiers pas développeur | Un changement qui tourne en dev |
Mise en place administrateur
L’ordre compte — chaque étape consomme ce que la précédente a produit. Procéder dans le désordre est l’erreur classique du premier jour.
- Settings › General — appliquez la clé de licence, réglez l’habillage et le contact support.
- Settings › People & Access — ajoutez les administrateurs qui feront le reste. Créez d’abord leurs rôles ; un utilisateur sans rôle se connecte sur une plateforme vide.
- Settings › Infrastructure › Cloud — enregistrez le compte cloud et validez-le.
- Settings › Infrastructure › Clusters — enregistrez les clusters et validez chacun. Préférez IRSA, Pod Identity ou Workload Identity à un jeton statique.
- Settings › Infrastructure › Environments — créez dev, staging et production sur ces clusters. Tant qu’ils n’existent pas, aucune policy ne peut y être cantonnée.
- Settings › Development › Repositories — connectez les dépôts Git et validez-les. Avec SSH, installez la clé publique comme deploy key chez le fournisseur.
- Settings › Development › CI/CD — connectez à la fois Argo CD et Argo Workflows. Les déploiements utilisent l’un, les pipelines l’autre ; n’en connecter qu’un laisse la moitié de la plateforme inerte. Testez chacun.
- Settings › Development › Projects — déclarez projets et composants pour qu’ils apparaissent dans le catalogue avec des propriétaires.
- Settings › People & Access › Policies — maintenant que clusters et environnements existent, créez des policies cantonnées et les rôles qui les portent.
- Vérifiez avec Access Explorer avant d’annoncer que c’est prêt.
L’étape 9 doit suivre les étapes 4 et 5 : une policy ne peut pas être cantonnée à un cluster ou un environnement inexistant, et une policy sans portée accorde tout.
Premiers pas développeur
- My Space › Mon profil — vérifiez votre compte et réglez votre langue.
- My Space › Mes groupes — vérifiez le groupe de votre équipe.
- Explore › Catalogue — trouvez les composants de votre équipe.
- Explore › Architecture — voyez comment ils s’articulent.
- Build › Créer une application — si vous démarrez quelque chose de nouveau.
- Deploy › Dev — créez un environnement éphémère pour votre branche et déployez.
- Détail d’un environnement — lisez Events avant Application Logs. Events vous dit si la plateforme a réussi ; les logs ne comptent qu’ensuite.
Scénario
D’une installation vide à un développeur qui livre en dev, en une après-midi.
- Déroulez les étapes 1 à 8 de la mise en place administrateur.
- Créez une policy cantonnée — permissions de déploiement, limitées au cluster
de dev avec la condition d’environnement fixée à
dev. - Créez un rôle
Developerne portant que cette policy. N’attribuez pasadmincomme raccourci : il contourne entièrement les policies et récupère tout cluster ajouté ultérieurement. - Ajoutez un développeur avec ce rôle et le profil Dev.
- Faites-lui suivre les premiers pas développeur.
- Quand il signale qu’il ne peut pas faire quelque chose, utilisez Access Explorer avec son nom d’utilisateur et la permission exacte du message d’erreur — pas une description de sa tentative.
- Une fois le parcours complet prouvé avec une personne, le reste n’est que répétition.
Prouver le chemin entier avec une personne avant d’en intégrer dix est ce qui transforme une longue après-midi en une courte.
En cas de problème
| Symptôme | Cause | Comment vérifier | Solution |
|---|---|---|---|
| Un développeur se connecte sur une plateforme vide | Aucun rôle attribué | Access Explorer | Attribuez un rôle portant des policies |
| Les pipelines ne démarrent jamais | Argo Workflows non connecté ou non testé | CI/CD | Ajoutez-le et testez-le — séparément d’Argo CD |
| Le clone échoue | Dépôt jamais validé, ou clé SSH non installée chez le fournisseur | Dépôts | Validez ; ajoutez la deploy key |
| Impossible de cantonner une policy | Clusters ou environnements pas encore enregistrés | Infrastructure | Enregistrez-les, puis modifiez la policy |
| Un développeur atteint la production | Un statement de policy sans portée | Policies | Ajoutez la condition d’environnement |
| Permission accordée, aucun changement | Cache de permissions de la session | — | Faites-lui recharger la page |
Pour aller plus loin
- Paramètres — la référence administrateur complète
- Deploy — la surface quotidienne du développeur