Skip to Content

安装

搭建您自己的工厂本地 IronFlock 实例只需几分钟。从一台空白的工业 PC 到完全运行的平台——只需几个步骤,无需任何手动配置。

要求

  • 一台工业 PC(或虚拟机),运行基于 Debian 或 Ubuntu、带有 systemd 的 Linux,并具有安装期间的互联网访问能力。
  • ARM64 或 AMD64 架构。
  • 主机上装有 gpgv 或 sqv:ironflock 的安装脚本用它来检查 IronFlock 的签名。每个 Debian 和 Ubuntu 安装都自带其中之一。ironflock 本身会在安装 Appliance 的每个发布版本之前对其进行检查。
  • SSD 存储,最好是 NVMe。机器数据保存在时序数据库中,在机械硬盘上会变慢。
  • CPU、内存和存储请参见下表。
用途CPU内存存储
评估与测试2 核4 GB64 GB SSD
少量机器的试点4 核8 GB128 GB SSD
生产4 核16 GB256–512 GB NVMe SSD

以上配置假设该机器只运行 Appliance。在 Appliance 本身上安装的应用需要额外的资源。

空闲时(没有机器数据传入),Appliance 及其操作系统大约使用 2.5 GB 内存和一个 CPU 核的一小部分。负载来自您的机器数据:有多少设备发送数据、发送频率如何、在这些数据上运行的转换和告警,以及同时使用仪表板的人数。

存储随您保留的数据增长:机器数据的历史记录、文件,以及 Appliance 镜像仓库中的应用镜像。如需长期保存机器数据历史,请规划 500 GB 以上。请保留空闲空间:当空闲空间少于 3 GB 时,Appliance 将停止接收新数据,直到您释放空间。

安装会在安装时和每次更新时,根据机器的内存和 CPU 核数调整 Appliance 的数据库。如果您之后增加内存或 CPU 核,或扩容虚拟机,数据库会在下一次更新到新发布版本之后使用这些资源;运行带 Appliance 当前版本的 sudo ironflock appliance install --version <version>(ironflock status 会显示该版本)则会立即使用。

时间同步 (NTP)

在安装之前,把 Appliance 主机指向一台它确实能访问到的时间服务器。系统时钟不是装饰:TLS 证书校验、许可证的定期复核、远程访问令牌,以及机器产生的每一个数据点的时间戳,都依赖它。偏差达到分钟级的主机会带来证书错误、登录失败,以及与车间实际发生的情况对不上的历史数据。

在企业网络中,操作系统自带的公共时间服务器通常无法访问,因为出站 NTP 所用的 UDP 123 端口在防火墙上被拦截。这不会有明显的报错——主机只是从未同步过,然后一路偏走。请向 IT 部门索取内部时间服务器并在主机上配置,或请他们放行出站 UDP 123。

使用 systemd-timesyncd(Debian 和 Ubuntu 的默认方式):

sudo mkdir -p /etc/systemd/timesyncd.conf.d sudo tee /etc/systemd/timesyncd.conf.d/corporate.conf > /dev/null <<'EOF' [Time] NTP=ntp.your-company.com EOF sudo systemctl restart systemd-timesyncd timedatectl status

使用 chrony:

echo "server ntp.your-company.com iburst" | sudo tee -a /etc/chrony/chrony.conf sudo systemctl restart chrony chronyc sources

在安装 Appliance 之前,timedatectl status 必须显示 System clock synchronized: yes。

虚拟机比物理硬件偏移得更快。如果 Appliance 运行在虚拟机中,请同时启用虚拟化平台的来宾时间同步,并且仍然在来宾系统内配置 NTP。

步骤

  1. 创建账户:在 ironflock.com 上创建账户。

  2. 生成 Instance Key:在 IronFlock UI 中打开 个人资料 → 实例,选择适合您用例的方案,创建一个新的 Instance Key。复制该密钥,并将其保存到 appliance 主机上的一个文件中,例如 license.txt。ironflock 命令把 Instance Key 称为许可证密钥(license key):两者是同一个密钥。

  3. 安装 ironflock:在您的 appliance 主机上打开终端并运行:

    curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash

    这会将 ironflock 命令安装为 /usr/local/bin/ironflock,Appliance 需要它位于这里。命令行工具的安装一页说明了该脚本做了什么,以及如何在运行前检查它(先验证安装脚本)。

  4. 安装 Appliance:

    # 位于企业代理之后?运行前请先阅读下方说明。 sudo ironflock appliance install --license-file license.txt

    该命令下载最新的发布版本,用 IronFlock 的 Appliance 发布密钥检查它,在缺少 Docker 时安装 Docker,安装主机自己的设备代理程序,然后启动 Appliance。它会等到每个服务都健康、并且 ironflock.com 能访问到 Appliance,然后在终端上显示 Web UI 的管理员登录信息,只显示一次。Appliance 将 Instance Key 保存在 /opt/ironflock/license.env 中,因此之后可以删除 license.txt。如果命令中途停止,请再次运行同一条命令:它会从停止的地方继续。

    其选项(HTTPS、发布通道、代理等)的说明见 ironflock appliance install。

    位于企业代理之后? 如果 Appliance 只能通过企业 HTTP 代理访问互联网,您必须在安装命令中提供该代理,Docker 守护进程才能拉取镜像——否则安装会在登录步骤处中断。请参阅位于企业代理之后。

就是这样。安装完成后,完整的 IronFlock 平台在 Appliance 上运行,并在每次开机时再次启动。

注意:Appliance 命令是 ironflock 2.1.0 版本中新增的。它们已在一台全新的 Ubuntu 24.04 虚拟机(amd64)上通过了一次从安装到移除的测试运行;参见 Appliance 命令。

选择模式

安装会将 Appliance 设置为纯 HTTP 模式,该模式无需企业 IT 提供任何东西。如需受信任的 https:// 地址——使用 Appliance 自行签发的 CA 或使用您的企业证书——请参阅 HTTPS 与证书。如果 Appliance 只能通过 HTTP 代理访问互联网,请参阅位于企业代理之后。

Last updated on