快速开始

5 分钟完成 Ice 规则引擎的部署、集成和第一次规则执行。

前置了解

Ice 由三部分组成：

  • Ice Server — 可视化规则配置管理平台，提供 Web 界面
  • Ice Client — 规则执行 SDK，集成到你的业务应用中
  • 共享存储 — Server 和 Client 通过共享文件目录（ice-data/）实现配置同步，无需网络通信
Server → 写入配置 → ice-data/ ← 读取配置 ← Client

第一步：部署 Server

Docker 部署（推荐）

docker run -d --name ice-server \
  -p 8121:8121 \
  -v ./ice-data:/app/ice-data \
  waitmoon/ice-server:latest

启动后访问 http://localhost:8121 进入管理界面。

在线体验：eg.waitmoon.com

手动部署

从 waitmoon.com/downloads 下载对应平台包：

tar -xzvf ice-server-linux-amd64.tar.gz && cd ice-server-linux-amd64
sh ice.sh start

第二步：集成 Client SDK

在业务应用中添加依赖并启动 Client。Server 和 Client 必须共享同一个 ice-data 目录。

Spring 项目

Spring/SpringBoot 项目需要额外配置一个桥接类，让叶子节点能注入 Spring Bean。详见 Java SDK 指南。

第三步：开发叶子节点

叶子节点是执行业务逻辑的地方。继承对应基类，类中的字段会自动出现在 Server 配置界面：

第四步：配置并执行

在 Server 中配置规则

  1. 创建应用（App）
  2. 新建规则（Ice），获得 iceId
  3. 添加关系节点和叶子节点，组成规则树
  4. 配置叶子节点参数
  5. 点击发布

在代码中执行

共享存储部署方案

场景方案
本地开发Server 和 Client 使用同一个本地路径
Docker通过 -v 挂载到相同宿主机目录
分布式部署NFS / 阿里云 NAS / AWS EFS

常见问题

Client 无法加载配置？ 检查 storagePath 是否和 Server 指向同一个 ice-data 目录。

规则修改后不生效？ 确保在 Server 界面点击了「发布」。Client 默认每 5 秒轮询一次配置变更。

启动时报节点类找不到？ 检查叶子节点类是否在 Client 配置的扫描包路径下，且类名是否正确。

更多问题参见 FAQ。

下一步