Administration
Nomaflow s'exécute dans le serveur Liberty Next : son planificateur, son moteur d'exécution et son historique ne demandent aucun service séparé.
Vue d'ensemble
Stockage et limites
| Élément | Valeur |
|---|---|
| Historique des exécutions | Dans la base de données du framework, cinq tables : nomaflow_job_runs, nomaflow_step_runs, nomaflow_run_logs, nomaflow_run_overrides, nomaflow_step_run_extras. Le serveur les crée et les complète au démarrage. |
| Tâches | Le fichier des tâches plugins/nomaflow/jobs.toml, à côté du dossier de configuration — modifié depuis les pages des Tâches. |
| Journal d'exécution | Les 5 000 dernières lignes de chaque exécution sont conservées. |
| Fichiers | Les fichiers envoyés par Exécuter avec des paramètres et les fichiers de rejets des étapes file_load sont rangés dans .nomaflow/files, à côté de la configuration. |
| Taille d'envoi | 200 Mo au plus par fichier. |
Une seule instance
Exécuter une seule instance de Liberty Next : le planificateur se déclenche depuis le processus du serveur, sans verrou partagé entre instances ; deux instances lanceraient chaque tâche deux fois. Voir Liste de contrôle de production.
Redémarrage
- Les exécutions en cours à l'arrêt du serveur sont clôturées FAILED avec abandoned: process restart during run au démarrage suivant.
- Les heures planifiées tombées pendant l'arrêt sont enregistrées MISSED — voir Planifications manquées. Elles ne sont pas relancées d'elles-mêmes : les lancer à la main si besoin.
- Tâches, préréglages et politiques sont dans
jobs.toml; l'historique est en base — les deux survivent au redémarrage.
Rétention de l'historique
Le panneau Rétention de l'historique des exécutions de la page des Tâches :
| Réglage | Défaut | Signification |
|---|---|---|
| Nettoyage automatique | activé | Le nettoyage récurrent. |
| Jours conservés | 30 | Les exécutions terminées plus anciennes sont supprimées, avec leurs étapes et leurs journaux. |
| Plafond par tâche | 100 | Chaque tâche garde au plus ce nombre d'exécutions récentes. |
| Intervalle de nettoyage (min) | 60 | La fréquence du nettoyage. |
| Fichiers conservés (jours) | vide | Les fichiers plus anciens de la zone de travail sont supprimés : fichiers envoyés, rapports de rejets, rapports, exports, et archives done/ / failed/ des dossiers surveillés. Vide = Jours conservés ; 0 = garder les fichiers. Une copie écrite dans un dossier d'export n'est jamais touchée. |
Nettoyer maintenant le lance aussitôt et indique les exécutions et les fichiers supprimés. Les mêmes stockages figurent, avec leur taille, dans Surveillance → Rétention. La politique s'enregistre dans jobs.toml, sous [meta.retention].
Journal d'exécution
Chaque exécution collecte ses lignes de journal en mémoire — loggers liberty.*, lignes nomaflow et espaces de noms enregistrés par les plugins — et les écrit en base à sa fin. Le niveau est celui de l'exécution : WARNING, INFO ou DEBUG (DEBUG ajoute le SQL de chaque requête). Le journal du serveur reçoit les mêmes lignes.
Qui peut utiliser Nomaflow
Les superutilisateurs voient et font tout. Les autres utilisateurs reçoivent ce que leurs rôles accordent, dans Liberty Next → Administrer → Accès, bloc Au-delà des menus :
| Droit | Donne |
|---|---|
nomaflow → Suivre les tâches (nomaflow:view) | Les pages Tâches, Planning et Exécutions : les tâches, leurs planifications, leurs exécutions avec journaux et fichiers. |
Tâche → Toutes les tâches (job:*), ou une tâche (job:<id>) | Lancer la tâche — avec ses fichiers et paramètres — et annuler ses exécutions. |
nomaflow → Créer et modifier les tâches (nomaflow:edit) | Comprend Suivre les tâches ; créer, modifier, cloner, supprimer, suspendre et reprendre des tâches, enregistrer des préréglages. Les étapes exécutent SQL et Python sans le périmètre de données de l'utilisateur : à accorder avec prudence. |
Les règles de rétention et de planifications manquées, ainsi que l'export d'une tâche, restent réservés aux superutilisateurs. Les autres utilisateurs sont informés des tâches par les règles de notification — voir Notifications.
Sauvegarde
./liberty backup (Docker) ou liberty-ops backup (Python) sauvegarde la configuration — jobs.toml compris — et la base qui contient l'historique. Voir Exploitation.
État de santé
Le /ready du serveur répond quand la base du framework — qui contient l'historique — est joignable. La page des Tâches montre le dernier état de chaque tâche ; une règle de notification sur failure et missed est la supervision la plus simple.
Tâches courantes
| Tâche | Comment |
|---|---|
| Suspendre une tâche | Son switch activée dans la page des Tâches. |
| Déplacer une tâche vers un autre serveur | La transporter dans un package — voir Packages. Les connecteurs et requêtes utilisés doivent y exister. |
| Analyser une tâche sans arrêter les autres | La désactiver, la lancer à la main en DEBUG. |