一、项目简介
17年初就接触了zheng这个项目,感觉挺牛的,看他的架构图就知道了
现在都已经18年了,时间好快,特此记录下zheng的环境搭建,虽然,先看下码云上zheng的简介吧:https://gitee.com/shuzheng/zheng。
zheng是基于Spring+SpringMVC+Mybatis分布式敏捷开发系统架构,提供整套公共微服务服务模块:集中权限管理(单点登录)、内容管理、支付中心、用户管理(支持第三方登录)、微信平台、存储系统、配置中心、日志分析、任务和通知等,支持服务治理、监控和追踪,努力为中小型企业打造全方位J2EE企业级开发解决方案。
二、导入项目
导入项目的方式有两种,一种是通过git,一种是直接下载源码然后导入到IDEA中,我这里以下载源码来演示,下载之后的源码如下:
有如下一些模块:
zheng-common--公共配置、MybatisGenerator扩展插件、通用BaseService、工具类等
zheng-admin--通用后台管理系统,zheng项目所有后台系统都是使用该模块界面作为前端展示。
zheng-ui--各个子系统前台thymeleaf模板,前端资源模块,使用nginx代理,实现动静分离。
zheng-upms--基于RBAC授权和基于用户授权的细粒度权限控制通用平台,并提供单点登录、会话管理和日志管理。
zheng-cms--内容管理系统
zheng-oss--文件存储系统
zheng-ucenter--通用用户管理系统, 实现最常用的用户注册、登录、资料管理、个人中心、第三方登录等基本需求,支持扩展二次开发。
zheng-wechat-mp--微信公众号管理平台,除实现官网后台自动回复、菜单管理、素材管理、用户管理、消息群发等基础功能外,还有二维码推广、营销活动、微网站、会员卡、优惠券等。
zheng-wechat-app--微信小程序后台
zheng-pay--一站式支付解决方案,统一下单接口,支持支付宝、微信、网银等多种支付方式。不涉及业务的纯粹的支付平台。
zheng-api--服务网关,对外暴露统一规范的接口和包装响应结果,包括各个子系统的交互接口、对外开放接口、开发加密接口、接口文档等服务,可在该模块支持验签、鉴权、路由、限流、监控、容错、日志等功能。
然后打开IDEA---->File---->New---->Module from Existing Sources导入一个存在的Module
然后点击Finsh.导入成功之后,如下:
找到每个项目的跟pom.xml更新下依赖:
然后下载zheng-common中的依赖
三、环境搭建
要想成功运行项目,必须要安装一下一些工具:
1、JDK
2、Mysql
3、maven
4、Redis
5、Zookeeper
6、ActiveMQ
7、Nginx
4、Redis安装
至于JDK,Mysql,maven,的安装太简单了,这里就不演示了,Redis安装如下,去github下载最新的安装包:https://github.com/MSOpenTech/redis/releases
下载Redis-x64-3.2.100-windows.msi安装过程比较简单,一路next就可以了。然后还得安装Redis可视化工具Redis Desktop Manager下载地址如下:https://redisdesktop.com/download
选择最新的版本进行下载、下载之后,然后进行安装
安装之后,打开软件
这里要登录密码,由于我装的是安装版,以下是设置密码,在CMD下:
- config get requirepass //获取当前密码
- config set requirepass "root"//设置当前密码,服务重新启动后又会置为默认,即无密码;不建议此种方式
5、Zookeeper安装
首先去官网下载:http://www.apache.org/dyn/closer.cgi/zookeeper/
选择3.5.2版本。
6、ActiveMQ
官网下载地址为:http://activemq.apache.org/download-archives.html 选择最新版本进行下载
这里选择5.9.0版本进行下载。
7、Nginx
官网下载地址为:http://nginx.org/
四、运行项目
A.后台启动顺序:
(一)、初始化数据库
下面就是启动项目了,在启动项目前还得准备下,首先新建zheng数据库
导入project-datamodel文件夹下的zheng.sql
工具使用的是navicat for premium
导入成功之后,有如下表
(二)、数据库连接配置工作
修改各模块下profiles的数据库连接等配置信息
有如下一些module下有这些配置文件
像如下这种密码使用了AES加密,使用com.zheng.common.util.AESUtil工具类修改这些值
在zheng-upms中有个generator.properties
AESUtil使用如下,替换其中的root为数据库密码,然后运行就会有以下信息输出:
比如我这里redis和mysql都是root,所有我把密码修改成如下的密码:
(三)、修改本地Host
进入到"C:\Windows\System32\drivers\etc"目录下:
- 127.0.0.1 ui.zhangshuzheng.cn
- 127.0.0.1 upms.zhangshuzheng.cn
- 127.0.0.1 cms.zhangshuzheng.cn
- 127.0.0.1 pay.zhangshuzheng.cn
- 127.0.0.1 ucenter.zhangshuzheng.cn
- 127.0.0.1 wechat.zhangshuzheng.cn
- 127.0.0.1 api.zhangshuzheng.cn
- 127.0.0.1 oss.zhangshuzheng.cn
- 127.0.0.1 config.zhangshuzheng.cn
- 127.0.0.1 zkserver
- 127.0.0.1 rdserver
- 127.0.0.1 dbserver
- 127.0.0.1 mqserver
(四)、启动并运行相关程序工作
我把有关的工具都解压到该目录下了:
1.启动Zookeeper
进入到zookeeper的bin目录,双击zkServer.cmd启动服务。
启动成功之后,输入信息如下:
2、启动ActiveMQ:
1)进入MQ的bin目录D:\zheng_start\apache-activemq-5.9.0-bin\apache-activemq-5.9.0\bin\win64,双击activemq.bat
启动成功之后
2)在浏览器中输入http://localhost:8161/admin/输入默认的admin admin
3)出现这样的界面则MQ安装成功。
3、启动Nginx
在zheng/project-tools/nginx下提供了ngxin的一些配置
将这两个文件复制到nginx/conf下
修改其中的项目路径:
或者可以直接修改nginx.conf为如下内容:
- #user nobody;
- worker_processes 1;
- #error_log logs/error.log;
- #error_log logs/error.log notice;
- #error_log logs/error.log info;
- #pid logs/nginx.pid;
- events {
- worker_connections 1024;
- }
- http {
- include 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 logs/access.log main;
- sendfile on;
- #tcp_nopush on;
- #keepalive_timeout 0;
- keepalive_timeout 65;
- #gzip on;
- server {
- #监听的端口号,配置这里访问的时候浏览器里可以访问http://localhost:1000/zheng-cms-web/测试是否能看到页面内容(没有直接访问http://localhost:1000,因为这个路径zheng-ui下没有index.html之类的文件,会出现访问错误提示,不好作为判定是否nginx启动配置成功的标志)
- listen 1000;
- server_name localhost;
- #charset koi8-r;
- #access_log logs/host.access.log main;
- location / {
- #root后面内容需要修改为本机的zheng-ui项目的绝对路径位置
- root F:/GitHub/zheng/zheng-ui/;
- index index.html index.htm;
- add_header Access-Control-Allow-Origin *;
- }
- #error_page 404 /404.html;
- # redirect server error pages to the static page /50x.html
- #
- error_page 500 502 503 504 /50x.html;
- location = /50x.html {
- root html;
- }
- # proxy the PHP scripts to Apache listening on 127.0.0.1:80
- #
- #location ~ \.php$ {
- # proxy_pass http://127.0.0.1;
- #}
- # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
- #
- #location ~ \.php$ {
- # root html;
- # fastcgi_pass 127.0.0.1:9000;
- # fastcgi_index index.php;
- # fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;
- # include fastcgi_params;
- #}
- # deny access to .htaccess files, if Apache's document root
- # concurs with nginx's one
- #
- #location ~ /\.ht {
- # deny all;
- #}
- }
- # another virtual host using mix of IP-, name-, and port-based configuration
- #
- #server {
- # listen 8000;
- # listen somename:8080;
- # server_name somename alias another.alias;
- # location / {
- # root html;
- # index index.html index.htm;
- # }
- #}
- # HTTPS server
- #
- #server {
- # listen 443 ssl;
- # server_name localhost;
- # ssl_certificate cert.pem;
- # ssl_certificate_key cert.key;
- # ssl_session_cache shared:SSL:1m;
- # ssl_session_timeout 5m;
- # ssl_ciphers HIGH:!aNULL:!MD5;
- # ssl_prefer_server_ciphers on;
- # location / {
- # root html;
- # index index.html index.htm;
- # }
- #}
- }
然后在CMD下执行nginx.exe
或者可以在该目录下新建一个nginx.bat文件内容如下:
- @echo off
- rem zheng-tools
- rem author: shuzheng http://www.zhangshuzheng.cn
- rem GitHub: https://github.com/shuzheng
- rem OsChina: http://git.oschina.net/shuzheng/zheng
- echo ==================begin========================
- cls
- SET NGINX_PATH=D:
- SET NGINX_DIR=D:\自己的nginx安装路径\nginx-1.11.4\
- color 0a
- TITLE zheng-tools Power By shuzheng (http://www.zhangshuzheng.cn)
- CLS
- ECHO.
- ECHO. ********************************************************************
- ECHO. * *
- ECHO. * *
- ECHO. * zheng-tools Power By shuzheng (http://www.zhangshuzheng.cn) *
- ECHO. * *
- ECHO. * *
- ECHO. ********************************************************************
- ECHO.
- :MENU
- ECHO.---------------------------- nginx 进程列表 --------------------------------
- tasklist|findstr /i "nginx.exe"
- if ERRORLEVEL 1 (echo nginx未启动) else (echo nginx已启动)
- ECHO.----------------------------------------------------------------------------
- ECHO.
- ECHO. [1] 启动Nginx
- ECHO. [2] 关闭Nginx
- ECHO. [3] 重启Nginx
- ECHO. [4] 退 出
- ECHO.
- ECHO.请输入选择项目的序号:
- set /p ID=
- IF "%id%"=="1" GOTO start
- IF "%id%"=="2" GOTO stop
- IF "%id%"=="3" GOTO restart
- IF "%id%"=="4" EXIT
- PAUSE
- :start
- call :startNginx
- ECHO.============================================================================
- ECHO.
- ECHO.
- GOTO MENU
- :stop
- call :shutdownNginx
- ECHO.============================================================================
- ECHO.
- ECHO.
- GOTO MENU
- :restart
- call :shutdownNginx
- call :startNginx
- ECHO.============================================================================
- ECHO.
- ECHO.
- GOTO MENU
- :shutdownNginx
- ECHO.
- ECHO.关闭Nginx......
- taskkill /F /IM nginx.exe > nul
- ECHO.OK,关闭所有nginx 进程
- goto :eof
- :startNginx
- ECHO.
- ECHO.启动Nginx......
- IF NOT EXIST "%NGINX_DIR%nginx.exe" ECHO "%NGINX_DIR%nginx.exe"不存在
- %NGINX_PATH%
- cd "%NGINX_DIR%"
- IF EXIST "%NGINX_DIR%nginx.exe" (
- echo "start '' nginx.exe"
- start "" nginx.exe
- )
- ECHO.OK
- goto :eof
运行效果如下:
4、启动Tomcat
在tomcat中部署dubbo应用。这里用的是2.5.4,可从这下载:http://download.csdn.net/download/u011781521/10197867 下载之后解压,删除Tomcat目录下的ROOT目录,然后复制dubbo中的ROOT到该目录下:
然后修改下tomcat的默认端口以防止和下面的jetty冲突,最后在D:\zheng_start\apache-tomcat-8.0.45\bin目录下执行startup.bat启动tomcat,成功之后输出如下:
访问tomcat的dubbo后台: localhost:8089 用户名与密码都是root
5、启动Service
首先启动 zheng-upms-rpc-service(直接运行src目录下的ZhengUpmsRpcServiceApplication#main方法启动)
启动成功之后如下:
6、启动Web服务
打开Maven视图
debug运行jetty。然后按需启动对应子系统xxx的zheng-xxx-rpc-service(main方法) => zheng-xxx-webapp(jetty)
然后在dubbo管控台上就会有一些服务已经注册了
7、访问页面
然后访问 http://upms.zhangshuzheng.cn:1111/,子系统菜单已经配置到zheng-upms权限中,不用直接访问子系统,默认帐号密码:admin/123456
B、zheng-cms启动
zheng-cms-admin:启动ActiveMQ-启动 => 启动zheng-rpc-service => 启动zheng-cms-admin
zheng-cms-web:启动nginx代理zheng-ui静态资源,然后访问: http://upms.zhangshuzheng.cn:1111
切换到CMS系统
此时访问CMS首页: http://cms.zhangshuzheng.cn:2224/