reComputer R1000 与 FlowFuse

note

本文档由 AI 翻译。如您发现内容有误或有改进建议，欢迎通过页面下方的评论区，或在以下 Issue 页面中告诉我们：https://github.com/Seeed-Studio/wiki-documents/issues

介绍

FlowFuse 通过添加协作开发、远程部署管理、支持 DevOps 交付管道以及托管 Node-RED 应用程序的功能来增强 Node-RED。它是一个专门为 Node-RED 应用程序的开发和交付设计的 DevOps 平台，使团队能够更轻松地协作并高效地部署项目。

开始

在开始这个项目之前，您可能需要按照以下说明提前准备好硬件和软件。

硬件准备

reComputer R1000

立即购买 🖱️

软件准备

在 reComputer 上安装 Node.js 以支持 FlowFuse

为了让您的 reComputer 支持 FlowFuse，您需要安装 Node.js。按照以下步骤安装 Node.js 版本 20：

准备 Node.js 仓库

首先，更新您的软件包列表并安装必要的证书和工具：

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

设置 NodeSource 仓库

接下来，在您的 reComputer 上设置 NodeSource 仓库：

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

添加 Node.js 仓库

根据 FlowFuse 文档建议，推荐安装 Node.js 版本 20。将 NODE_MAJOR 变量设置为 20：

NODE_MAJOR=20

将 Node.js 仓库添加到您的 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

再次更新您的软件包列表以包含 Node.js 仓库：

sudo apt update

安装 Node.js

最后，安装 Node.js：

sudo apt install nodejs

现在，您已经在设备上安装了 Node.js 版本 20。

要开始使用 FlowFuse，您需要创建一个账户并验证您的电子邮件。按照以下简单步骤操作：

创建账户

访问注册页面：
- 前往 FlowFuse 账户创建页面。
填写注册表单：
- 用户名：选择一个唯一的用户名。
- 全名：输入您的全名。
- 邮箱：提供一个有效的邮箱地址。
- 密码：创建一个强密码。
提交表单：
- 填写所有必填字段后，点击“创建账户”按钮。

检查您的邮箱：
- 前往您的邮箱收件箱，查找来自 FlowFuse 的验证邮件。
打开验证邮件：
- 打开邮件并使用代码验证邮箱。
返回 FlowFuse 登录页面：
- 前往 FlowFuse 登录页面。
输入您的凭证：
- 用户名/邮箱：输入您注册时使用的用户名或邮箱。
- 密码：输入您的密码。

在 FlowFuse 中创建应用程序

为了组织您的 Node-RED 实例，它们会被分组到应用程序中。在您的应用程序中，您可以拥有一个或多个 Node-RED 实例。实例是一个定制版本的 Node-RED，包含各种 FlowFuse 插件以与平台集成。

导航到应用程序部分：
- 在 FlowFuse 仪表板上，点击 创建应用程序。

填写应用程序详情：
- 名称：输入您的应用程序名称。
- 描述：提供您的应用程序的简短描述。
- 实例名称：选择您的 Node-RED 实例名称。
- 蓝图：选择 空白工作区 作为蓝图。
- Node-RED 版本：从下拉菜单中选择最新的 Node-RED 版本。

创建应用程序：
- 填写所有详情后，点击 创建 按钮。

在 FlowFuse 中创建流程

让我们在 Node-RED 中创建一个流程，用于生成随机数并在仪表板上显示。如果您是 Node-RED 的新手，可以访问我们的 Node-RED 入门指南。以下是创建流程的步骤：

打开 Node-RED 编辑器：
- 前往您的实例并选择您刚创建的实例。
- 点击 打开编辑器 启动 Node-RED 编辑器。

安装所需节点：
- 您可能默认看不到 random 节点和 gauge 节点。要安装这些节点：
- 前往右上角菜单，选择 管理调色板。
- 转到 安装 标签。
- 搜索 Random 和 Dashboard 节点并安装它们。

创建流程：
- 复制以下流程并将其导入到您的 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
    }
]

部署流程：
- 点击右上角的 部署 按钮以部署您的流程。

在 FlowFuse 中添加和配置设备

按照以下步骤在 FlowFuse 中添加和配置设备：

在 FlowFuse 仪表板中，导航到 Devices 部分。
点击 Add Device 按钮。

填写设备详细信息。
点击 Add 按钮以创建您的设备。

复制设备配置

添加设备后，您将看到设备配置。
在手动说明部分，复制提供的代码片段。您需要这些凭据将设备连接到 FlowFuse 云。

安装设备代理

在您的 reComputer 终端上，运行以下命令以安装 FlowFuse 设备代理：

sudo npm install -g @flowfuse/device-agent

配置设备代理

创建配置目录：
- 逐一运行以下命令以创建配置目录并设置适当的权限：

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

创建并编辑配置文件：
- 打开一个名为 device.yml 的新配置文件：

nano device.yml

将复制的设备配置粘贴到此文件中，并通过按 Ctrl + X，然后 Y，最后按 Enter 保存。

运行设备代理：
- 执行以下命令以启动 FlowFuse 设备代理：

flowfuse-device-agent --port=1881

您的设备现在已配置并连接到 FlowFuse 云，可以使用了。

部署流程到设备

要将流程部署到您的设备，您需要创建 Node-RED 实例的快照并将其推送到 reComputer 终端。请按照以下步骤操作：

创建快照

导航到应用程序：
- 转到您的 FlowFuse 应用程序并选择您创建的实例。

选择 'Snapshot'：
- 点击实例菜单中的 Snapshot 选项。

创建新快照：
- 由于尚无快照，您需要创建一个。
- 点击 Create Snapshot。

填写快照详细信息：
- Name：输入快照的名称。
- Description：提供快照的简要描述。
- Set as Target：勾选此框以将此快照设置为目标。

创建快照：
- 点击 Create 按钮以创建快照。这将捕获您的 Node-RED 实例的当前状态，包括流程、凭据、环境变量、NPM 包（带锁定版本）和运行时设置。

将快照推送到设备

要将快照部署到您的设备，请按照以下步骤操作：

进入设备部分

在 FlowFuse 仪表板中，进入 Devices 部分。

选择设备

找到您之前创建并配置的设备。
点击设备名称旁边的三个点。
点击 Add Instance。

将实例添加到设备

选择您之前创建的应用程序和实例。
点击 Add 按钮。

部署流程

您的流程将在几秒钟内部署到设备上。它将按照快照中捕获的配置和设置运行。

访问设备

在您的网络浏览器中导航到 <ip_address_recomputer>:1881/ui，即可访问您的设备。

技术支持与产品讨论

感谢您选择我们的产品！我们致力于为您提供多种支持，以确保您使用我们的产品时体验顺畅。我们提供多种沟通渠道，以满足不同的偏好和需求。

介绍​

开始​

硬件准备​

软件准备​

在 reComputer 上安装 Node.js 以支持 FlowFuse​

创建账户​

在 FlowFuse 中创建应用程序​

在 FlowFuse 中创建流程​

在 FlowFuse 中添加和配置设备​

安装设备代理​

配置设备代理​

部署流程到设备​

创建快照​

将快照推送到设备​

技术支持与产品讨论​

介绍

开始