Node-RED

Node-RED : AMQP 1.0 support with the RHEA nodes library

I’m very happy to announce that I have just released the first version of a new messaging and IoT library for providing AMQP 1.0 protocol support on Node-RED that is a very interesting tool for wiring Internet of Things.

This library is based on the official JavaScript RHEA library which provides AMQP 1.0 support for NodeJS applications (developed by one of my best colleagues in Red Hat, Gordon Sim).

Up to now, the available nodes are :

  • sender : for sending messages to an AMQP address
  • receiver : for receiving messages from an AMQP address
  • requester : for executing a request to an AMQP address and waiting a response on the address specified in the “reply-to” field
  • responder : for receiving a request on an AMQP address and sending the response on the address specified in the “reply-to” field

Of course it’s open source (available on GitHub) with a getting started guide and documentation available on the related Wiki.

amqp_nodes

I published it on NPM (Node-RED is completely based on NodeJS) at following link but you can find it even on the official Node-Red web site in the flows section (searching for “amqp” for example).

Enjoying AMQP messaging and IoT with Node-RED flow programming !

Node-RED : i principali nodi funzione su HTML.it

html_nodi_funzione

Nuovo appuntamento con la mia guida su Node-RED su HTML.it

Questa volta tocca ai principali nodi funzione che possono essere utilizzati per la realizzazione dei “flussi”. Si va dal semplice delay alle richieste HTTP, passando per il trigger, la manipolazione dei messaggi, switch e template.

Pian piano stiamo introducendo tutti i mattoncini che ci permetteranno di realizzare soluzioni sempre piĂš complesse.

Stay tuned !

😉

Creare il primo flow con Node-RED su HTML.it

html_nodered_primo_flow

Questa volta iniziamo a fare sul serio …

Il nuovo capitolo della guida su Node-RED ci mostra come realizzare il nostro primo semplice flow attraverso l’utilizzo dei primi nodi : inject, function e debug.

Il risultato non è esaltante (un tipico “Hello World”) ma inizia a rendere l’idea di quelle che sono le potenzialitĂ  dello strumento che abbiamo tra le nostre mani.

Ovviamente è solo l’inizio !

HTML.it : Installare Node-RED

nodered0203

Dopo aver introdotto il concetto di flow-based programming nel corso del primo capitolo, è giunto il momento di installare Node-RED per poter iniziare a sviluppare i primi flussi per l’IoT !

Il secondo capitolo della guida pubblicata su HTML.it ci prende letteralmente per mano partendo dall’installazione di NodeJS per poi proseguire all’installazione di Node-RED fino alla configurazione ed all’avvio del runtime.

Al termine del capitolo abbiamo a disposizione la UI (all’interno del nostro browser) attraverso la quale poter sviluppare i flussi che vedremo nei capitoli successivi.

Node-RED, flow-based programming per l’IoT su HTML.it

node-red-guida

A partire da oggi, su HTML.it, inizia la pubblicazione di una nuova guida che ho scritto molto volentieri, in quanto ritengo l’argomento in oggetto molto importante ed utile nell’ambito dell’Internet of Things : sto parlando di Node-RED !

Nel corso del primo capitolo, viene introdotto il concetto di flow-based programming che rappresenta il paradigma di programmazione su cui si basa Node-RED in modo da poterne capire i concetti fondamentali prima di iniziare ad utilizzarlo praticamente.

Spero mi seguiate numerosi per poter scoprire le potenzialità di questo strumento nell’ambito dell’Internet of Things !

🙂

Azure Nodes : i servizi di Microsoft Azure in Node-RED !

2538.azurenodes2_62EF2B5F

Dopo aver scritto l’articolo relativo all’installazione di Node-RED attraverso un Web Site in Microsoft Azure, ho deciso di iniziare un altro “piccolo” progetto open source strettamente legato alla “flow-based programming” con Node-RED utilizzando i servizi di Microsoft Azure.

