reComputer R1000 con FlowFuse

Introducción

FlowFuse mejora Node-RED agregando características para desarrollo colaborativo, gestión de despliegues remotos, soporte para pipelines de entrega DevOps, y alojamiento de aplicaciones Node-RED. Sirve como una plataforma DevOps específicamente diseñada para el desarrollo y entrega de aplicaciones Node-RED, facilitando que los equipos trabajen juntos y desplieguen sus proyectos de manera eficiente.

Comenzando

Antes de iniciar este proyecto, es posible que necesites preparar tu hardware y software con anticipación como se describe aquí.

Preparación del Hardware

reComputer R1000

Obtén Uno Ahora 🖱️

Preparación del Software

Instalación de Node.js para FlowFuse en un reComputer

Para preparar tu reComputer para FlowFuse, necesitas instalar Node.js. Sigue estos pasos para instalar Node.js versión 20:

Preparación para el Repositorio de Node.js

Primero, actualiza tu lista de paquetes e instala los certificados y herramientas necesarios:

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

Configuración del Repositorio NodeSource

A continuación, configura el repositorio NodeSource en tu reComputer:

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

Agregando el Repositorio de Node.js

Según la documentación de FlowFuse, se recomienda instalar Node.js versión 20. Establece la variable NODE_MAJOR a 20:

NODE_MAJOR=20

Añade el repositorio de Node.js a la lista de fuentes de 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

Actualiza tu lista de paquetes nuevamente para incluir el repositorio de Node.js:

sudo apt update

Instalando Node.js

Finalmente, instala Node.js:

sudo apt install nodejs

Ahora tienes Node.js versión 20 instalado en tu dispositivo.

Para comenzar a usar FlowFuse, necesitarás crear una cuenta y verificar tu correo electrónico. Sigue estos sencillos pasos:

Crear una Cuenta

Visita la Página de Registro:
- Ve a Creación de Cuenta FlowFuse.
Completa el Formulario de Registro:
- Nombre de usuario: Elige un nombre de usuario único.
- Nombre completo: Ingresa tu nombre completo.
- Correo electrónico: Proporciona una dirección de correo electrónico válida.
- Contraseña: Crea una contraseña segura.
Envía el Formulario:
- Después de completar todos los campos requeridos, haz clic en el botón 'Crear Cuenta'.

Revisa tu Correo Electrónico:
- Ve a tu bandeja de entrada de correo electrónico y busca un correo de verificación de FlowFuse.
Abre el Correo de Verificación:
- Abre el correo electrónico y usando el código verifica el correo.
Regresa a la Página de Inicio de Sesión de FlowFuse:
- Ve a la página de inicio de sesión de FlowFuse.
Ingresa tus Credenciales:
- Nombre de usuario/Correo electrónico: Ingresa el nombre de usuario o correo electrónico con el que te registraste.
- Contraseña: Ingresa tu contraseña.

Iniciar Sesión:
- Haz clic en el botón Iniciar Sesión para acceder a tu cuenta de FlowFuse. y es posible que te pidan crear un equipo.

Crear una Aplicación en FlowFuse

Para organizar tus instancias de Node-RED, se agrupan dentro de Aplicaciones. Dentro de tu Aplicación, puedes tener una o más Instancias de Node-RED. La Instancia es una versión personalizada de Node-RED que incluye varios plugins de FlowFuse para integrarlo con la plataforma.

Navega a la Sección de Aplicación:
- En el panel de FlowFuse, haz clic en Crear Aplicación.

Completa los Detalles de la Aplicación:
- Nombre: Ingresa un nombre para tu aplicación.
- Descripción: Proporciona una breve descripción de tu aplicación.
- Nombre de Instancia: Elige un nombre para tu instancia de Node-RED.
- Blueprint: Selecciona Espacio de Trabajo en Blanco como el blueprint.
- Versión de Node-RED: Elige la última versión de Node-RED del menú desplegable.

Crear la Aplicación:
- Después de completar todos los detalles, haz clic en el botón Crear.

Crear un Flujo en FlowFuse

Vamos a crear un flujo en Node-RED para generar un número aleatorio y mostrarlo en un panel de control. Si eres nuevo en Node-RED, puedes visitar nuestra guía de Introducción a Node-RED. Pasos para Crear un Flujo

Abrir el Editor de Node-RED:
- Ve a tu instancia y selecciona la instancia que acabas de crear.
- Haz clic en Abrir Editor para lanzar el editor de Node-RED.

Instalar Nodos Requeridos:
- Es posible que no veas el nodo random y el nodo gauge por defecto. Para instalar estos:
- Ve al menú superior derecho, selecciona Administrar paleta.
- Ve a la pestaña Instalar.
- Busca los nodos Random y Dashboard e instálalos.

