Docs

Configuration Locale

À quoi sert cet écran

Local Setup installe et connecte l’agent Fenwave sur votre machine, ce qui permet au développement local de dialoguer avec la plateforme.

Avant de commencer

Pour faire ceci Il vous faut
Ouvrir l’installateur la permission d’accès local-env

Ouvrir l’écran

Tools › Local Setup.

URL directe : /agent-cli/installer

📸 Capture d’ecran : La page de l’installateur d’agent. Repères : (1) la section des prérequis, (2) le sélecteur de plateforme, (3) la commande d’installation, (4) l’état de connexion.

Aperçu

L’Agent Installer Fenwave est un outil de configuration automatisé qui installe et configure l’Agent CLI Fenwave sur votre machine locale. Il gère tout — de l’installation du package npm à l’enregistrement de l’appareil avec Backstage — dans un processus guidé directement depuis le Fenwave IDP.

Ce qui est configuré :

  • Fenwave Agent CLI installé globalement via npm
  • Appareil enregistré et authentifié avec Backstage
  • Image Fenwave DevApp téléchargée depuis GHCR

Prérequis

Avant de commencer, assurez-vous que les éléments suivants sont installés et fonctionnels sur votre machine :

Prérequis Version Notes
Node.js v20 ou supérieur Requis pour installer l’Agent CLI
Docker Toute version récente Doit être en cours d’exécution avant de démarrer l’agent

Accéder à l’Installer

Depuis la barre latérale gauche, allez dans Tools → Local Setup (Agent Installer), ou naviguez directement vers /agent-installer.

Étapes d’Installation

Étape 1 — Sélectionner votre Plateforme

Choisissez votre système d’exploitation :

  • macOS / Linux — pour les systèmes Mac et Linux
  • Windows — pour Windows 10/11

Cliquez sur Continue.

Étape 2 — Générer un Token d’Enregistrement

Cliquez sur Generate Registration Token. Un token unique et sécurisé sera généré pour votre appareil.

!!! warning “Gardez votre token en sécurité” - Le token est valable 7 jours et ne peut être utilisé qu’une seule fois - Ne le partagez pas et n’incluez pas dans le contrôle de version

Étape 3 — Télécharger et Exécuter l’Installer

Cliquez sur Download Installation Script. Le script téléchargé intègre automatiquement votre token d’enregistrement et l’URL du backend.

macOS / Linux

Ouvrez un terminal, naviguez vers votre dossier de téléchargement et exécutez :

chmod +x install-fenwave-agent.sh && ./install-fenwave-agent.sh

Windows

Ouvrez PowerShell en tant qu’Administrateur, naviguez vers votre dossier de téléchargement et exécutez :

.\install-fenwave-agent.ps1

Ce que le script fait automatiquement :

  1. Vérifie que Node.js et npm sont installés (v20+)
  2. Installe l’Agent CLI Fenwave globalement
  3. Enregistre votre appareil avec Backstage en utilisant le token intégré
  4. Télécharge l’image Fenwave DevApp depuis GHCR

Problèmes de permissions npm

Si l’installeur ne peut pas écrire dans le répertoire npm global, il vous proposera de choisir une résolution :

  1. Installer nvm (recommandé) — Utilise Node Version Manager pour des installations globales sans problèmes de permissions
  2. Configurer le répertoire utilisateur npm — Redirige les installations globales vers ~/.npm-global (Linux/macOS) ou %APPDATA%\npm (Windows)
  3. Utiliser sudo / Exécuter en tant qu’Administrateur — Non recommandé en raison des risques de sécurité et des problèmes potentiels de propriété des fichiers

Étape 4 — Démarrer l’Agent

Une fois le script terminé, démarrez l’agent :

# Démarrer en mode arrière-plan (recommandé)
fenwave service start

# Démarrer en mode premier plan (logs affichés dans le terminal)
fenwave service run

L’URL du tableau de bord Fenwave DevApp sera affichée après la connexion. Par défaut : http://localhost:3003 (le port peut varier).

Commandes Utiles

Commande Description
fenwave status Vérifier l’état de la session, de l’appareil et de l’agent
fenwave login S’authentifier avec Fenwave
fenwave logout Effacer la session stockée et se déconnecter
fenwave rotate-credentials Faire pivoter les identifiants de l’appareil
fenwave --help Voir toutes les commandes disponibles

Ce qui a été Configuré Automatiquement

Après une installation réussie, les éléments suivants sont configurés sur votre machine :

  • Appareil enregistré avec Backstage
  • URL du backend configurée
  • Image Fenwave DevApp téléchargée depuis GHCR

Pour enregistrer un autre appareil, retournez à l’installer et cliquez sur Register Another Device.

Scénario

Préparer une machine qui vient de vous être remise.

  1. Lisez les prérequis avant de lancer quoi que ce soit. La plupart des installations échouées tiennent à un prérequis que personne n’a vérifié, et elles échouent tardivement.
  2. Lancez l’installateur depuis Tools › Local Setup.
  3. Authentifiez l’agent — voir Agent Fenwave › Authentification.
  4. Vérifiez la connexion plutôt que de la supposer. Un agent installé mais jamais connecté est indiscernable d’un agent fonctionnel, jusqu’au moment où vous en avez besoin.
  5. Si vous utilisez l’application de bureau, connectez-la — voir Connexion DevApp.
  6. En cas de problème ultérieur, commencez par Dépannage de l’agent. Les problèmes locaux sont locaux : ce n’est pas la plateforme hébergée, et y chercher d’abord fait perdre l’après-midi.

En cas de problème

Symptôme Cause Comment vérifier Solution
Local Setup n’est pas dans le sous-menu Il manque la permission d’accès local-env Access Explorer Demandez un rôle qui l’accorde
L’installateur échoue en cours de route Un prérequis non satisfait La section des prérequis Satisfaites-le, puis relancez
L’agent est installé mais rien ne se connecte Il n’a jamais été authentifié Authentification Authentifiez-le
Le local fonctionne, la plateforme ne le voit pas L’agent n’est pas connecté Dépannage Reconnectez l’agent

Pour aller plus loin