diff --git a/document/reference/deploy-windows.md b/document/reference/deploy-windows.md deleted file mode 100644 index e8100fb..0000000 --- a/document/reference/deploy-windows.md +++ /dev/null @@ -1,105 +0,0 @@ -# windows下环境搭建 - -## IDEA - -- 关于IDEA的安装与使用具体参考[https://github.com/judasn/IntelliJ-IDEA-Tutorial](https://github.com/judasn/IntelliJ-IDEA-Tutorial) -- 搜索插件仓库,安装插件lombok - -## Eclipse - -- 导入项目,以maven项目形式导入 - ![eclipse_import_1.png](https://github.com/macrozheng/mall/blob/master/document/resource/eclipse_import_1.png) - ![eclipse_import_2.png](https://github.com/macrozheng/mall/blob/master/document/resource/eclipse_import_2.png) -- 安装lombok插件,下载地址:https://projectlombok.org/downloads/lombok.jar -- 下载完后双击,使用java程序打开 -- 按照提示选择eclipse.exe的安装路径安装插件,完成后重启Eclipse -- 启动项目:右击com.macro.mall.MallAdminApplication的main方法,选择run as Java Application - -## mysql - -- 下载地址:https://dev.mysql.com/downloads/mysql/5.7.html#downloads -- 下载后按提示进行安装 -- 导入document/sql下的mall.sql文件 - -## redis - -- 下载地址:https://github.com/MicrosoftArchive/redis/releases -- 下载后按提示进行安装 -- 启动redis:redis-server.exe redis.windows.conf - -## elasticsearch - -- 下载地址:https://www.elastic.co/downloads/past-releases/elasticsearch-6-2-2 -- 下载.zip文件,解压到指定目录 -- 安装kibana,用于在浏览器中访问es,请下载6.2.2版本,具体参考:https://www.elastic.co/downloads/kibana -- 下载.zip包后解压即可,运行bin\kibana.bat,访问http://localhost:5601 查看是否安装成功 -- 中文分词插件地址:https://github.com/medcl/elasticsearch-analysis-ik -- 安装中文分词插件,在elasticsearch-6.2.2\bin目录下执行以下命令: -elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v6.2.2/elasticsearch-analysis-ik-6.2.2.zip -- 启动elasticsearch:运行elasticsearch-6.2.2\bin\elasticsearch.bat -- 不使用kibana的可以安装head插件,具体参考:https://github.com/mobz/elasticsearch-head -- 注意:如果你修改了mall-search中的es的cluster-name: mall-es,你需要在elasticsearch-6.2.2\config\elasticsearch.yml文件中修改cluster.name: mall-es - -## mongodb - -- 下载地址:https://fastdl.mongodb.org/win32/mongodb-win32-x86_64-2008plus-ssl-3.2.21-signed.msi -- 选择路径(c:\mongodb\)进行安装,在安装路径下创建data\db和data\log两个文件夹 -- 服务端运行程序:mongodb\bin\mongod.exe -- 客户端运行程序:mongodb\bin\mongo.exe -- 创建配置文件:mongodb\mongod.cfg - ``` lua - systemLog: - destination: file - path: c:\mongodb\data\log\mongod.log - storage: - dbPath: c:\mongodb\data\db - ``` -- 安装为服务(运行命令需要用管理员权限):C:\mongodb\bin\mongod.exe --config "C:\mongodb\mongod.cfg" --install -- 启动服务:net start MongoDB -- 关闭服务:net stop MongoDB -- 移除服务:C:\mongodb\bin\mongod.exe --remove -- 下载客户端程序:https://download.robomongo.org/1.2.1/windows/robo3t-1.2.1-windows-x86_64-3e50a65.zip -- 解压到指定目录,打开robo3t.exe并连接到localhost:27017 - -## rabbitmq - -- 安装Erlang:http://erlang.org/download/otp_win64_21.3.exe -- 下载rabbitmq:https://dl.bintray.com/rabbitmq/all/rabbitmq-server/3.7.14/rabbitmq-server-3.7.14.exe -- 按照提示进行安装,安装完成后进入rabbitmq的安装目录:D:\RabbitMQ Server\rabbitmq_server-3.7.14\sbin -- 在地址栏输入cmd并回车启动命令行输入以下命令:rabbitmq-plugins enable rabbitmq_management -- 访问地址查看是否安装成功:http://127.0.0.1:15672/ -- 输入账号密码登录:guest guest -- 创建用户并设置其角色为管理员:mall mall - ![rabbitmq_install_2.png](https://github.com/macrozheng/mall/blob/master/document/resource/rabbitmq_install_2.png) -- 创建virtual host:/mall - ![rabbitmq_install_3.png](https://github.com/macrozheng/mall/blob/master/document/resource/rabbitmq_install_3.png) -- 给mall用户配置范围该virtual host的权限 - ![rabbitmq_install_4.png](https://github.com/macrozheng/mall/blob/master/document/resource/rabbitmq_install_4.png) -- rabbitmq安装延迟消息插件(可不装): - - 下载延迟消息插件(rabbitmq_delayed_message_exchange):https://www.rabbitmq.com/community-plugins.html - - 复制插件到插件目录:D:\RabbitMQ Server\rabbitmq_server-3.7.14\plugins - - 在sbin目录下运行如下命令启用插件:rabbitmq-plugins enable rabbitmq_delayed_message_exchange - -## OSS - -- 该项目文件上传采用OSS,需要自行注册OSS账号并配置 -- 首先将mall-admin\src\main\resources\application.properties文件中以aliyun.oss.开头的配置改为你自己的配置 -- OSS上传文件需要配置跨域资源共享(CORS)规则,参考文档:https://help.aliyun.com/document_detail/31928.html -- 上传方式采用服务端签名后直传的形式,参考文档:https://help.aliyun.com/document_detail/31926.html - -## mall-admin - -- 启动项目:直接运行com.macro.mall.MallAdminApplication的main方法即可 -- 接口文档地址:http://localhost:8080/swagger-ui.html - -## mall-search - -- 启动项目:直接运行com.macro.mall.search.MallSearchApplication的main方法即可 -- 接口文档地址:http://localhost:8081/swagger-ui.html -- 使用前需要先调用接口导入数据;http://localhost:8081/esProduct/importAll -- 如出现无法启动的问题,可以先删除elasticsearch里面的数据再启动 - -## mall-portal - -- 启动mall-portal项目:直接运行com.macro.mall.portal.MallPortalApplication的main方法即可 -- 接口文档地址:http://localhost:8085/swagger-ui.html diff --git a/document/reference/deploy_windows.md b/document/reference/deploy_windows.md new file mode 100644 index 0000000..52f37d9 --- /dev/null +++ b/document/reference/deploy_windows.md @@ -0,0 +1,94 @@ +# mall-swarm 在windows环境下的部署 + +## 开发环境搭建 + +> `mall-swarm`中使用到的环境和`mall`项目中大致相同,具体可以查看[mall在Windows环境下的部署](https://github.com/macrozheng/mall-learning/blob/master/docs/deploy/mall_deploy_windows.md)。 + +简易环境搭建流程: + +- 安装IDEA并导入项目源码; +- 安装MySql,创建一个`mall`数据库,并导入`/document/sql/mall.sql`文件; +- 安装Redis、Elasticsearch、MongoDB、RabbitMQ等环境。 + +## 项目部署 + +> `mall-swarm`项目启动有先后顺序,大家要按照以下顺序启动。 + +### 启动注册中心`mall-registory` + +- 直接运行com.macro.mall.MallRegistryApplication的main函数即可; +- 运行完成后可以通过注册中心控制台查看:http://localhost:8001 + +### 启动配置中心`mall-config` + +- 直接运行com.macro.mall.MallConfigApplication的main函数即可; +- 访问以下接口获取mall-admin在dev环境下的配置信息:http://localhost:8301/master/admin-dev.yml + +### 启动监控中心`mall-monitor` + +- 直接运行com.macro.mall.MallMonitorApplication的main函数即可; +- 运行完成后可以通过监控中心控制台查看:http://localhost:8101 +- 输入账号密码`macro:123456`可以登录查看。 + +### 启动网关服务`mall-gateway` + +- 直接运行com.macro.mall.MallGatewayApplication的main函数即可; +- 访问以下接口获取动态路由规则:http://localhost:8201/actuator/gateway/routes + +### 启动后台管理服务`mall-admin` + +- 直接运行com.macro.mall.MallAdminApplication的main函数即可; +- 通过`mall-gateway`网关服务访问接口文档:http://localhost:8201/mall-admin/swagger-ui.html + +![](../resource/mall_swarm_windows_06.png) + +- 登录接口地址:http://localhost:8201/mall-admin/admin/login +- 访问登录接口获取到token后放入认证的头信息即可正常访问其他需要登录的接口: + +![](../resource/mall_swarm_windows_09.png) + +### 启动前台服务`mall-portal` + +- 直接运行com.macro.mall.portal.MallPortalApplication的main函数即可; +- 通过`mall-gateway`网关服务访问接口文档:http://localhost:8201/mall-portal/swagger-ui.html + +![](../resource/mall_swarm_windows_07.png) + +- 登录接口地址:http://localhost:8201/mall-portal/sso/login +- 调用需要登录的接口方式同`mall-admin`。 + +### 启动搜索服务`mall-search` + +- 直接运行com.macro.mall.search.MallSearchApplication的main函数即可; +- 通过`mall-gateway`网关服务访问接口文档:http://localhost:8201/mall-search/swagger-ui.html + +![](../resource/mall_swarm_windows_10.png) + +### 启动测试服务`mall-demo` + +- 直接运行com.macro.mall.MallAdminApplication的main函数即可; +- 通过`mall-gateway`网关服务访问接口文档:http://localhost:8201/mall-demo/swagger-ui.html + +![](../resource/mall_swarm_windows_08.png) + +- 可以通过调用FeignAdminController、FeignPortalController、FeignSearchController来测试使用Feign的远程调用功能。 + +## 效果展示 + +- 注册中心服务信息: + +![](../resource/mall_swarm_windows_01.png) + +- 监控中心服务概览信息: + +![](../resource/mall_swarm_windows_02.png) + +![](../resource/mall_swarm_windows_03.png) + +- 监控中心单应用详情信息: + +![](../resource/mall_swarm_windows_04.png) + +![](../resource/mall_swarm_windows_05.png) + + diff --git a/document/resource/mall_micro_service_arch.jpg b/document/resource/mall_micro_service_arch.jpg index 403dac0..678e3d4 100644 Binary files a/document/resource/mall_micro_service_arch.jpg and b/document/resource/mall_micro_service_arch.jpg differ diff --git a/document/resource/mall_swarm_windows_01.png b/document/resource/mall_swarm_windows_01.png new file mode 100644 index 0000000..ffe7329 Binary files /dev/null and b/document/resource/mall_swarm_windows_01.png differ diff --git a/document/resource/mall_swarm_windows_02.png b/document/resource/mall_swarm_windows_02.png new file mode 100644 index 0000000..34d55b9 Binary files /dev/null and b/document/resource/mall_swarm_windows_02.png differ diff --git a/document/resource/mall_swarm_windows_03.png b/document/resource/mall_swarm_windows_03.png new file mode 100644 index 0000000..f49cc2d Binary files /dev/null and b/document/resource/mall_swarm_windows_03.png differ diff --git a/document/resource/mall_swarm_windows_04.png b/document/resource/mall_swarm_windows_04.png new file mode 100644 index 0000000..f148830 Binary files /dev/null and b/document/resource/mall_swarm_windows_04.png differ diff --git a/document/resource/mall_swarm_windows_05.png b/document/resource/mall_swarm_windows_05.png new file mode 100644 index 0000000..8ec09fd Binary files /dev/null and b/document/resource/mall_swarm_windows_05.png differ diff --git a/document/resource/mall_swarm_windows_06.png b/document/resource/mall_swarm_windows_06.png new file mode 100644 index 0000000..eaccc7c Binary files /dev/null and b/document/resource/mall_swarm_windows_06.png differ diff --git a/document/resource/mall_swarm_windows_07.png b/document/resource/mall_swarm_windows_07.png new file mode 100644 index 0000000..f4576ad Binary files /dev/null and b/document/resource/mall_swarm_windows_07.png differ diff --git a/document/resource/mall_swarm_windows_08.png b/document/resource/mall_swarm_windows_08.png new file mode 100644 index 0000000..dc80615 Binary files /dev/null and b/document/resource/mall_swarm_windows_08.png differ diff --git a/document/resource/mall_swarm_windows_09.png b/document/resource/mall_swarm_windows_09.png new file mode 100644 index 0000000..8793b96 Binary files /dev/null and b/document/resource/mall_swarm_windows_09.png differ diff --git a/document/resource/mall_swarm_windows_10.png b/document/resource/mall_swarm_windows_10.png new file mode 100644 index 0000000..042f70a Binary files /dev/null and b/document/resource/mall_swarm_windows_10.png differ diff --git a/mall-admin/pom.xml b/mall-admin/pom.xml index 153fa81..1d8822d 100644 --- a/mall-admin/pom.xml +++ b/mall-admin/pom.xml @@ -19,7 +19,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-common/pom.xml b/mall-common/pom.xml index 44f202e..a781351 100644 --- a/mall-common/pom.xml +++ b/mall-common/pom.xml @@ -13,7 +13,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-config/pom.xml b/mall-config/pom.xml index 3cc12a9..d263918 100644 --- a/mall-config/pom.xml +++ b/mall-config/pom.xml @@ -11,7 +11,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-demo/pom.xml b/mall-demo/pom.xml index e2e4353..54e1387 100644 --- a/mall-demo/pom.xml +++ b/mall-demo/pom.xml @@ -18,7 +18,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-gateway/pom.xml b/mall-gateway/pom.xml index 879f34d..1084506 100644 --- a/mall-gateway/pom.xml +++ b/mall-gateway/pom.xml @@ -10,7 +10,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-mbg/pom.xml b/mall-mbg/pom.xml index caac930..ac12150 100644 --- a/mall-mbg/pom.xml +++ b/mall-mbg/pom.xml @@ -14,7 +14,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-monitor/pom.xml b/mall-monitor/pom.xml index 2a76fe9..580cab0 100644 --- a/mall-monitor/pom.xml +++ b/mall-monitor/pom.xml @@ -10,7 +10,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-portal/pom.xml b/mall-portal/pom.xml index 084b6ec..bbd7ee5 100644 --- a/mall-portal/pom.xml +++ b/mall-portal/pom.xml @@ -20,7 +20,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-registry/pom.xml b/mall-registry/pom.xml index 9161ec2..dc783ce 100644 --- a/mall-registry/pom.xml +++ b/mall-registry/pom.xml @@ -10,7 +10,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-search/pom.xml b/mall-search/pom.xml index 6dce0c7..496c773 100644 --- a/mall-search/pom.xml +++ b/mall-search/pom.xml @@ -13,7 +13,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/mall-security/pom.xml b/mall-security/pom.xml index 1ed891e..c74d8b7 100644 --- a/mall-security/pom.xml +++ b/mall-security/pom.xml @@ -12,7 +12,7 @@ com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT diff --git a/pom.xml b/pom.xml index 1bf3c84..a83cf90 100644 --- a/pom.xml +++ b/pom.xml @@ -5,7 +5,7 @@ 4.0.0 com.macro.mall - mall + mall-swarm 1.0-SNAPSHOT pom