Commandes CLI

Aperçu

Le Fenwave Agent CLI fournit un ensemble complet de commandes pour gérer votre environnement de développement local. Toutes les commandes sont préfixées par fenwave.

fenwave --help       # Voir toutes les commandes disponibles
fenwave --version    # Afficher la version de l'agent

Commandes d’authentification

`fenwave login`

S’authentifier avec la plateforme Fenwave via OAuth dans le navigateur.

fenwave login
fenwave login --backend-url http://backstage.example.com
fenwave login --backend-url http://backstage.example.com --frontend-url http://frontend.example.com --save

Option	Description
`--backend-url <url>`	Remplacer l’URL backend pour cette session
`--frontend-url <url>`	Remplacer l’URL frontend pour cette session
`--save`	Sauvegarder les URLs fournies dans la config de l’agent

`fenwave logout`

Effacer la session stockée et se déconnecter.

fenwave logout

Si l’agent est en cours d’exécution, cela déclenche un arrêt gracieux.

Commandes de configuration initiale

`fenwave init`

Exécuter l’assistant de configuration interactif. Gère l’enregistrement de l’appareil, la vérification des prérequis et le téléchargement de l’image DevApp.

fenwave init
fenwave init --token <token> --backend-url http://backstage.example.com
fenwave init --skip-prerequisites

Option	Description
`--token <token>`	Token d’enregistrement depuis l’IDP
`--backend-url <url>`	URL backend pour l’enregistrement
`--frontend-url <url>`	URL frontend pour l’authentification
`--skip-prerequisites`	Ignorer les vérifications de version Docker/Node.js

`fenwave register`

Enregistrer votre appareil avec Backstage (autonome, sans l’assistant complet).

fenwave register --token <token>
fenwave register --token <token> --backend-url http://backstage.example.com

`fenwave rotate-credentials`

Faire pivoter les identifiants d’appareil. Génère de nouveaux identifiants et invalide les anciens.

fenwave rotate-credentials
fenwave rotate-credentials --backend-url http://backstage.example.com

`fenwave uninstall`

Supprimer la configuration et les données de l’agent de votre machine.

fenwave uninstall

Commandes de statut

`fenwave status`

Afficher l’état actuel de la session, de l’appareil et de l’agent.

fenwave status

La sortie inclut :

Session — Active/expirée, utilisateur, date d’expiration
Appareil — Enregistré/non enregistré
Agent — En cours/arrêté, port, durée de fonctionnement

`fenwave info`

Afficher les informations de l’agent et du système.

fenwave info

Commandes de service

Voir Gestion du service pour l’utilisation détaillée.

`fenwave service run`

Démarrer l’agent en mode premier plan.

fenwave service run
fenwave service run --port 3005

`fenwave service start`

Démarrer l’agent en daemon d’arrière-plan.

fenwave service start
fenwave service start --port 3005

`fenwave service stop`

Arrêter le daemon en cours.

fenwave service stop

`fenwave service restart`

Arrêter et redémarrer le daemon.

fenwave service restart
fenwave service restart --port 3005

`fenwave service status`

Afficher l’état du daemon.

fenwave service status

`fenwave service logs`

Voir les logs du daemon.

fenwave service logs
fenwave service logs -f             # Suivre en temps réel
fenwave service logs --tail 50      # 50 dernières lignes

Commandes d’applications

`fenwave apps`

Lister les applications enregistrées dans Fenwave et les groupes d’applications Docker locaux.

fenwave apps

La sortie inclut :

Name — Nom de l’application
Description — Description courte
Versions — Version(s) active(s)
Status — Statut d’exécution (running / stopped)
Published — Statut de publication (published / draft)
Containers — Nombre de conteneurs
Last Run — Dernière exécution

Commandes de conteneurs

`fenwave containers`

Lister les conteneurs Docker.

fenwave containers          # Conteneurs en cours uniquement
fenwave containers -a       # Inclure les conteneurs arrêtés
fenwave containers --all    # Identique à -a

`fenwave start`

Démarrer un ou plusieurs conteneurs arrêtés.

