FlowFuse Node-RED Container 技术文档

1. 镜像概述和主要用途

FlowFuse Node-RED Container 是用于 FlowFuse Stacks 部署的基础容器镜像，专为 Kubernetes 和 Docker Compose 环境设计。该镜像基于最新版 Node-RED 容器构建，集成了 FlowFuse 平台专用的启动器模块，实现 Node-RED 与 FlowFuse 平台的无缝集成，支持 FlowFuse Stacks 在容器化环境中的标准化部署和运行。

2. 核心功能和特性

• 基于最新 Node-RED：镜像构建自最新版 Node-RED ***容器，继承 Node-RED 的全部核心功能，包括流程编排、节点管理、可视化编程等。
• 集成 FlowFuse 启动器：内置 FlowFuse 平台专用启动器模块，负责 Node-RED 与 FlowFuse 平台的通信、配置同步及生命周期管理。
• 多环境支持：原生适配 Kubernetes 和 Docker Compose 部署环境，满足 FlowFuse Stacks 在不同容器编排平台的运行需求。
• 标准化部署：作为 FlowFuse Stacks 的基础组件，确保部署流程的一致性和兼容性，简化集群或单机环境的配置复杂度。

3. 使用场景和适用范围

• FlowFuse Stacks 容器化部署：适用于在 Kubernetes 集群或 Docker Compose 环境中部署 FlowFuse Stacks，实现 Node-RED 工作流的集中管理和运维。
• 企业级 Node-RED 集成：需将 Node-RED 与 FlowFuse 平台集成的场景，例如团队协作、工作流版本控制、资源监控等企业级功能需求。
• 混合环境部署：支持从本地开发环境（Docker Compose）到生产集群（Kubernetes）的平滑迁移，适配不同阶段的部署需求。

4. 使用方法和配置说明

4.1 Docker 运行命令示例

通过 docker run 命令直接启动容器（需替换 <镜像标签> 为实际版本，如 latest）：

bash
docker run -d \
  --name flowfuse-node-red \
  -p 1880:1880 \  # Node-RED 默认端口映射
  -v ./data:/data \  # 挂载数据卷持久化配置
  flowfuse/node-red:<镜像标签>

4.2 Docker Compose 配置示例

在 Docker Compose 环境中集成该镜像（创建 docker-compose.yml 文件）：

yaml
version: '3.8'
services:
  flowfuse-node-red:
    image: flowfuse/node-red:<镜像标签>
    container_name: flowfuse-node-red
    ports:
      - "1880:1880"  # 暴露 Node-RED 访问端口
    volumes:
      - ./node-red-data:/data  # 持久化 Node-RED 配置和流程数据
    restart: unless-stopped  # 配置自动重启策略
    environment:
      - NODE_ENV=production  # 设置运行环境（开发/生产）
      # 其他 FlowFuse 平台集成所需环境变量（具体参数需参考 FlowFuse ***文档）

4.3 Kubernetes 部署提示

在 Kubernetes 环境中，通常通过 Deployment 或 StatefulSet 资源定义部署，示例片段如下（完整配置需结合 FlowFuse Stacks *** Helm Chart 或 YAML 模板）：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: flowfuse-node-red
spec:
  replicas: 1
  selector:
    matchLabels:
      app: flowfuse-node-red
  template:
    metadata:
      labels:
        app: flowfuse-node-red
    spec:
      containers:
        - name: flowfuse-node-red
          image: flowfuse/node-red:<镜像标签>
          ports:
            - containerPort: 1880
          volumeMounts:
            - name: data-volume
              mountPath: /data
      volumes:
        - name: data-volume
          persistentVolumeClaim:
            claimName: flowfuse-node-red-pvc  # 需提前创建 PVC

4.4 配置参数说明

当前镜像的详细配置参数（如环境变量、启动参数）需参考 FlowFuse ***文档。基础配置项包括：

• 数据卷挂载：/data 目录用于持久化 Node-RED 配置、流程数据及用户设置，建议通过外部卷挂载实现数据持久化。
• 端口映射：默认暴露 1880 端口（Node-RED Web 界面及 API），需根据实际网络策略配置端口映射或 Ingress 规则。
• 环境变量：可通过 NODE_ENV 等变量调整运行模式，FlowFuse 平台集成相关变量（如平台地址、认证令牌等）需根据部署指南补充。

注：具体配置细节及高级参数请参考 FlowFuse ***文档，确保与 FlowFuse Stacks 版本匹配。