secubox-openwrt/package/secubox/secubox-app-streamlit-launcher/README.fr.md

English | Francais | 中文

SecuBox Streamlit Launcher

Lanceur d'applications Streamlit a la demande avec arret sur inactivite et gestion de la memoire.

Presentation

Le Streamlit Launcher optimise l'utilisation des ressources sur les appareils contraints par :

• Demarrage des applications a la demande lors du premier acces (chargement paresseux)
• Arret des applications inactives apres un delai configurable (defaut : 30 min)
• Gestion de la pression memoire en arretant les applications a basse priorite quand la memoire est faible
• Systeme de priorite pour garder les applications critiques en fonctionnement plus longtemps

Architecture

+-------------+     +--------------+     +-----------------+
|   HAProxy   |---->|  mitmproxy   |---->| Streamlit       |
|   (vhost)   |     |  (WAF+track) |     | Launcher Daemon |
+-------------+     +--------------+     +--------+--------+
                           |                      |
                    Suivre acces             Start/Stop
                           |                      |
                    +------v------+         +-----v-----+
                    | /tmp/access |         |  slforge  |
                    |   (touch)   |         |  start/   |
                    +-------------+         |   stop    |
                                            +-----------+

Installation

opkg install secubox-app-streamlit-launcher

Reference CLI

# Afficher le statut
streamlit-launcherctl status

# Lister toutes les applications avec details
streamlit-launcherctl list

# Demarrer/arreter manuellement une application
streamlit-launcherctl start <app>
streamlit-launcherctl stop <app>

# Definir la priorite (plus haut = reste actif plus longtemps)
streamlit-launcherctl priority <app> <value>

# Definir toujours actif (jamais d'arret auto)
streamlit-launcherctl priority <app> 100 1

# Executer la verification d'inactivite manuellement
streamlit-launcherctl check

# Executer la verification de pression memoire
streamlit-launcherctl check-memory

Configuration

Editez /etc/config/streamlit-launcher :

config global 'global'
    # Activer le daemon launcher
    option enabled '1'

    # Activer le demarrage a la demande (vs toujours actif)
    option on_demand '1'

    # Minutes d'inactivite avant arret d'une application
    option idle_timeout '30'

    # Secondes entre les verifications d'inactivite
    option check_interval '60'

    # Memoire libre minimale (Mo) avant arret force des applications
    option memory_threshold '100'

    # Secondes max d'attente pour le demarrage d'une application
    option startup_timeout '30'

# Priorites des applications (plus haut = reste actif plus longtemps)
config priority 'control'
    option app 'control'
    option value '100'
    option always_on '1'

config priority 'ytdownload'
    option app 'ytdownload'
    option value '30'

Systeme de Priorite

Priorite	Comportement
100 + always_on	Jamais arrete automatiquement
80-99	Arrete en dernier lors de pression memoire
50 (defaut)	Priorite normale
1-49	Arrete en premier lors de pression memoire

Integration avec slforge

Le launcher fonctionne aux cotes de slforge (Streamlit Forge) :

• slforge gere la configuration, la creation et le start/stop basique des applications
• streamlit-launcherctl ajoute la gestion a la demande et de l'inactivite

Quand le mode a la demande est active :

1. L'utilisateur accede a https://app.example.com
2. HAProxy route vers mitmproxy
3. Si l'application est arretee, mitmproxy peut declencher le demarrage via hook
4. Le launcher demarre l'application et attend qu'elle soit prete
5. La requete est servie
6. L'acces est enregistre
7. Apres le delai d'inactivite, l'application est arretee

Suivi des Acces

Le launcher suit les acces aux applications via des fichiers touch dans /tmp/streamlit-access/ :

# Enregistrer un acces (reinitialise le timer d'inactivite)
streamlit-launcherctl track <app>

# Ou directement
touch /tmp/streamlit-access/<app>

Ceci peut etre declenche par :

• Hook de requete mitmproxy
• Script de health check HAProxy
• Tache cron parsant les logs d'acces

Gestion Memoire

Quand la memoire libre descend sous le seuil :

1. Les applications sont triees par priorite (plus basse en premier)
2. Les applications a basse priorite sont arretees une par une
3. S'arrete quand la memoire remonte au-dessus du seuil
4. Les applications toujours actives ne sont jamais arretees

Controle du Service

# Activer/demarrer le daemon
/etc/init.d/streamlit-launcher enable
/etc/init.d/streamlit-launcher start

# Verifier le statut du daemon
/etc/init.d/streamlit-launcher status

# Voir les logs
logread -e streamlit-launcher

Fichiers

Chemin	Description
/usr/sbin/streamlit-launcherctl	Outil CLI
/etc/config/streamlit-launcher	Configuration UCI
/etc/init.d/streamlit-launcher	Script init Procd
/tmp/streamlit-access/	Fichiers de suivi des acces
/usr/share/streamlit-launcher/loading.html	Modele de page de chargement

Exemple : Optimiser pour Faible Memoire

# Definir un delai agressif (10 min)
uci set streamlit-launcher.global.idle_timeout='10'

# Abaisser le seuil memoire (declencher le nettoyage a 150Mo libres)
uci set streamlit-launcher.global.memory_threshold='150'

# Rendre le dashboard toujours actif
streamlit-launcherctl priority dashboard 100 1

# Abaisser la priorite des applications lourdes
streamlit-launcherctl priority jupyter 20
streamlit-launcherctl priority analytics 30

uci commit streamlit-launcher
/etc/init.d/streamlit-launcher restart