Gestion du Service

Aperçu

L’Agent Fenwave peut fonctionner dans deux modes :

  • Mode premier plan — S’exécute dans votre terminal, affiche les logs directement, s’arrête quand vous fermez le terminal
  • Mode arrière-plan — S’exécute silencieusement en arrière-plan, persiste après la fermeture du terminal

Mode premier plan

Idéal pour une utilisation ponctuelle, le débogage ou pour voir ce que fait l’agent :

fenwave service run

Appuyez sur Ctrl+C pour arrêter.

Port personnalisé

fenwave service run --port 3005

Mode arrière-plan

Idéal pour une utilisation quotidienne :

fenwave service start

L’agent s’exécute silencieusement en arrière-plan. Fermez votre terminal — l’agent continue de fonctionner.

Commandes du service

Commande Description
fenwave service start Démarrer l’agent en arrière-plan
fenwave service stop Arrêter l’agent en cours
fenwave service restart Arrêter et redémarrer l’agent
fenwave service status Afficher le statut actuel (en cours, port, durée)
fenwave service logs Voir les logs de l’agent
fenwave service start --port 3005        # Démarrer sur un port spécifique
fenwave service logs -f                   # Suivre les logs en temps réel
fenwave service logs --tail 50            # Afficher les 50 dernières lignes

Avant de démarrer

L’agent vérifie quelques éléments avant de démarrer :

  1. Vous êtes authentifié à Fenwave
  2. Votre session n’a pas expiré
  3. Votre appareil est enregistré
  4. Docker est en cours d’exécution

Si une vérification échoue, un message clair vous indique quoi faire.

Arrêt

L’agent s’arrête toujours proprement :

  • Il notifie le tableau de bord DevApp (qui se reconnecte automatiquement au prochain démarrage)
  • Il attend que les opérations actives se terminent avant de fermer
  • Il arrête le conteneur DevApp

L’arrêt est déclenché par fenwave service stop, Ctrl+C (mode premier plan), ou quand votre session expire.

Gestion des logs

Les logs de l’agent sont écrits dans ~/.fenwave/logs/ :

Fichier Contenu
agent.log Log d’activité complet
agent.error.log Erreurs uniquement

Les logs pivotent automatiquement quand un fichier atteint 10 Mo (conserve jusqu’à 5 archives).

fenwave service logs               # Voir les logs récents
fenwave service logs -f            # Suivre en temps réel
fenwave service logs --tail 100    # 100 dernières lignes