There are no two identical leaves in the world.
世界上没有两片完全相同的树叶。
— 莱布尼茨
Leaf 最早期需求是各个业务线的订单ID生成需求。有的业务直接通过DB自增的方式生成ID，有的业务通过redis缓存来生成ID，也有的业务直接用UUID这种方式来生成ID。以上的方式各自有各自的问题，因此我们决定实现一套分布式ID生成服务来满足需求。具体Leaf 设计文档见： leaf 美团分布式ID生成服务
git clone [email protected]:ci-plugins/Leaf.git
git checkout master
cd leaf
mvn clean install -Dmaven.test.skip=true <dependency>
<artifactId>leaf-boot-starter</artifactId>
<groupId>com.tencent.devops.leaf</groupId>
<version>1.0.2-RELEASE</version>
</dependency>leaf:
segment:
allocStrategyDaoBeanName: jooqIDAllocDaoImpl
enable: true
url: jdbc:mysql://xxxxxx/devops_project?useSSL=false&autoReconnect=true&serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=utf8&allowMultiQueries=true
username: xxx
password: xxx
snowflake:
enable: false
address:
port:
name: dev-leaf//EnableLeafServer 开启leafserver
@SpringBootApplication
@EnableLeafServer
public class LeafdemoApplication {
public static void main(String[] args) {
SpringApplication.run(LeafdemoApplication.class, args);
}
}
//直接使用 spring注入
public class T {
@Autowired
private SegmentService segmentService;
@Autowired
private SnowflakeService snowflakeService;
}https://github.com/ci-plugins/Leaf/blob/master/README.md
我们提供了一个基于spring boot的HTTP服务来获取ID
Leaf 提供两种生成的ID的方式（号段模式和snowflake模式），你可以同时开启两种方式，也可以指定开启某种方式（默认两种方式为关闭状态）。
Leaf Server的配置都在yml中
| 配置项 | 含义 | 默认值 |
|---|---|---|
| leaf.name | leaf 服务名 | |
| leaf.segment.enable | 是否开启号段模式 | false |
| leaf.segment.allocStrategyDaoBeanName | 号段模式dao层实现策略（不配默认使用mybatis） | |
| leaf.segment.url | mysql 库地址 | |
| leaf.segment.username | mysql 用户名 | |
| leaf.segment.password | mysql 密码 | |
| leaf.snowflake.enable | 是否开启snowflake模式 | false |
| leaf.snowflake.zk.address | snowflake模式下的zk地址 | |
| leaf.snowflake.port | snowflake模式下的服务注册端口 |
如果使用号段模式，需要建立DB表，并配置leaf.segment.url, leaf.segment.username, leaf.segment.password; 如果dao层不用mybatis实现,那么用户需要在自已的工程中定义一个继承IDAllocDao接口的dao实现类，并且把leaf.segment.allocStrategyDaoBeanName 该配置的值指定为dao实现类在spring中的bean名称。
如果不想使用该模式配置leaf.segment.enable=false即可。
CREATE DATABASE leaf
CREATE TABLE `T_LEAF_ALLOC` (
`BIZ_TAG` varchar(128) NOT NULL DEFAULT '',
`MAX_ID` bigint(20) NOT NULL DEFAULT '1',
`STEP` int(11) NOT NULL,
`DESCRIPTION` varchar(256) DEFAULT NULL,
`UPDATE_TIME` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`BIZ_TAG`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
insert into T_LEAF_ALLOC(BIZ_TAG, MAX_ID, STEP, DESCRIPTION) values('leaf-segment-test', 1, 2000, 'Test leaf Segment Mode Get Id')在yml中配置leaf.segment.url, leaf.segment.username, leaf.segment.password参数
算法取自twitter开源的snowflake算法。
如果不想使用该模式配置leaf.snowflake.enable=false即可。
在yml中配置leaf.snowflake.zk.address，配置leaf 服务监听的端口leaf.snowflake.port。
git clone [email protected]:ci-plugins/Leaf.git
//按照上面的号段模式在工程里面配置好
cd leaf
mvn clean install -DskipTests
cd leaf-server注意:首先得先配置好数据库表或者zk地址
mvn spring-boot:runsh deploy/run.sh#segment
curl http://localhost:8080/api/segment/get/leaf-segment-test
#snowflake
curl http://localhost:8080/api/snowflake/get/test号段模式：http://localhost:8080/cache
当然，为了追求更高的性能，需要通过RPC Server来部署Leaf 服务，那仅需要引入leaf-core的包，把生成ID的API封装到指定的RPC框架中即可。
注意现在leaf使用snowflake模式的情况下 其获取ip的逻辑直接取首个网卡ip【特别对于会更换ip的服务要注意】避免浪费workId