Interface de contrôle texte de Stamina
Stamina expose une interface de contrôle texte, par défault l’interface est exposée sur le port 8888 et uniquement sur l’interface réseau locale.
Les paramètres NONSTOP_SERVICE_BIND_IFACE (par défaut 127.0.0.1) et NONSTOP_SERVER_BIND_PORT (par défaut 8888) permettent de modifier cela.
Les commandes reconnues sont :
status pour obtenir une information sur le morceau en cours,
softquit pour demander l’arrêt à la fin du morceau en cours,
hardquit pour demander l’arrêt immédiat.
Un point (.) seul permet de clôturer une session.
Le "softquit" est particulièrement utile avec la configuration par défaut où le service est configuré pour redémarrer automatiquement, cela permet de programmer un redémarrage automatique, pour prendre en compte une nouvelle version ou des nouveaux paramètres, sans couper de morceau.
Exemple de session en utilisant la commande nc
pour se connecter :
$ nc localhost 8888
Watusi!
Known commands: status, softquit, hardquit
(dot on empty line to stop connection)
status
{"slot": "Diffusion of D\u00e9senvo\u00fbtons le pouvoir de la finance sur notre sant\u00e9 ! at 19:00", "next_diffusion": {"label": "Diffusion of Claire Serres : The Waves Choir at 23:00", "start_datetime": "2022-07-21 23:00:00", "emission": "L\u2019Heure de Pointe", "episode": "Claire Serres : The Waves Choir"}}
.
{"ack": true}