Paramètres d’application

Exposez des paramètres configurables aux utilisateurs sans construire une interface web complète. Définissez un formulaire à l’aide de env-template.yml et IronFlock le génère automatiquement.

Quand utiliser les paramètres

Utilisez les paramètres pour une configuration simple que les utilisateurs doivent ajuster par appareil ou par groupe :

• Intervalles d’enregistrement des capteurs
• URLs des points d’accès de données
• Seuils d’alerte
• Bascules de fonctionnalités
• Clés API et identifiants

Définir les paramètres

Créez un fichier env-template.yml dans le répertoire .ironflock/ :

RECORDING_INTERVAL:
    label: "Intervalle d'enregistrement (secondes)"
    defaultValue: 5
    type: numeric
    optional: true
 
ALERT_THRESHOLD:
    label: "Seuil d'alerte température (°C)"
    defaultValue: 80
    type: numeric
    optional: true
 
API_ENDPOINT:
    label: "Point d'accès API de données"
    defaultValue: "https://api.example.com/data"
    type: text
    optional: true
 
ENABLE_DEMO:
    label: "Activer les données de démonstration"
    defaultValue: true
    type: boolean
    optional: true
 
DATA_FORMAT:
    label: "Format de sortie"
    defaultValue: "json"
    type: select
    options:
        - json
        - csv
        - xml
    optional: true

Types de paramètres

Comment les paramètres atteignent votre application

Les paramètres sont injectés comme des variables d’environnement Linux dans votre conteneur :

import os
 
interval = int(os.environ.get("RECORDING_INTERVAL", 5))
threshold = float(os.environ.get("ALERT_THRESHOLD", 80))

const interval = parseInt(process.env.RECORDING_INTERVAL || "5");
const threshold = parseFloat(process.env.ALERT_THRESHOLD || "80");

Paramètres volumineux

Les paramètres dépassant 20 Ko ne sont pas définis comme variables d’environnement. Ils sont toujours disponibles comme fichiers :

/data/env/PARAMETER_NAME.txt

Paramétrisation en masse

Lorsque les paramètres sont définis au niveau du groupe d’appareils, ils s’appliquent à tous les appareils du groupe simultanément.