Partendo dall’ Azure SDK per Node.js mi sono posto la seguente domanda : perché non mettere a disposizione degli utilizzatori di Node-RED tutti i servizi di Microsoft Azure nei loro “flow” ?

Da qui è nata l’idea del progetto Azure Nodes !

Questo progetto, disponibile su GitHub, aggiunge una serie di nodi (di colore “azure”) alla toolbox di Node-RED attraverso i quali poter interagire con i servizi di Microsoft Azure. La versione attuale è ancora in Beta e supporta esclusivamente le funzionalità del Service Bus (queue e topic/subscription) molto utili nell’Internet Of Things.

5658.sample_topic_sub_flow_543459AD

La documentazione è disponibile nelle pagine di Wiki relative al progetto stesso anche se l’utilizzo dei nodi è notevolmente semplice ed intuitivo.

6648.sb_queue_in_node_5D40E52E

Ci sono ancora molti (toppi ?) messaggi di debug visualizzati sulla console di Node.js ma voglio prima capire se il progetto può essere considerato valido ed interessante per gli utilizzatori. Per questo motivo, non esitate a contattarmi e darmi la vostra opinione !

Ovviamente, ho già provveduto ad attivare l’account Twitter @azurenodes !

Flow-based programming per l’Internet of Things con Node-RED in Microsoft Azure

azure-ill

Uno dei migliori e più conosciuti tool per il “flow-based programming” e che fornisce ottimi strumenti per l’Internet of Things è sicuramente Node-RED. Esso è un progetto open source ospitato su GitHub e sviluppato da Nick O’Leary e Dave Conway-Jones della IBM, anche se non è assolutamente basato su tecnologie IBM. La sua caratteristica principale è che è completamente scritto in JavaScript ed HTML e si basa sul framework server-side NodeJS. Ciò significa che può essere eseguito su un qualsiasi PC in cui sia possibile installare NodeJS e con tutti i sistemi operativi disponibili da Windows a Linux passando per Mac OS X.

Questo articolo non intende essere una guida introduttiva o completa a Node-RED ma vuole mostrare come quest’ultimo possa essere eseguito nel cloud ! Grazie alle sue fondamenta in NodeJS e la potenza di tutti i servizi Microsoft Azure, è possibile creare un Azure Web Site per un’applicazione NodeJS che ospiti Node-RED in modo da potervi accedere, controllare e svilupparci ovunque ci troviamo !

In questo modo, non c’è bisogno di mettere su un server “on premise” oppure a casa una delle board maggiormente utilizzate dai makers come la Raspberry Pi o la Intel Galileo. Queste soluzioni vanno bene per scenari dove c’è poco carico e traffico sui “flows” di Node-RED ma per ottenere un sistema altamente scalabile con milioni di connessioni, l’unica soluzione possibile è quella di utilizzare una PaaS come Microsoft Azure.

Siete interessati a sapere come si ? Partiamo !

Deploy in un Local Git repository su Azure

Il primo passo da fare è quello di procurarsi il codice sorgente di Node-RED, poichè è necessario eseguire una piccola modifica al codice stesso. Abbiamo a disposizione molteplici soluzioni per farlo, grazie alla funzionalità di integrate source control fornita da Azure per i Web Sites. Quando si crea un Web Sites, è possibile impostare il deploy da un source control system in modo che ogni modifica apportata al proprio repository (locale o remoto) viene automaticamente distribuita in produzione su Azure. Il codice sorgente può essere su Visual Studio Online, in un Local Git repository (su Azure), GitHub, Dropbox, Bitbucket, CodePlex oppure su un qualsiasi altro repository esterno basato su Git o Mercurial.

Nel caso di Node-RED, le possibili soluzioni sono quelle di usare un Local Git repository oppure un repository remoto su GitHub. Nel corso dell’articolo, li vedremo entrambi per completezza ma ciascuno di voi potrà scegliere il modo migliore in base alle proprie esigenze.

