ice

Get started

Try to access and use it~

Install dependencies

Install mysql, new ice database to store configuration

CREATE DATABASE IF NOT EXISTS ice Character Set utf8mb4;

Remarks: If the ice-related table cannot be found during startup, you need to manually create the ice-related table structure. The sql address of the table structure:

https://github.com/zjn-zjn/ice/blob/master/ice-server/src/main/resources/sql/ice.sqlopen in new window

Install server

Download the installation package(latest v1.3.0)

http://waitmoon.com/downloads/open in new window

Unzip the tar package

tar -xzvf ice-server-*.tar.gz

Edit configuration file

server:
  port: 8121 #Port
spring:
  datasource: #Database configuration
    url: jdbc:mysql://127.0.0.1:3306/ice?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&serverTimezone=Asia/Shanghai&useSSL=false
    username: username
    password: password
    initialization-mode: always
ice:
  port: 18121 #port for client
#  ha: #ha config, now default zk
#    address: localhost:2181,localhost:2182,localhost:2183
  pool: #Thread pool configuration (used to update the client)
    core-size: 4
    max-size: 4
    keep-alive-seconds: 60
    queue-capacity: 60000

start/stop/restart server

start up sh ice.sh start

stop sh ice.sh stop

reboot sh ice.sh restart

Open configuration backend

http://localhost:8121/

Example backend reference

Deploy for testing & experience address (only app=1 has real deployed client)

http://eg.waitmoon.comopen in new window

Client access

Refer to github ice-test module

Add pom dependency

<dependency>
  <groupId>com.waitmoon.ice</groupId>
  <artifactId>ice-client-spring-boot-starter</artifactId>
  <version>1.3.0</version>
</dependency>

High availability additional dependencies

<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-recipes</artifactId>
    <version>5.2.1</version>
</dependency>

Add ice configuration

ice: #ice client configuration
  app: 1 #corresponds to the background configuration app
#  server: zookeeper:localhost:2181,localhost:2182,localhost:2183 #server high availability configuration
  server: 127.0.0.1:18121 #server address (serverHost:serverPort)
  scan: com.ice.test #used to scan leaf nodes, multiple packages are separated by ',' (scan all by default, scanning all will slow down the application startup speed)
  pool: #Thread pool configuration (for concurrent relation nodes)
    parallelism: -1 #default-1,≤0 means the default configuration

Client access (non-Spring)

Add pom dependency

<dependency>
  <groupId>com.waitmoon.ice</groupId>
  <artifactId>ice-core</artifactId>
  <version>1.3.0</version>
</dependency>

High availability additional dependencies

<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-recipes</artifactId>
    <version>5.2.1</version>
</dependency>

Run Client

IceNioClient iceNioClient = new IceNioClient(1, "127.0.0.1:18121", "com.ice.test"); //Incoming app, server address and leaf node scan path
iceNioClient.start(); //Connect to the remote server and initialize the ice configuration
iceNioClient.destroy(); //It is best to clean up after the application is closed~

Development & Configuration

Refer to github ice-test module