reComputer R1000 con FlowFuse

Introducción

FlowFuse expande las capacidades de Node-RED agregando características para desarrollo colaborativo, despliegues remotos, soporte de pipelines DevOps y hosting de aplicaciones Node-RED. Es una plataforma DevOps diseñada para el desarrollo y la entrega de aplicaciones Node-RED, facilitando la colaboración y el despliegue eficiente.

Antes de Comenzar

Antes de iniciar, asegúrate de tener listos tu hardware y software, tal como se describe a continuación.

Preparación de Hardware

reComputer R1000

Get One Now 🖱️

Preparación de Software

Instalando Node.js para FlowFuse en reComputer

Necesitarás Node.js en tu reComputer para usar FlowFuse. Sigue estos pasos para instalar Node.js versión 20:

Preparar el repositorio de Node.js
Actualiza la lista de paquetes e instala certificados y herramientas:

sudo apt update
sudo apt install -y ca-certificates curl gnupg

Configurar el repositorio de NodeSource

curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg

Agregar el repositorio de Node.js

Recomendado por FlowFuse, instala Node.js 20:

NODE_MAJOR=20

Agrega el repositorio Node.js a la lista de fuentes en tu reComputer:

echo "deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt update

Instalar Node.js

sudo apt install nodejs

Ahora tu dispositivo tiene Node.js versión 20.

Para usar FlowFuse, crea una cuenta y verifica tu email.

Crear una Cuenta en FlowFuse

Visita la página de registro:
- Ve a FlowFuse Account Creation.
Completa el formulario:
- Username: elige un nombre único.
- Full Name: ingresa tu nombre completo.
- Email: email válido.
- Password: contraseña segura.
Envía el formulario:
- Haz clic en Create Account.

Revisa tu email:
- Busca un correo de verificación de FlowFuse.
Abre el correo y verifica:
- Usa el código para verificar tu email.
Regresa a FlowFuse:
- Ve a la página de inicio de sesión.
Ingresa tus credenciales:
- Username/Email y contraseña.

Inicia sesión:
- Haz clic en Login. Probablemente te pida crear un equipo (Team).

Creación de una Aplicación en FlowFuse

Organiza tus instancias de Node-RED dentro de Aplicaciones. Cada Aplicación puede tener una o más Instancias de Node-RED, que incluyen plugins FlowFuse.

Ir a la sección de Aplicaciones:
- En el dashboard de FlowFuse, haz clic en Create Application.

Completa detalles de la Aplicación:
- Name: nombre de tu app.
- Description: descripción.
- Instance Name: nombre para tu instancia Node-RED.
- Blueprint: elige Blank Workspace.
- Node-RED Version: elige la última versión.

Crear la Aplicación:
- Haz clic en Create.

Creando un Flujo en FlowFuse

Vamos a crear un flujo en Node-RED que genere un número aleatorio y lo muestre en un dashboard. Si eres nuevo en Node-RED, consulta esta guía.

Abrir el editor de Node-RED:
- Ve a tu instancia, selecciónala.
- Haz clic en Open Editor.

Instalar nodos requeridos:
- Puede que falten random y gauge.
- Ve al menú superior derecho, Manage palette.
- En Install, busca Random y Dashboard e instálalos.

Crear el flujo:
- Copia e importa el siguiente flujo en Node-RED:

