Skip to main content

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:

  1. 准备 Node.js 仓库

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

sudo apt update
sudo apt install -y ca-certificates curl gnupg
  1. 设置 NodeSource 仓库

接下来,在您的 reComputer 上设置 NodeSource 仓库:

curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg
  1. 添加 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
  1. 安装 Node.js

最后,安装 Node.js:

sudo apt install nodejs

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

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

创建账户

  1. 访问注册页面

  2. 填写注册表单

    • 用户名:选择一个唯一的用户名。
    • 全名:输入您的全名。
    • 邮箱:提供一个有效的邮箱地址。
    • 密码:创建一个强密码。
  3. 提交表单

    • 填写所有必填字段后,点击“创建账户”按钮。
  1. 检查您的邮箱

    • 前往您的邮箱收件箱,查找来自 FlowFuse 的验证邮件。
  2. 打开验证邮件

    • 打开邮件并使用代码验证邮箱。
  3. 返回 FlowFuse 登录页面

    • 前往 FlowFuse 登录页面。
  4. 输入您的凭证

    • 用户名/邮箱:输入您注册时使用的用户名或邮箱。
    • 密码:输入您的密码。
  1. 登录
    • 点击 登录 按钮访问您的 FlowFuse 账户,您可能会被要求创建一个团队。

在 FlowFuse 中创建应用程序

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

  1. 导航到应用程序部分
    • 在 FlowFuse 仪表板上,点击 创建应用程序
  1. 填写应用程序详情
    • 名称:输入您的应用程序名称。
    • 描述:提供您的应用程序的简短描述。
    • 实例名称:选择您的 Node-RED 实例名称。
    • 蓝图:选择 空白工作区 作为蓝图。
    • Node-RED 版本:从下拉菜单中选择最新的 Node-RED 版本。
  1. 创建应用程序
    • 填写所有详情后,点击 创建 按钮。

在 FlowFuse 中创建流程

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

  1. 打开 Node-RED 编辑器
    • 前往您的实例并选择您刚创建的实例。
    • 点击 打开编辑器 启动 Node-RED 编辑器。
  1. 安装所需节点
    • 您可能默认看不到 random 节点和 gauge 节点。要安装这些节点:
    • 前往右上角菜单,选择 管理调色板
    • 转到 安装 标签。
    • 搜索 RandomDashboard 节点并安装它们。
  1. 创建流程
    • 复制以下流程并将其导入到您的 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
}
]
  1. 部署流程
    • 点击右上角的 部署 按钮以部署您的流程。

在 FlowFuse 中添加和配置设备

  1. 按照以下步骤在 FlowFuse 中添加和配置设备
  • 在 FlowFuse 仪表板中,导航到 Devices 部分。
  • 点击 Add Device 按钮。
  • 填写设备详细信息。
  • 点击 Add 按钮以创建您的设备。
  1. 复制设备配置
  • 添加设备后,您将看到设备配置。
  • 在手动说明部分,复制提供的代码片段。您需要这些凭据将设备连接到 FlowFuse 云。

安装设备代理

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

sudo npm install -g @flowfuse/device-agent

配置设备代理

  1. 创建配置目录
    • 逐一运行以下命令以创建配置目录并设置适当的权限:
   sudo mkdir /opt/flowfuse-device
sudo chown -R $USER /opt/flowfuse-device
sudo su
cd /
cd opt/flowfuse-device
  1. 创建并编辑配置文件
    • 打开一个名为 device.yml 的新配置文件:
nano device.yml
  • 将复制的设备配置粘贴到此文件中,并通过按 Ctrl + X,然后 Y,最后按 Enter 保存。
  1. 运行设备代理
    • 执行以下命令以启动 FlowFuse 设备代理:
flowfuse-device-agent --port=1881

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

部署流程到设备

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

创建快照

  1. 导航到应用程序
    • 转到您的 FlowFuse 应用程序并选择您创建的实例。
  1. 选择 'Snapshot'
    • 点击实例菜单中的 Snapshot 选项。
  1. 创建新快照
    • 由于尚无快照,您需要创建一个。
    • 点击 Create Snapshot
  1. 填写快照详细信息
    • Name:输入快照的名称。
    • Description:提供快照的简要描述。
    • Set as Target:勾选此框以将此快照设置为目标。
  1. 创建快照
    • 点击 Create 按钮以创建快照。这将捕获您的 Node-RED 实例的当前状态,包括流程、凭据、环境变量、NPM 包(带锁定版本)和运行时设置。

将快照推送到设备

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

  1. 进入设备部分
  • 在 FlowFuse 仪表板中,进入 Devices 部分。
  1. 选择设备
  • 找到您之前创建并配置的设备。
  • 点击设备名称旁边的三个点。
  • 点击 Add Instance
  1. 将实例添加到设备
  • 选择您之前创建的应用程序和实例。
  • 点击 Add 按钮。
  1. 部署流程
  • 您的流程将在几秒钟内部署到设备上。它将按照快照中捕获的配置和设置运行。
  1. 访问设备
  • 在您的网络浏览器中导航到 <ip_address_recomputer>:1881/ui,即可访问您的设备。

技术支持与产品讨论

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

Loading Comments...