deployment

部署

duic 部署仅依赖于 mongodb，不依赖其它任何中间件即可支持分布式集群部署，同时 duic 采用 spring-boot + spring-webflux 开发，内置使用 netty 作为 HTTP Server，所以 duic 的部署非常的简单。

前提

• java >= 1.8

• mongodb >= 2.6

Tip	考虑到实际应用中我们一般都使用 linux 作为服务器，该文档目前只针对 linux 系统部署。

启动配置

启动配置文件默认采用 yaml 格式，你可以根据自己的喜好使用其它配置 spring-boot 支持的文件格式。

配置文件路径

1. 当前目录的 /config 子目录

2. 当前目录

3. CLASSPATH /config 包目录

4. CLASSPATH 根目录

该列表按优先顺序排列（在列表中较高的位置定义的属性会覆盖在较低位置定义的属性）。

application.yaml

duic:
  mongodb:
    url: mongodb://127.0.0.1:27017/duic
  root-email: kevinz@weghst.com
  root-password: 123456
  jwt:
    secret: U2FsdGVkX1/jO0KlWumac4yDM8rOgWPkaV0KrSHDynWOP6n8FMJB9uSc8EW/qM+VagrMBAXGpyw=
    expires-in: 7200
  app:
    watch:
      updated:
        fixed-delay: 5000
      deleted:
        fixed-delay: 600000

一般在部署时只需要将 spring.data.mongodb.uri 配置参数修改为指定的 mongodb 连接地址，即可正常启动 duic。

参数详细解释

• duic 应用程序基础配置

  • mongodb.url mongodb 数据库连接 uri

  • root-email ROOT 用户邮箱，如果用户不存在则会直接创建他

  • root-password ROOT 用户密码，初始创建时默认设置的密码

  • jwt 配置管理控制台登录安全信息，JWT 使用 HmacSHA256 算法生成

    • secret JWT 签名字符串

    • expires-in JWT 过期时间（单位：秒）

  • app.watch.updated.fixed-delay 监控数据库配置更新时间间隔周期默认为 5 秒扫描一次数据库，将更新的配置加载至内存中（单位：毫秒）

  • app.watch.deleted.fixed-delay 监控数据库配置删除时间音阶周期默认为 10 分钟挚友一次数据库，将删除的配置从内存中移除释放内存（单位：毫秒）

Tip	更详细的解释请参考 spring-boot 官方文档 Application Property Files

传统 java 方式部署

1. 确认 java 环境至少是 1.8 或以上的版本

   $ java -version
   
   java version "1.8.0_151"
   Java(TM) SE Runtime Environment (build 1.8.0_151-b12)
   Java HotSpot(TM) 64-Bit Server VM (build 25.151-b12, mixed mode)

2. 确认 mongo 环境至少是 2.6 或以上的版本并且服务已经启动

   $ mongo -version
   
   MongoDB shell version: 2.6.3

3. 创建 duic 目录

   $ mkdir /opt/duic

4. 进入 duic 目录

   $ cd /opt/duic

5. 在 GitHub Releases 页面获取 duic-[version].jar 并放置在 /opt/duic 目录中

   $ wget https://github.com/zhudyos/duic/releases/download/1.4.1/duic-1.4.1.jar -O duic.jar

   Tip	在部署时需要将 url 中的版本替换为你需要的版本号，最好从 GitHub Releases 找到合适的版本后复制下载地址

6. 创建配置文件目录

   $ mkdir config

   Tip	确保当前目录是在 /opt/duic 目录中

7. 进入配置文件目录

   $ cd config

8. 创建启动配置文件

   $ touch application.yml

9. 将 duic.mongodb.url 写入 config/application.yml 配置文件

   duic:
     mongodb:
       url: mongodb://127.0.0.1:27017/duic

   Tip	确保 duic.mongodb.url 正确可连接至数据库

10. 启动 duic

    $ java -Dspring.profiles.active=mongodb -jar duic.jar

    Tip

    在控制台看见如下日志输出即启动成功 ______ _ ______ |_ _ `. (_) .' ___ | | | `. \ __ _ __ / .' \_| | | | |[ | | | [ || | _| |_.' / | \_/ |, | |\ `.___.'\ |______.' '.__.'_/[___]`.____ .' :: duic :: (v1.5.0-beta) 2018-04-17 13:33:34,495 INFO i.z.d.server.Application$Companion - Starting Application.Companion v1.5.0-beta on bd29aece4869 with PID 5 (/app/duic.jar started by root in /app) 2018-04-17 13:33:34,516 INFO i.z.d.server.Application$Companion - The following profiles are active: prod 2018-04-17 13:33:42,835 INFO r.i.netty.tcp.BlockingNettyContext - Started HttpServer on /0.0.0.0:7777 2018-04-17 13:33:42,839 INFO o.s.b.w.e.netty.NettyWebServer - Netty started on port(s): 7777 2018-04-17 13:33:42,845 INFO i.z.d.server.Application$Companion - Started Application.Companion in 10.39 seconds (JVM running for 13.063)

11. 测试

    $ curl http://localhost:7777/index.html

docker 部署

镜像已经同步至 docker 官方镜像仓库 https://hub.docker.com/r/zhudyos/duic。

1. 拉取镜像

   $ docker pull zhudyos/duic

2. 确认 mongo 环境至少是 2.6 或以上的版本并且服务已经启动

   $ mongo -version
   
   MongoDB shell version: 2.6.3

3. 创建配置文件目录

   $ mkdir config

4. 进入配置文件目录

   $ cd config

5. 创建启动配置文件

   $ touch application.yml

6. 将 duic.mongodb.url 写入 config/application.yml 配置文件

   duic:
     mongodb:
       url: mongodb://127.0.0.1:27017/duic

   Tip	确保 duic.mongodb.url 正确可连接至数据库

7. 启动镜像

   $ docker run -d -p 7777:7777 -v $(pwd)/config:/app/config zhudyos/duic

   Tip	将 application.yml 配置文件所在目录挂载到容器的 /app/config 目录中

8. 测试

   $ curl http://localhost:7777/index.html

docker-compose 部署

https://github.com/zhudyos/duic-docker-compose