[
    {
        "id": "fd017c5f719054f5",
        "type": "tab",
        "label": "Flow 1",
        "disabled": false,
        "info": "",
        "env": []
    },
    {
        "id": "45888468a69bbabb",
        "type": "random",
        "z": "fd017c5f719054f5",
        "name": "Random",
        "low": 1,
        "high": "100",
        "inte": "true",
        "property": "payload",
        "x": 340,
        "y": 160,
        "wires": [
            [
                "ce3820147521aaa6"
            ]
        ]
    },
    {
        "id": "5e571c440b2340e9",
        "type": "inject",
        "z": "fd017c5f719054f5",
        "name": "",
        "props": [
            {
                "p": "payload"
            },
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "5",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "payload": "",
        "payloadType": "date",
        "x": 130,
        "y": 160,
        "wires": [
            [
                "45888468a69bbabb"
            ]
        ]
    },
    {
        "id": "ce3820147521aaa6",
        "type": "ui_gauge",
        "z": "fd017c5f719054f5",
        "name": "",
        "group": "7ac87662e9cf0550",
        "order": 0,
        "width": 0,
        "height": 0,
        "gtype": "gage",
        "title": "Random Number",
        "label": "units",
        "format": "{{value}}",
        "min": 0,
        "max": "100",
        "colors": [
            "#00b500",
            "#e6e600",
            "#ca3838"
        ],
        "seg1": "",
        "seg2": "",
        "diff": false,
        "className": "",
        "x": 670,
        "y": 160,
        "wires": []
    },
    {
        "id": "7ac87662e9cf0550",
        "type": "ui_group",
        "name": "Default",
        "tab": "0dc7fe4a8add5b68",
        "order": 1,
        "disp": true,
        "width": "6",
        "collapse": false,
        "className": ""
    },
    {
        "id": "0dc7fe4a8add5b68",
        "type": "ui_tab",
        "name": "Home",
        "icon": "dashboard",
        "disabled": false,
        "hidden": false
    }
]

Desplegar el flujo:
- Haz clic en Deploy arriba a la derecha.

Agregando y configurando un Dispositivo en FlowFuse

Agregar dispositivo:
- En el dashboard de FlowFuse, ve a la sección Devices.
- Haz clic en Add Device.

Llena los detalles y haz clic en Add.

Copiar configuración del dispositivo:
- Tras crear el dispositivo, obtendrás la configuración.
- Copia el snippet de código bajo "manual instructions".

Instalar el Device Agent

En la terminal de reComputer, ejecuta:

sudo npm install -g @flowfuse/device-agent

Configurar el Device Agent

Crear directorio de configuración:

sudo mkdir /opt/flowfuse-device
sudo chown -R $USER /opt/flowfuse-device
sudo su
cd /
cd opt/flowfuse-device

Crear y editar archivo de configuración:

nano device.yml

Pega la configuración copiada y guarda (Ctrl+X, luego Y, Enter).

Ejecutar el agente:

flowfuse-device-agent --port=1881

El dispositivo queda configurado y conectado a FlowFuse.

Desplegando el Flujo en un Dispositivo

Para desplegar el flujo, creamos un snapshot de la instancia de Node-RED y lo enviamos al reComputer.

Crear un Snapshot

Ir a la Aplicación:
- En FlowFuse, selecciona la instancia creada.

Seleccionar 'Snapshot':
- Haz clic en Snapshot.

Crear un nuevo Snapshot:
- Como no hay snapshots, crea uno.
- Haz clic en Create Snapshot.

Completar detalles del Snapshot:
- Name: nombre.
- Description: breve descripción.
- Set as Target: márcalo para establecer este snapshot como objetivo.

Crear Snapshot:
- Haz clic en Create. Captura el estado de la instancia (flows, credenciales, variables de entorno, paquetes NPM, settings).

Enviando el Snapshot al Dispositivo

Ir a la sección Devices:
- En FlowFuse, ve a Devices.

Seleccionar el Dispositivo:
- Encuentra el dispositivo creado.
- Haz clic en los tres puntos junto al nombre.
- Selecciona Add Instance.

Agregar la Instancia al Dispositivo:
- Elige la aplicación y la instancia que creaste.
- Haz clic en Add.

Desplegar el Flujo:
- En segundos, tu flujo se desplegará con la configuración del snapshot.
Acceder al Dispositivo:
- Ve a <ip_address_recomputer>:1881/ui en tu navegador.

Soporte Técnico y Discusión de Producto

¡Gracias por elegir nuestros productos! Ofrecemos distintos canales de soporte para cubrir diferentes preferencias y necesidades.

Introducción​

Antes de Comenzar​

Preparación de Hardware​

Preparación de Software​

Instalando Node.js para FlowFuse en reComputer​

Crear una Cuenta en FlowFuse​

Creación de una Aplicación en FlowFuse​

Creando un Flujo en FlowFuse​

Agregando y configurando un Dispositivo en FlowFuse​

Instalar el Device Agent​

Configurar el Device Agent​

Desplegando el Flujo en un Dispositivo​

Crear un Snapshot​

Enviando el Snapshot al Dispositivo​

Soporte Técnico y Discusión de Producto​