fenwave start <container-id>
fenwave start <id1> <id2> <id3>

`fenwave stop`

Arrêter un ou plusieurs conteneurs en cours.

fenwave stop <container-id>
fenwave stop <id1> <id2> <id3>

`fenwave restart`

Redémarrer un ou plusieurs conteneurs.

fenwave restart <container-id>

`fenwave rm`

Supprimer un ou plusieurs conteneurs arrêtés.

fenwave rm <container-id>
fenwave rm <id1> <id2>

`fenwave logs`

Voir les logs d’un conteneur.

fenwave logs <container-id>
fenwave logs <container-id> -f          # Suivre en temps réel
fenwave logs <container-id> --follow    # Identique à -f
fenwave logs <container-id> -t 100      # 100 dernières lignes
fenwave logs <container-id> --tail 100  # Identique à -t

`fenwave exec`

Exécuter une commande dans un conteneur en cours d’exécution, ou ouvrir une session shell interactive.

fenwave exec <container-id> <commande>           # Exécuter une commande ponctuelle
fenwave exec <container-id> ls -la /app          # Les arguments sont transmis
fenwave exec -i <container-id>                   # Shell interactif (/bin/sh)
fenwave exec -i <container-id> /bin/bash         # Interactif avec un shell spécifique
fenwave exec -w /app <container-id> cat config   # Définir le répertoire de travail
fenwave exec -e KEY=VAL <container-id> env       # Passer des variables d'environnement

Option	Description
`-i, --interactive`	Ouvrir une session shell interactive
`-w, --workdir`	Répertoire de travail dans le conteneur
`-e, --env`	Définir des variables d’environnement (format KEY=VALUE)

Lorsque -i est utilisé sans commande, /bin/sh est ouvert par défaut. Les options doivent apparaître avant l’identifiant du conteneur ; tout ce qui suit est traité comme la commande.

Commandes d’images

`fenwave images`

Lister les images Docker locales.

fenwave images

`fenwave pull`

Télécharger une ou plusieurs images depuis un registre.

fenwave pull <image:tag>
fenwave pull <image1:tag> <image2:tag>

`fenwave rmi`

Supprimer une ou plusieurs images locales.

fenwave rmi <image-id>
fenwave rmi <image-id> -f       # Forcer la suppression
fenwave rmi <image-id> --force  # Identique à -f

Commandes de volumes

`fenwave volumes`

Lister les volumes Docker.

fenwave volumes

`fenwave volume-create`

Créer un ou plusieurs volumes.

fenwave volume-create <nom>
fenwave volume-create <nom> -d local         # Spécifier le driver
fenwave volume-create <nom> --driver local   # Identique à -d

`fenwave volume-rm`

Supprimer un ou plusieurs volumes.

fenwave volume-rm <nom>
fenwave volume-rm <nom1> <nom2>

Commandes de configuration

Voir Configuration pour l’utilisation détaillée.

`fenwave config show`

Afficher la configuration actuelle de l’agent.

fenwave config show

`fenwave config set`

Modifier les valeurs de configuration.

fenwave config set --backend-url http://backstage.example.com
fenwave config set --frontend-url http://frontend.example.com
fenwave config set --ws-port 3005
fenwave config set --container-port 3010

`fenwave config reset`

Réinitialiser la configuration aux valeurs par défaut.

fenwave config reset

Commandes d’environnement

`fenwave local-env`

Gérer le conteneur DevApp (tableau de bord local).

fenwave local-env --start       # Démarrer le conteneur DevApp
fenwave local-env --stop        # Arrêter le conteneur DevApp
fenwave local-env --status      # Afficher l'état du conteneur
fenwave local-env --logs        # Voir les logs du conteneur
fenwave local-env --logs-follow # Suivre les logs du conteneur

`fenwave registries`

Lister les registres Docker connectés.

fenwave registries

Mode debug

Activer les logs détaillés pour la commande service run :

fenwave service run --debug

Ou via des variables d’environnement :

DEBUG=true fenwave service start
FW_VERBOSE=true fenwave service start