Node-RED pour YunoHost

Read this readme in english. Lire ce readme en français.

Ce package vous permet d'installer Node-RED rapidement et simplement sur un serveur YunoHost. Si vous n'avez pas YunoHost, regardez ici pour savoir comment l'installer et en profiter.

Vue d'ensemble

Node-RED est un outil de programmation pour connecter des appareils, API, et des services en ligne en de nouvelles et intéressantes façons.

Il propose un éditeur accessible dans le navigateur, qui facilite l'ébauche de flux qui connectent ensemble la grande variété de nœuds disponibles dans sa palette. Ces flux sont ensuite activables et déployables en un clic.

Fonctionnalités

Edition de flux dans le navigateur
Déploiement des flux en un clic
Plus de 225 000 modules disponibles
Fonctions personnalisées en JavaScript

Surcharger la configuration par défaut

Depuis le répertoire d'installation, éditer le fichier /opt/yunohost/nodered/data/settings.user.js. Par exemple

module.exports = (defaultSettings) => ({
    lang: "de", // définit la langue de l'IHM comme allemande
    exportGlobalContextKeys: true, // surcharger la valeur de `exportGlobalContextKeys`

    logging: { // remplacer l'option par défaut pour la journalisation (logging)
        ...defaultSettings.logging, // cela réinjectera les paramètres par défaut dans `logging`
        console: {
            ...defaultSettings.logging.level, // cela réinjectera les paramètres par défaut dans `logging.console`
            level: "debug", // mais isi, nous surchargeons le niveau "info" par "debug"
        },
    },
});

Vous pouvez consulter les paramètres par défaut générez par Yunohost dans /opt/yunohost/nodered/data/settings.js et trouver la documentation pour configurer Node-RED ici: https://nodered.org/docs/user-guide/runtime/configuration

Version incluse : 2.2.2~ynh1

Captures d'écran

Avertissements / informations importantes

Le système de permissions de YunoHost permet de paramétrer les accès à Node-RED :

la permission main protège /admin, l'éditeur de flux. L'administrateur est sélectionné pendant l'installation ;
la permisison ui protège /ui, le tableau de bord permettant de donner une interface graphique aux flux. L'accès public est défini lors de l'installation ;
la permission endpoints protège /, pour notamment les points d'entrée de type API. L'accès public est défini lors de l'installation.

Si vous avez mis à jour Node-RED au-delà de la version 2, vérifiez que ces permissions vous conviennent dans votre panneau d'administration de YunoHost.

Documentations et ressources

Site officiel de l'app : https://nodered.org
Documentation officielle utilisateur : https://nodered.org/docs/
Dépôt de code officiel de l'app : https://github.com/node-red/node-red
Documentation YunoHost pour cette app : https://yunohost.org/app_nodered
Signaler un bug : https://github.com/YunoHost-Apps/nodered_ynh/issues

Informations pour les développeurs

Merci de faire vos pull request sur la branche testing.

Pour essayer la branche testing, procédez comme suit.

sudo yunohost app install https://github.com/YunoHost-Apps/nodered_ynh/tree/testing --debug
ou
sudo yunohost app upgrade nodered -u https://github.com/YunoHost-Apps/nodered_ynh/tree/testing --debug

Plus d'infos sur le packaging d'applications : https://yunohost.org/packaging_apps

3.9 KiB Raw Blame History