Despliega Node-RED en un clic

¿Qué es Node-RED?

Node-RED es una herramienta de programación low-code y de código abierto para aplicaciones orientadas a eventos, que a menudo se usa en lugar de Zapier o IFTTT. En su editor, en el navegador, arrastras nodos a un lienzo y los conectas en flujos: un mensaje entra desde una petición HTTP, un topic MQTT, un webhook o un temporizador, pasa por nodos que lo modifican, lo filtran o lo enrutan, y sale hacia una base de datos, una API o un chat. Un nodo Function ejecuta tu propio JavaScript donde ningún nodo sirve, y la biblioteca de la comunidad tiene más de 6000 nodos que se instalan desde el editor.

Node-RED nació en IBM en 2013 y hoy es un proyecto de la OpenJS Foundation. Se usa para domótica, a menudo junto a Home Assistant, para datos de IoT e industriales y como pegamento entre servicios web, y quienes lo autoalojan lo hacen para ejecutar sus automatizaciones las 24 horas sin pagar por cada ejecución. Esta plantilla solo deja entrar en el editor con el nombre de usuario y la contraseña indicados. El inconveniente: las rutas de los nodos HTTP In son públicas, así que un endpoint que deba ser privado necesita httpNodeAuth en settings.js o una comprobación propia.

Hosting de Node-RED en Pethost

1. Inicias sesión en Pethost con una passkey, GitHub o Google. ¿Aún no tienes máquina? Eliges un plan, y el enlace espera hasta que esté lista.
2. Nuevo proyecto se abre en Node-RED. Rellenas lo que pide y haces clic en Crear proyecto: Nombre de usuario, Contraseña de administrador.
3. En un par de minutos Node-RED está en marcha en su propia dirección con HTTPS. Sus secretos se generan al azar, y sus datos entran en el backup de cada noche.
4. Es un proyecto como cualquier otro: tú o tu agente lo pueden cambiar, volver a una versión anterior o restaurar.

Preguntas sobre Node-RED

El archivo Docker Compose de Node-RED

La plantilla es este compose.yaml y las variables que se escriben en el .env del proyecto al crearlo. Pethost ejecuta el archivo tal como está escrito.

Contenedores: node-red (nodered/node-red:5).

Volúmenes, en el backup de cada noche: data.

services:
  node-red:
    image: nodered/node-red:5
    restart: unless-stopped
    environment:
      TZ: ${TZ:-UTC}
      ADMIN_USERNAME: ${ADMIN_USERNAME}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
    # The editor would be open to anyone with the address. Node-RED starts with the settings of
    # /data/settings.js, which are yours to edit, and with the username and password of the
    # project's .env as its only sign-in, unless settings.js sets adminAuth itself.
    entrypoint: ["/bin/bash", "-c"]
    command:
      - |
        # The first start: settings.js to edit, and no flow, where the image's would warn of a
        # missing volume, which the project has.
        if [ ! -f /data/settings.js ]; then
          cp node_modules/node-red/settings.js /data/settings.js
          rm -f /data/flows.json
        fi
        cat > /tmp/settings.js <<'END'
        const { createHash, timingSafeEqual } = require("node:crypto");
        const settings = require("/data/settings.js");
        const digest = (text) => createHash("sha256").update(String(text)).digest();
        const user = (username) => (username === process.env.ADMIN_USERNAME ? { username, permissions: "*" } : null);
        settings.adminAuth ??= {
          type: "credentials",
          users: async (username) => user(username),
          authenticate: async (username, password) =>
            timingSafeEqual(digest(password), digest(process.env.ADMIN_PASSWORD)) ? user(username) : null
        };
        module.exports = settings;
        END
        exec ./entrypoint.sh --settings /tmp/settings.js
    volumes:
      - data:/data

volumes:
  data:

compose.yamlVerla en GitHub