Crear el Flujo:
- Copia el siguiente flujo e impórtalo en tu editor de Node-RED para ahorrar tiempo:

[
    {
        "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 el botón Deploy en la esquina superior derecha para desplegar tu flujo.

Agregar y Configurar un Dispositivo en FlowFuse

Para agregar y configurar un dispositivo en FlowFuse, sigue estos pasos:

En el panel de FlowFuse, navega a la sección Devices.
Haz clic en el botón Add Device.

Completa los Detalles del Dispositivo
Haz clic en el botón Add para crear tu dispositivo.

Copiar la Configuración del Dispositivo

Después de agregar el dispositivo, se te presentará una Configuración del Dispositivo.
Bajo las instrucciones manuales, copia el fragmento de código proporcionado. Necesitarás estas credenciales para conectar el dispositivo con la nube de FlowFuse.

Instalación del Agente del Dispositivo

En tu terminal de reComputer, ejecuta el siguiente comando para instalar el agente de dispositivo de FlowFuse:

sudo npm install -g @flowfuse/device-agent

Configurando el Agente del Dispositivo

Crear Directorio de Configuración: - Ejecuta los siguientes comandos uno por uno para crear el directorio de configuración y establecer los permisos apropiados:

   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:** - Abrir un nuevo archivo de configuración llamado device.yml:

nano device.yml

Pega la configuración del dispositivo copiada en este archivo y guárdalo presionando Ctrl + X, luego Y, y Enter.

Ejecuta el Agente del Dispositivo: - Ejecuta el siguiente comando para iniciar el agente de dispositivo FlowFuse:

flowfuse-device-agent --port=1881

Tu dispositivo ahora está configurado y conectado a la nube de FlowFuse, listo para usar.

Desplegando el Flujo a un Dispositivo

Para desplegar el flujo a tu dispositivo, necesitas crear una instantánea de tu instancia de Node-RED y enviarla al terminal reComputer. Sigue estos pasos:

Crear una Instantánea

Navegar a la Aplicación:
- Ve a tu aplicación FlowFuse y selecciona la instancia que creaste.

Seleccionar 'Snapshot':
- Haz clic en la opción Snapshot en el menú de la instancia.

Crear una Nueva Instantánea:
- Como no hay instantáneas aún, necesitas crear una.
- Haz clic en Create Snapshot.

Completar los Detalles de la Instantánea:
- Name: Ingresa un nombre para tu instantánea.
- Description: Proporciona una breve descripción de la instantánea.
- Set as Target: Marca la casilla para establecer esta instantánea como objetivo.

Crear la Instantánea:
- Haz clic en el botón Create para crear la instantánea. Esto capturará el estado actual de tu instancia de Node-RED, incluyendo flujos, credenciales, variables de entorno, paquetes NPM (con versiones bloqueadas) y configuraciones de tiempo de ejecución.

Enviando la Instantánea al Dispositivo

Para desplegar la instantánea a tu dispositivo, sigue estos pasos:

Ir a la Sección de Dispositivos

En el panel de FlowFuse, ve a la sección Devices.

Seleccionar el Dispositivo

Encuentra el dispositivo que creaste y configuraste anteriormente.
Toca los tres puntos junto al nombre del dispositivo.
Haz clic en Add Instance.

Agregar la Instancia al Dispositivo

Elige la aplicación e instancia que creaste anteriormente.
Haz clic en el botón Add.

Desplegar el Flujo

Tu flujo será desplegado al dispositivo en unos pocos segundos. Se ejecutará con las configuraciones y ajustes capturados en la instantánea.

Acceder al Dispositivo

Ve a tu dispositivo navegando a <ip_address_recomputer>:1881/ui en tu navegador web.

Soporte Técnico y Discusión de Productos

¡Gracias por elegir nuestros productos! Estamos aquí para brindarte diferentes tipos de soporte para asegurar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para atender diferentes preferencias y necesidades.

Introducción​

Comenzando​

Preparación del Hardware​

Preparación del Software​

Instalación de Node.js para FlowFuse en un reComputer​

Crear una Cuenta​

Crear una Aplicación en FlowFuse​

Crear un Flujo en FlowFuse​

Agregar y Configurar un Dispositivo en FlowFuse​

Instalación del Agente del Dispositivo​

Configurando el Agente del Dispositivo​

Desplegando el Flujo a un Dispositivo​

Crear una Instantánea​

Enviando la Instantánea al Dispositivo​

Soporte Técnico y Discusión de Productos​