开源项目学习之(一)------zheng环境搭建

一、项目简介

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/