In primo luogo, bisogna creare un Azure Web Site utilizzando il management portal online.

01

Per impostare un deploy da un source control system, è possibile utilizzare il link corrispondente nella pagina principale del Web Site appena creato.

02

Per utilizzare un Local Git repository, è necessario selezionare la corrispondente voce “Local Git repository”.

03

Per abilitare il publishing attraverso Git, la prima volta che viene utilizzato, il management portal chiede di impostare le credenziali di accesso (username e password). Queste credenziali sono comuni a tutti i Web Sites, per cui se sono state già impostate, non verrano richieste nuovamente. Al termine di questa operazione, Azure crea un repository Git locale in cui è possibile pubblicare la propria applicazione; per farlo il portale ci mostra i passi da eseguire : scaricare ed installare Git sul proprio PC, creare un repository Git locale e committare l’applicazione sul repository remoto in Azure.

In questo caso, l’applicazione locale è Node-RED per cui è necessario scaricarne il codice sorgente attraverso il file zip disponibile sul sito ufficiale. Una volta estratti i file in una cartella sul proprio PC (nel mio caso C:\Users\Paolo\Source\Repos\node-red-0.8.0), usando la Git Bash (nella medesima cartella di Node-RED) è possibile creare il repository locale, aggiungere i file dell’applicazione ed eseguire il primo commit in locale attraverso I seguenti comandi :

git init

git add .

git commit –m “Initial Node-RED commit”

04

(E’ necessario ricordare che per eseguire il commit, Git richiede di impostare email e username mediante il comand git config per i parametri user.email e user.name)

Il passo successivo consiste nell’aggiungere un server Git remoto ed eseguire il push del master branch sul repository in Azure; dal management portal, nella dashboard del Web Site, è possibile ricavere il nome di tale repository. I comandi da eseguire sono i seguenti :

git remote add azure [repository URL on Azure]

git push azure master

Ovviamente, Git chiede la password per la connessione al repository remoto ed al termine di tale operazione, Azure inizia il deploy, il cui risultato è visibile nel tab Deployments del management portal.

05

Durante la fase di deploy, Azure esegue anche npm (NodeJS Package Manager) per poter installare tutti i moduli necessari a Node-RED per poter funzionare; tale informazioni è ricavata attraverso il file package.json.

A questo punto sembra di aver finito ma purtroppo navigando all’URL del sito non saremo in grado di visualizzare il tool visuale di Node-RED per la creazione dei “flows”. Per risolvere questo problema è necessario effettuare una piccola modifica al file settings.js impostando opportunamente il parametro uiPort nel modo seguente :

// the tcp port that the Node-RED web server is listening on
uiPort: process.env.PORT || 1880,

Al termine dell’articolo sarà più chiaro il perchè di tale modifica.

A questo punto, bisogna committare in locale le modifiche ed aggiornale sul repository in Azure in modo da avviare il re-deploy automatico.

git add .

git commit –m “uiPort setting changed”

git push azure master

Prima di poter utilizzare Node-RED, manca un ultima modifica. Il tool visuale fa uso intensivo del protocollo WebSocket che è necessario abilitare nella Configure tab del management portal per il Web Site corrente. Resta inteso che questo passo è necessario solo se utilizziamo il tool per la creazione dei “flows” che, come sappiamo, sono dei file JSON che potremmo anche sviluppare in locale e caricare in Azure.

06

Dopo aver eseguito il salvataggio, navigando al Web Site con il proprio browser sarà possibile vedere in esecuzione il tool visuale e Node-RED. Siamo pronti per creare i nostri “flows” !

07

Deploy attraverso un repository su GitHub

La seconda possibilità consiste nell’utilizzare un repository su GitHub. Ovviamente, potremmo utilizzare quello ufficiale di Node-RED ma in questo caso non potremmo eseguire la modifica necessaria al file settings.js. Per questo motivo, un buon modo è quello di creare un fork del repository originale attraverso il proprio account GitHub.

