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.

  1. Settings › General — appliquez la clé de licence, réglez l’habillage et le contact support.
  2. 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.
  3. Settings › Infrastructure › Cloud — enregistrez le compte cloud et validez-le.
  4. Settings › Infrastructure › Clusters — enregistrez les clusters et validez chacun. Préférez IRSA, Pod Identity ou Workload Identity à un jeton statique.
  5. 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.
  6. Settings › Development › Repositories — connectez les dépôts Git et validez-les. Avec SSH, installez la clé publique comme deploy key chez le fournisseur.
  7. 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.
  8. Settings › Development › Projects — déclarez projets et composants pour qu’ils apparaissent dans le catalogue avec des propriétaires.
  9. Settings › People & Access › Policies — maintenant que clusters et environnements existent, créez des policies cantonnées et les rôles qui les portent.
  10. 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

  1. My Space › Mon profil — vérifiez votre compte et réglez votre langue.
  2. My Space › Mes groupes — vérifiez le groupe de votre équipe.
  3. Explore › Catalogue — trouvez les composants de votre équipe.
  4. Explore › Architecture — voyez comment ils s’articulent.
  5. Build › Créer une application — si vous démarrez quelque chose de nouveau.
  6. Deploy › Dev — créez un environnement éphémère pour votre branche et déployez.
  7. 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.

  1. Déroulez les étapes 1 à 8 de la mise en place administrateur.
  2. Créez une policy cantonnée — permissions de déploiement, limitées au cluster de dev avec la condition d’environnement fixée à dev.
  3. Créez un rôle Developer ne portant que cette policy. N’attribuez pas admin comme raccourci : il contourne entièrement les policies et récupère tout cluster ajouté ultérieurement.
  4. Ajoutez un développeur avec ce rôle et le profil Dev.
  5. Faites-lui suivre les premiers pas développeur.
  6. 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.
  7. 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