UUID 生成服务器搭建

1. UUID

   UUID 通用唯一识别ID, 由32位16进制数字组成, 共128 bit, 形式如下。

   xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

   由于可靠的长度+可靠算法，UUID能保持1M/s生成速度使用100亿年，UUID生成规则分为4个版本，很多语言都提供了官方或者半官方库,如golang golang.google.com/uuid PHP uuid/guuid。

然而在实际使用中由于位数过长大部分语言只能使用string来表示uuid,使用过程有很多不便,所以我们经常采用一些顺序ID生成算法来替代uuid，其中twitter开源的snowflake就是其中的被经常使用的算法，算法本身很简单，这里不展开希望了解实现过程的话可以参阅 [github](https://github.com/hanskorg/snowflake-rust/blob/master/src/lib.rs)。

本服务就是SF算法的一个实现，uuid格式为uint64,内网部署接口ns级响应，1s中最多生成1000,000个ID

example
curl https://uuid.icool.io/api

2. 环境准备

   本安装过程以centos为例

    
   # 安装docker
   yum install -y docker docker-compose
   # 启动docker
   service docker start
   # 创建依赖目录
   mkdir -y /data/uuid-server/conf
   mkdir -y /data/uuid-server/sock
   

3. 基于docker + nginx 的环境搭建

   本安装过程假设本地存在nginx,且打算复用本地nginx服务作为uuid-server的服务网关

   1. 配置docker-comose.yml

      version: '3'
      services:
      uuid-server:
          image: hansk887/uuid-server:v0.0.5
          volumes:
          - /data/uuid-server/sock:/tmp/uuid-server
          - /data/uuid-server/conf:/etc/uuid
          environment:
          - SOCK=/tmp/uuid-server/unix.sock
          - ZID=1 # 集群Zone

   2. 配置server-id, 单实例本操作可忽略

          echo 1 > /data/uuid-sever/conf/server-id
      3. 启动服务容器
          ```bash
              docker-compose start
              #运行docker ps 检查服务启动成功
              docker ps
              # 检查unix socket套接字文件生成成功
              ls /data/uuid-server/sock/unix.sock

   3. 配置Nginx SCGI转发

      server {
      listen       80;
      location /uuid {
              include scgi_params;
              scgi_pass unix:/data/uuid-server/sock/unix.sock;
          }
      }

   4. 访问测试
      http://localhost/uuid, 正常结果可参照 https://uuid.icool.io

4. docker 独立运行 的环境搭建

   0. 本服务镜像包涵独立nginx，编排配置如下

      version: '3'
      services:
      uuid-server:
          image: hansk887/uuid-server:v0.0.5
          volumes:
          - sock:/tmp/uuid-server
          - /data/uuid-server/conf:/etc/uuid
          environment:
          - SOCK=/tmp/uuid-server/unix.sock
          - ZID=1
      nginx:
          image: nginx:latest
          ports:
          - "81:80"
          volumes:
          - /data/uuid-server/conf/nginx.d:/etc/nginx/conf.d
          - sock:/tmp/uuid-server 
      volumes:
      sock: {}

   1. 创建配置文件
      +– conf
      | +– nginx.conf
      | +– server-id
      +– docker-compose.yml
      nginx.conf 配置参照如下:

      user  nginx;
      worker_processes  2;
      
      error_log  /var/log/nginx/error.log warn;
      pid        /var/run/nginx.pid;
      
      events {
          worker_connections  4096;
      }
      
      http {
          include       /etc/nginx/mime.types;
          default_type  application/octet-stream;
      
          log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                          '$status $body_bytes_sent "$http_referer" '
                          '"$http_user_agent" "$http_x_forwarded_for"';
      
          access_log  /var/log/nginx/access.log  main;
      
          sendfile        on;
          #tcp_nopush     on;
      
          keepalive_timeout  65;
      
          #gzip  on;
      
          server {
              listen       80;
              location /uuid {
                      include scgi_params;
                      scgi_pass unix:/data/uuid-server/sock/unix.sock;
                  }
          }
      }

   2. 启动服务容器

   docker-compose start
   #运行docker ps 检查服务启动成功
   docker ps
   # 检查unix socket套接字文件生成成功
   ls /data/uuid-server/sock/unix.sock