Per farlo, è necessario accedere a GitHub con le proprie credenziali, andare sul repository di Node-RED e cliccare su fork.

08

Una volta completato il fork, GitHub avrĂ  creato un repository con un URL di questo tipo https://github.com/<username>/node-red in modo da poterlo clonare sul proprio PC attraverso la Git Bash nel modo seguente :

git clone /node-red.git”>/node-red.git”>https://github.com/<username>/node-red.git

Al termine del cloning, possiamo modificare il file settings.js (come fatto in precedenza) ed eseguire il commit sul repository.

git add .

git commit –m “uiPort setting changed”

git push

In questo caso, non abbiamo alcun bisogno di un repository Git su Azure poichè stiamo utilizzando quello di GitHub al quale faremo puntare Azure stesso nel momento della creazione del Web Site.

Dopo aver creato un nuovo Web Site come fatto in precedenza, impostiamo il deploy attraverso il source control GitHub.

09

Microsoft Azure si connette a GitHub e chiede l’autorizzazione a poter accedere a tutti i repository del proprio account in modo da poterci far selezionare a quale repository deve collegarsi per farne il deploy.

10

Come già fatto in precedenza, è necessario abilitare il protocollo WebSocket per ottenere così l’applicazione visuale di Node-RED pronta ed in esecuzione !

Test di Node-RED su Azure con un semplice flow di debug

Per essere sicuri che l’applicazione Node-RED stia funzionando correttamente, possiamo realizzare un semplice flow di debug con i due soli seguenti nodi :

  • inject : permette di iniettare dati in un flow. Il valore di default del payload del messaggio è il timestamp che può essere cambiato in fase di configurazione del nodo;
  • debug : permette la stampa del payload del messaggio ricevuto nella finestra di debug;

Aggiungiamo e colleghiamo i due nodi nel modo seguente.

11

Cliccando su Deploy, il flow viene deployato ed eseguito nell’istanza di Node-RED e se proviamo a cliccare sul nodo di inject, vedremo il timestamp visualizzato nella finestra di debug. Il nostro flow è in esecuzione su Azure !!

IISNode … la magia per avere Node-RED su Azure

Il componente principale che permette l’esecuzione di applicazioni NodeJS su Azure è il modulo ISS chiamato IISNode, i cui vantaggi sono i seguenti :

  • ha cura del ciclo di vita del processo node.exe;
  • NodeJS è per natura single threaded ma IISNode permette la creazione di piĂš processi node.exe e di gestire il carico delle richieste tra piĂš istanze;
  • si assicura che se un’applicazione NodeJS viene aggiornata, il processo node.exe venga riciclato;
  • fornisce l’accesso alle informazioni di log via HTTP;

Talvolta, per garantire l’esecuzione delle applicazioni NodeJS su IISNode sono necessari alcuni piccoli accorgimenti al codice sorgente dell’applicazione stessa ed in particolare l’impostazione della porta HTTP di ascolto attraverso la variabile d’ambiente process.env.PORT. Ciò spiega il perchè del fatto che il tool visuale di Node-RED non può essere in ascolto sulla porta 1880 (default) ma è necessario impostare la porta su cui è in ascolto IISNode in HTTP.

Conclusioni

Node-RED è un validissimo tool per la realizzazione di progetti per l’Internet of Things attraverso dei “flows” con una UI eseguita all’interno di un browser. Il problema principale è strettamente legato alla sua distribuzione.

Le soluzioni “on premise” o locale vanno bene per scenari semplici ma sicuramente non per scenari enterprise. In questo caso possiamo utilizzare le funzionalità di Azure per l’esecuzione delle applicazioni NodeJS aggiungendo anche la scalabilità e la gestione del carico grazie al modulo IISNode all’interno di IIS.