Skip to main content

Configuration du runner

Le runner ne lit pas de fichier de configuration dédié : tout passe par des variables d'environnement, éventuellement posées dans des fichiers .env.

Ordre de priorité​

Du plus fort au plus faible :

  1. les variables du shell (environnement système) ;
  2. le fichier .env du répertoire de travail du runner (typiquement à côté du binaire) ;
  3. le fichier .env.<environnement> (par exemple .env.production si APP_ENV=production ; .env.dev par défaut) ;
  4. les valeurs par défaut embarquées dans le binaire à la compilation.

Une variable déjà définie n'est jamais écrasée par un fichier de priorité inférieure.

Variables​

VariableDéfautDescription
API_URLhttp://localhost:4321/apiURL de l'API du serveur Fluhoms. La seule variable indispensable en pratique.
PORT2024Port de l'API HTTP locale du runner (utilisée par la CLI et l'interface de contrôle).
LISTEN_HOSTlocalhostInterface d'écoute de l'API locale.
APP_ENVdevelopmentEnvironnement d'exécution (development, production…). Pilote le niveau de log et le fichier .env.<environnement> chargé.
DEBUG(vide)Toute valeur non vide active le mode debug.
FLUHOMS_AGENT_DATA_PATH(vide)Remplace le répertoire de données par défaut (utile en Docker ou déploiement personnalisé).
FLUHOMS_PYTHON_PATHauto-détectéRacine de l'environnement Python (conda-pack) utilisé pour l'exécution des pipelines. Détecté automatiquement selon l'OS si non défini.
FLUHOMS_PYTHON_BINauto-détectéChemin complet de l'exécutable Python. Déduit de FLUHOMS_PYTHON_PATH si non défini.
FLUHOMS_ETL_LOCAL(vide)Chemin local des scripts ETL (usage développement) : court-circuite le téléchargement des composants depuis le serveur.
UPDATE_URL(vide)URL du service de mise à jour interrogée par fluhoms-runner update.
FLUHOMS_JOURNAUX_RETENTION_HEURES168Âge au-delà duquel un journal d'exécution gardé en local est oublié. 0 désactive la règle.
FLUHOMS_JOURNAUX_BUDGET_MO512Taille maximale du dossier des journaux. 0 désactive la règle.
FLUHOMS_JOURNAUX_ESPACE_LIBRE_MIN_MO1024Plancher de place libre sur le volume : en dessous, les journaux sont supprimés du plus ancien au plus récent jusqu'à repasser au-dessus. 0 désactive la règle.
FLUHOMS_JOURNAUX_ENTRETIEN_MINUTES60Cadence de la routine de ménage. 0 la désactive — le ménage n'a alors lieu qu'au démarrage.
Les journaux gardés en local

Ce sont ceux que le runner n'a pas pu déposer sur la plateforme : il supprime les autres dès l'envoi acquitté. Ce sont donc leurs seules copies, et les trois bornes ci-dessus décident à regret. Voir Gérer les runners.

note

Si aucun environnement Python n'est trouvé (ni auto-détecté, ni fourni via FLUHOMS_PYTHON_PATH), le runner démarre mais l'exécution des pipelines est indisponible ; un avertissement apparaît dans les logs.

Les chemins d'auto-détection Python et le répertoire de données par défaut de chaque OS sont listés dans Installer le runner.

Exemple de .env​

# --- Connexion à la plateforme (obligatoire) ---
API_URL=https://fluhoms.mon-entreprise.fr/api

# --- Environnement ---
APP_ENV=production
# DEBUG=1                # décommenter pour des logs détaillés

# --- API locale du runner ---
# PORT=2024              # port de l'API locale (CLI, interface de contrôle)
# LISTEN_HOST=localhost  # ne pas exposer au-delà de la machine

# --- Chemins (rarement nécessaires) ---
# FLUHOMS_AGENT_DATA_PATH=/data           # ex. montage Docker
# FLUHOMS_PYTHON_PATH=/opt/fluhoms-runner/python
# FLUHOMS_PYTHON_BIN=/opt/fluhoms-runner/python/bin/python

# --- Mises à jour ---
# UPDATE_URL=https://updates.fluhoms.example

Voir aussi​