一、项目简介
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/