condições necessárias
Para instalar o Node-RED localmente, é necessária uma versão suportada do Node.js.
Instalar o Node-RED usando o npm
Para instalar o Node-RED, pode utilizar o comando incluído no npmnode.js:
sudo npm install -g -unsafe-perm node-red
Se estiver a utilizar o Windows, não faça sudo.
Este comando instala o Node-RED e suas dependências como módulos globais.
Pode confirmar que foi bem sucedido se a saída do comando for semelhante à seguinte:
node-red@1.1.0
adicionou 332 pacotes de 341 contribuidores em 18.494s
encontrou 0 vulnerabilidades
Instalar o Node-RED usando o npm
Para executá-lo no Docker em sua forma mais simples, basta executar:
docker run -it -p 1880:1880 -name mynodered nodered/node-red
Para obter mais detalhes, consulte o guia do docker do Node-RED.
Instalar utilizando o snap
Se o seu sistema operativo suportar o Snap, pode instalar o Node-RED:
sudo snap install node-red
Quando instalado como um pacote Snap, será executado num contentor seguro que não tem acesso a alguns recursos adicionais que poderá ter de utilizar, tais como:
- Aceder ao armazenamento principal do sistema. Apenas o diretório pessoal local pode ser lido/escrito.
- gcc - quaisquer componentes binários necessários para compilar o nó para instalação
- git - necessário se quiser utilizar as funcionalidades do projeto
- Acesso direto ao hardware gpio
- Aceder a quaisquer comandos externos que o fluxo pretenda utilizar com o nó Exec (por exemplo).
- Se precisar de acesso ao hardware do sistema ou adicionar nós que requerem compilação, recomendamos usar uma instalação completa do Node-RED em vez de usar snaps.
Começar a utilizar o Node-RED
Uma vez instalado como um módulo global, pode iniciar o Node-RED no terminal utilizando o comando node-red. Pode parar o Node-RED usando Ctrl-C ou fechando a janela do terminal.
$node-vermelho
Bem-vindo ao Node-RED====================
30 Jun 23:43:39 - [info] Versão do Node-RED: v1.3.5
30 Jun 23:43:39 - [info] Node.jsversion: v14.7.2
30 Jun 23:43:39 - [info] Darwin 19.6.0 x64 LE
30 Jun 23:43:39 - [info] Carregando nós da paleta
30 jun 23:43:44 - [warn] rpi-gpio : Nó específico da Raspberry Pi definido como inativo
30 Jun 23:43:44 - [info] Ficheiro de definições: /Users/nol/.node-red/settings.js
30 Jun 23:43:44 - [info] Estática HTTP: /Usuários/nol/node-red/web
30 Jun 23:43:44 - [info] Loja de contexto: 'default' [module=localfilesystem]
30 Jun 23:43:44 - [info] Diretório de utilizadores : /Usuários/nol/.node-red
30 Jun 23:43:44 - [warn] Projectos desactivados : definir editorTheme.projects.enabled=true para ativar
30 Jun 23:43:44 - [info] Criando novo arquivo de fluxos : fluxos_noltop.json
30 Jun 23:43:44 - [info] A iniciar fluxos
30 Jun 23:43:44 - [info] Fluxos iniciados
30 Jun 23:43:44 - [info] Servidor agora a funcionar em http://127.0.0.1:1880/red/
Pode então aceder ao editor Node-RED apontando o seu browser para http://localhost:1880.
A saída do registo fornece-lhe várias informações:
- Versões do Node-RED e do Node.js
- Quaisquer erros encontrados ao tentar carregar o nó da paleta
- A localização dos seus ficheiros de definições e directórios de utilizador
- O nome do ficheiro de fluxo que está a utilizar.
Node-REDflows_
Utilização da linha de comandos
Node-RED Pode iniciar o node-red utilizando o comando. Este comando pode receber vários parâmetros:
node-red [-v] [-?] [-settings settings.js] [-userDir DIR]
[-port PORT] [-title TITLE] [-safe] [flows.json|projectName]
[-DX=Y|@file]
| Opções | descrever |
| -p,-port PORT | Define a porta TCP em que o tempo de execução escuta. Predefinição: 1880 |
| -seguro | Iniciar o Node-RED sem iniciar um fluxo. Isso permite que você abra o fluxo no editor e faça alterações sem que o fluxo seja executado. Quando você implanta suas alterações, o processo é iniciado. |
| -s,-configurações ARQUIVO | Define o ficheiro de definições a utilizar. Predefinição: settings.js em userDir |
| -títuloTITL | Definir o título da janela do processo |
| -u,-userDir DIR | Define o diretório do utilizador a utilizar. Predefinição: ~/.node-red |
| -v | Ativar a saída detalhada |
| -DX=Y|@file | Anular definições individuais |
| -?,-help | Mostrar ajuda de utilização da linha de comandos e sair |
| flows.json|projectName | Isto irá definir o ficheiro de fluxo que pretende utilizar se a funcionalidade de projeto não estiver activada. Se a funcionalidade Projectos estiver activada, isto determina qual o projeto que deve ser iniciado. |
Node-REDflows_
Anular definições individuais
A partir do Node-RED 1.1.0
-D É possível substituir definições individuais na linha de comandos utilizando a opção (ou -define).
Por exemplo, para alterar o nível de registo, pode utilizar:
-D logging.console.level=trace
Também é possível fornecer definições personalizadas como um ficheiro:
-D @./custom-settings.txt
O ficheiro deve conter uma lista de definições a substituir:
logging.console.level=trace
logging.console.audit=true
Passar parâmetros para o processo Node.js subjacente
Por vezes é necessário passar parâmetros para o processo Node.js subjacente. Por exemplo, ao executar num dispositivo com memória limitada, como um Raspberry Pi ou um BeagleBone Black.
Para isso, é necessário usar o script de inicialização node-red-pi em vez do node-red. Nota: Este script não está disponível no Windows.
Em alternativa, se estiver a utilizar o comando node para executar o Node-RED, tem de fornecer argumentos ao processo node antes de especificar red.js, bem como os argumentos a passar ao próprio Node-RED.
Os dois comandos seguintes mostram ambos os métodos:
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/
Atualização do Node-RED
Se tiver instalado o Node-RED como um pacote npm global, pode atualizar para a versão mais recente utilizando o seguinte comando:
sudo npm install -g -unsafe-perm node-red
Se estiver a utilizar o Windows, não faça sudo.