noodzakelijke voorwaarden
Om Node-RED lokaal te installeren, heb je een ondersteunde versie van Node.js nodig.
Installeer Node-RED met npm
Om Node-RED te installeren, kun je het commando gebruiken dat bij npm en node.js wordt meegeleverd:
sudo npm install -g –unsafe-perm node-red
Als je Windows gebruikt, gebruik dan geen `sudo`.
Met dit commando worden Node-RED en de bijbehorende afhankelijkheden als globale modules geïnstalleerd.
Je kunt controleren of het gelukt is als de uitvoer van het commando er ongeveer zo uitziet:
node-red@1.1.0
332 pakketten van 341 bijdragers toegevoegd in 18,494 s
0 kwetsbaarheden gevonden
Installeer Node-RED met npm
Om het in Docker in zijn eenvoudigste vorm uit te voeren, voer je gewoon het volgende uit:
docker run -it -p 1880:1880 –name mynodered nodered/node-red
Raadpleeg de Docker-handleiding van Node-RED voor meer informatie.
Installeer met snap
Als je besturingssysteem Snap ondersteunt, kun je Node-RED installeren:
sudo snap install node-red
Wanneer het als Snap-pakket wordt geïnstalleerd, draait het in een beveiligde container die geen toegang heeft tot bepaalde extra functies die je wellicht nodig hebt, zoals:
· Toegang tot de hoofdopslag van het systeem. Alleen de lokale thuismap kan worden gelezen en beschreven.
· gcc – alle binaire componenten die nodig zijn om Node te compileren voor de installatie
· git – vereist als je gebruik wilt maken van de functies van het project
· Directe toegang tot GPIO-hardware
· Gebruik eventuele externe opdrachten die je flow wil gebruiken met het Exec-knooppunt (bijvoorbeeld).
· Als je toegang nodig hebt tot de systeemhardware of knooppunten wilt toevoegen waarvoor compilatie vereist is, raden we je aan om een volledige installatie van Node-RED te gebruiken in plaats van snaps.
Aan de slag met Node-RED
Zodra het als globale module is geïnstalleerd, kun je Node-RED in de terminal starten met het commando `node-red`. Je kunt Node-RED stoppen met Ctrl-C of door het terminalvenster te sluiten.
$node-red
Welkom bij Node-RED====================
30 juni 23:43:39 – [info] Node-RED-versie: v1.3.5
30 juni 23:43:39 – [info] Node.js-versie: v14.7.2
30 juni 23:43:39 – [info] Darwin 19.6.0 x64 LE
30 juni 23:43:39 – [info] Paletknooppunten worden geladen
30 juni 23:43:44 – [waarschuwing] rpi-gpio: Raspberry Pi-specifieke knooppunt is inactief gemaakt
30 juni 23:43:44 – [info] Instellingenbestand: /Users/nol/.node-red/settings.js
30 juni 23:43:44 – [info] HTTP statisch: /Users/nol/node-red/web
30 juni 23:43:44 – [info] Contextopslag: ‘default’ [module=localfilesystem]
30 juni 23:43:44 – [info] Gebruikersmap: /Users/nol/.node-red
30 juni 23:43:44 – [waarschuwing] Projecten uitgeschakeld: stel editorTheme.projects.enabled=true in om ze in te schakelen
30 juni 23:43:44 – [info] Nieuw flows-bestand aanmaken: flows_noltop.json
30 juni 23:43:44 – [info] Stromen starten
30 juni 23:43:44 – [info] Stromen gestart
30 juni 23:43:44 – [info] De server draait nu op http://127.0.0.1:1880/red/
Je kunt de Node-RED-editor vervolgens openen door in je browser http://localhost:1880 in te voeren.
De loguitvoer biedt u diverse informatie:
· Versies van Node-RED en Node.js
· Eventuele fouten die zijn opgetreden bij het laden van de paletknoop
· De locatie van je instellingenbestanden en gebruikersmappen
· De naam van het streambestand dat wordt gebruikt.
Node-RED-stromen_
Gebruik via de opdrachtregel
Node-RED Je kunt Node-RED starten met behulp van het volgende commando. Dit commando kan verschillende parameters bevatten:
node-red [-v] [-?] [–settings settings.js] [–userDir DIR]
[–port POORT] [–title TITEL] [–safe] [flows.json|projectnaam]
[-DX=Y|@bestand]
| Opties | beschrijven |
| -p,–port POORT | Stel de TCP-poort in waarop de runtime luistert. Standaard: 1880 |
| –veilig | Start Node-RED zonder een stream te starten. Zo kun je de stream in de editor openen en wijzigingen aanbrengen zonder dat de stream actief is. Zodra je je wijzigingen implementeert, wordt het proces gestart. |
| -s,–settings BESTAND | Stel het in te gebruiken instellingenbestand in. Standaard: settings.js in userDir |
| –titleTITL | Titel van het procesvenster instellen |
| -u,–userDir DIR | Stel de te gebruiken gebruikersmap in. Standaard: ~/.node-red |
| -v | Uitgebreide uitvoer inschakelen |
| -DX=Y|@bestand | Individuele instellingen overschrijven |
| -?,–help | Help over het gebruik van de opdrachtregel weergeven en afsluiten |
| flows.json|projectnaam | Hiermee stel je het flow-bestand in dat je wilt gebruiken als de projectfunctie niet is ingeschakeld. Als de projectfunctie is ingeschakeld, bepaalt dit welk project moet worden gestart. |
Node-RED-stromen_
Individuele instellingen overschrijven
Vanaf Node-RED 1.1.0
-D Je kunt afzonderlijke instellingen op de opdrachtregel overschrijven met de optie (of –define).
Als je bijvoorbeeld het logniveau wilt wijzigen, kun je het volgende gebruiken:
-D logging.console.level=trace
Je kunt aangepaste instellingen ook als bestand opgeven:
-D @./custom-settings.txt
Het bestand moet een lijst bevatten met instellingen die moeten worden overschreven:
logging.console.level=trace
logging.console.audit=true
Parameters doorgeven aan het onderliggende Node.js-proces
Soms is het nodig om parameters door te geven aan het onderliggende Node.js-proces. Bijvoorbeeld wanneer het programma wordt uitgevoerd op een apparaat met beperkt geheugen, zoals een Raspberry Pi of een BeagleBone Black.
Hiervoor moet je het opstartscript `node-red-pi` gebruiken in plaats van `node-red`. Let op: dit script is niet beschikbaar op Windows.
Als alternatief geldt dat, wanneer je het `node`-commando gebruikt om Node-RED uit te voeren, je eerst argumenten moet opgeven voor het `node`-proces voordat je `red.js` specificeert, naast de argumenten die aan Node-RED zelf moeten worden doorgegeven.
De volgende twee commando's laten beide methoden zien:
node-red-pi –max-old-space-size=128 –userDir /home/user/node-red-data/
node –max-old-space-size=128 red.js –userDir /home/user/node-red-data/
Node-RED bijwerken
Als je Node-RED als een globaal npm-pakket hebt geïnstalleerd, kun je met de volgende opdracht een upgrade uitvoeren naar de nieuwste versie:
sudo npm install -g –unsafe-perm node-red
Als je Windows gebruikt, gebruik dan geen `sudo`.
