Node-RED

Node-RED

O Node-RED é uma ferramenta de programação Low Code, voltada para Internet das Coisas, que permite interligar dispositivos físicos, ambientes de desenvolvimento de software online e serviços em nuvem.

Site: knolleary: Words and things by Nick O'Leary

Execução e utilização do Node-RED

Execução

Uma vez instalado no ambiente do Ubuntu, o Node-RED pode ser executado a partir de um terminal com o comando:

node-red

Utilização

O Node-RED provê um editor de programação a partir de um navegador, permitindo a construção de fluxos de programação Low Code a partir de um grande número de nós disponíveis na paleta de opções.

Se instalado em uma máquina local, o acesso ao Node-RED é realizado pela URL:

localhost:1880

Instalação de módulos Node-RED

Além dos nós básicos, diversos nós podem ser instalados na paleta de opções do Node-RED.

Menu -> Manage palette -> Install -> Search

Instalação no Ubuntu

Instalando com npm (comando do node.js)

sudo npm install -g --unsafe-perm node-red

Se o npm não tiver instalado, deve ser instalado antes o nodejs:

sudo apt install nodejs

verificar versão:

nodejs -v

instalar npm:

sudo apt install npm

Instalação com Docker

Necessita instalação prévia do Docker .

docker run -it -p 1880:1880 --name node-red nodered/node-red

Detalhando o comando :

docker run              - run this container... initially building locally if necessary
-it                     - attach a terminal session so we can see what is going on
-p 1880:1880            - connect local port 1880 to the exposed internal port 1880
--name node-red         - give this machine a friendly local name
nodered/node-red        - the image to base it one

Navegar normalmente:

http://{host-ip}:1880

Para sair do terminal Docker:

Ctrl-p Ctrl-q - the container will keep running in the background.

Voltar ao terminal:

docker attach node-red

Parar o contêiner com Node-Red

docker stop node-red

Reiniciar o contêiner:

docker start node-red

Preservação dos Dados do Usuário

Com o Node-RED rodando em um contêiner Docker, caso o contêiner seja destruído os dados com os fluxos construídos pelo usuário serão perdidos. Para preservar estes dados é possível montar um diretório em um local externo ao contêiner .

Dentro do contêiner Node-RED usa o diretório /data para armazenar os dados do usuário. Para salvar este diretório em um local externo pode-se utilizar o comando abaixo. Neste caso, para acesso a este diretório externo, o usuário do Node-RED dentro do contêiner (default UID 1000) deve ter o mesmo UID do usuário no hospedeiro.

docker run -d -u 1000:1000 -p 1880:1880 -v /home/$USER/node-red-backup:/data --name node-red nodered/node-red

Detalhando o comando:

docker run              - run this container... initially building locally if necessary
-d                      - run in background and print container ID
-u                      - uid 
-p 1880:1880            - connect local port 1880 to the exposed internal port 1880
-v                      - bind mount volume
--name node-red         - give this machine a friendly local name
nodered/node-red        - the image to base it one

Acesso as portas seriais USB

Referência

O acesso as portas seriais USB é necessário para integração com Arduíno, ou outros dispositivos, via serial usando o módulo node-red-node-serialport.

Por padrão as portas seriais são montadas pelo root, portanto com acesso privilegiado, e são efêmeras, existindo apenas quando o dispositivo está plugado no computador.

Para que outros usuários, e no caso o Docker, possam acessar as portas devemos incluir uma regra para acesso ao udev, criando um arquivo no diretório:

/etc/udev/rules.d/99-serial.rules

e adicionar as linhas:

KERNEL=="ttyUSB[0-9]*",MODE="0666" 
KERNEL=="ttyACM[0-9]*",MODE="0666" 

Para que o Docker possa acessar os dispositivos conectados a serial, devemos montar todo o diretório /dev quando rodarmos o Docker, usando o parâmetro

-v /dev:/dev

e atribuir permissão para acesso com

--privileged

O comando completo para rodar o Docker é:

docker run -it -p 1880:1880 -v /dev:/dev --privileged --name node-red nodered/node-red

Dispositivo permanentemente conectado

Caso o dispositivo fique permanentemente conectado pode-se explicitar a porta serial usada pelo dispositivo. Por exemplo, o Arduíno UNO usa a porta /dev/ttyACM0:

docker run -it -p 1880:1880 --device=/dev/ttyACM0:/dev/ttyACM0 --user=root --name node-red nodered/node-red

ou, para outro dispositivo, deve-se verificar a porta utilizada, por exemplo:

docker run -it -p 1880:1880 --device=/dev/ttyUSB0:/dev/ttyUSB0 --user=root --name node-red nodered/node-red

Laboratórios com Node-RED

Node-RED Laboratorios: Firmata, Serial e Ethernet

Node-RED Laboratorios: MQTT

Node-RED Laboratorios: Raspberry Pi

Referências

Evandro.cantu (discussão) 13h47min de 1 de junho de 2020 (-03)