Преглед изворни кода

文档重新整理加入 开发环境搭建和生产环境搭建步骤

wuxw пре 6 година
родитељ
комит
ad4aa3dea3

+ 4 - 1
docs/_sidebar.md

@@ -2,10 +2,13 @@
 * 入门
 
   * [快速开始](README.md)
-  * [安装部署](start/install.md)
   * [编码规范](start/CodeStandards.md)
   * [视频](start/vedio.md)
 
+* 环境搭建
+
+  * [开发环境部署](start/dev_install.md)
+  * [生产环境部署](start/prod_install.md)
 
 * api接口
 

+ 115 - 0
docs/start/dev_install.md

@@ -0,0 +1,115 @@
+### 变更历史
+版本|变更内容|变更时间|变更人员
+:-: | :-: | :-: | :-:
+v0.01|初稿|2019-06-17|wuxw
+
+### 本页内容
+
+说明如何搭建HC小区管理系统开发环境。
+
+
+### IDEA开发工具搭建HC小区管理系统
+
+#### 安装maven
+
+    这里略过,请自行百度,maven的settings.xml 中的中央仓库地址建议修改为国内仓库地址,如阿里云的,这样有利于项目编译和打包速度
+
+    ```
+    <mirrors>
+            <mirror>
+                  <id>alimaven</id>
+                  <name>aliyun maven</name>
+                  <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
+                  <mirrorOf>central</mirrorOf>
+            </mirror>
+
+    </mirrors>
+    ```
+
+#### 安装git
+
+    这里略过,请自行百度
+
+#### 安装 idea 开发工具
+
+    社区版和收费版都可以, 百度自行下载安装
+
+#### 下载代码
+
+    选择项目保存文件夹如 C:\Users\Administrator\Documents\project\hc 目录下,执行
+
+    ```
+       git clone https://github.com/java110/MicroCommunity.git
+
+    ```
+
+    或者 备份版本代码,主要是下载速度比较快
+
+     ```
+       git clone https://gitee.com/wuxw7/MicroCommunity.git
+
+     ```
+
+#### 编译代码
+
+    进入MicroCommunity目录下执行命令
+
+    ```
+        mvn clean install
+
+    ```
+    和
+    ```
+        mvn clean package
+
+    ```
+
+#### idea 打开代码
+
+    用maven的方式打开项目,在idea的设置中修改第一步安装的maven地址和settings.xml地址,点击OK,然后在idea的右上侧点击Maven选项,点击Reimport All Maven Projects,重新导入maven依赖jar包
+
+#### 安装mysql
+
+    推荐安装 5.6 版本mysql ,安装过程请自行百度,将 MicroCommunity文件下的 MicroCommunity.sql 文件导入到mysql中,有可能这个sql不是最新的,你也可以加入群827669685,获取最新的sql文件
+
+#### 安装kafka
+
+    请自行百度安装
+
+#### 安装 zookeeper
+
+    请自行百度安装
+
+#### 安装Redis
+
+    请自行百度安装
+
+#### 修改hosts
+
+    如果本地没有安装kafka zookeeper Redis mysql 等开源中间件,也可以用演示环境的 kafka zookeeper mysql 和Redis,这样只需要在hosts 中加入
+
+    ```
+    api.java110.com 127.0.0.1
+    dev.java110.com 127.0.0.1
+
+    ```
+
+    如果你本地安装了 kafka zookeeper Redis mysql 开源中间件 则将对应域名改为对应IP
+
+    ```
+    dev.db.java110.com 这里写mysql的IP
+    dev.zk.java110.com 这里写zookeeper的IP
+    dev.kafka.java110.com 这里写kafka的IP
+    api.java110.com 127.0.0.1
+    dev.java110.com 127.0.0.1
+
+    ```
+
+#### 启动相应服务
+
+    需要启动的服务有 eureka、 Api、OrderService、CommunityService、StoreService、UserService、WebService、FeeService
+
+    找到服务下 src目录下 main/java/com/java110/您的服务名/XXApplicationStart.java 类打开 点击运行main方法就可以启动
+
+    注意:由于OrderService 启动需要刷缓存所以比起其他服务 需要传 -Dcache 参数才可以,具体参考地址 https://blog.csdn.net/u013713294/article/details/53020293
+

BIN
docs/start/images/all.jpg


BIN
docs/start/images/center_01.jpg


BIN
docs/start/images/center_02.jpg


BIN
docs/start/images/code_01.jpg


BIN
docs/start/images/comment_01.jpg


BIN
docs/start/images/comment_02.jpg


BIN
docs/start/images/console_01.jpg


BIN
docs/start/images/docker_all.jpg


BIN
docs/start/images/eureka_01.jpg


BIN
docs/start/images/eureka_02.jpg


BIN
docs/start/images/eureka_03.jpg


BIN
docs/start/images/git_code.jpg


BIN
docs/start/images/kafka_01.jpg


BIN
docs/start/images/mysql_01.jpg


BIN
docs/start/images/mysql_02.jpg


BIN
docs/start/images/mysql_03.jpg


BIN
docs/start/images/mysql_04.jpg


BIN
docs/start/images/redis_01.jpg


BIN
docs/start/images/redis_02.jpg


BIN
docs/start/images/shop_01.jpg


BIN
docs/start/images/store_01.jpg


BIN
docs/start/images/user_01.jpg


BIN
docs/start/images/zookeeper_01.jpg


BIN
docs/start/images/zookeeper_02.jpg


+ 0 - 207
docs/start/install.md

@@ -1,207 +0,0 @@
-### 变更历史
-版本|变更内容|变更时间|变更人员
-:-: | :-: | :-: | :-:
-v0.01|初稿|2018-07-24|wuxw
-
-### 本页内容
-
-1. [docker 安装(推荐)](#docker-安装推荐)
-2. [普通安装](#普通安装)
-
-## docker 安装(推荐)
-
-下载代码
-
-```
-  git clone https://github.com/java110/MicroCommunity.git
-```
-
-![下载代码](/images/git_code.jpg)
-
-
-1. mysql 安装
-
-切换目录到
-
-```
-
-cd MicroCommunity/java110-config/docker/mysql
-
-docker build -t java110/docker-mysql .
-
-```
-![mysql](/images/mysql_01.jpg)
-
-```
-  docker run -ti --name mysql_test -e MYSQL_ROOT_PASSWORD=123456 -p3306:3306 -idt java110/docker-mysql:latest
-
-  docker logs -f mysql_test
-
-```
-出现如下图安装成功
-
-![mysql安装成功](/images/mysql_02.jpg)
-
-用工具登录 如下图:
-
-![mysql_login](/images/mysql_03.jpg)
-
-![mysql_login](/images/mysql_04.jpg)
-
-安装完成
-
-2. redis 安装
-
-```
-docker pull redis
-docker run -ti --name redis_test -p6379:6379 -idt redis:latest
-docker logs -f redis_test
-```
-![redis download](/images/redis_01.jpg)
-![redis install complate](/images/redis_02.jpg)
-
-3. zookeeper 安装
-
-```
-docker pull zookeeper
-docker run -ti --name zookeeper_test -p2181:2181 -idt zookeeper:latest
-docker logs -f zookeeper_test
-```
-![zookeeper_download](/images/zookeeper_01.jpg)
-![zookeeper install complate](/images/zookeeper_02.jpg)
-
-4. kafka 安装
-
-```
-docker pull wurstmeister/kafka
-docker run --name kafka_test -e HOST_IP=localhost -e KAFKA_ADVERTISED_PORT=9092 -e KAFKA_BROKER_ID=1 -e KAFKA_ZOOKEEPER_CONNECT=192.168.31.199:2181 -e KAFKA_ADVERTISED_HOST_NAME=localhost -e ZK=zk -p 9092 --link zookeeper_test:zk -tdi wurstmeister/kafka
-docker logs -f kafka_test
-```
-![kafka install](/images/kafka_01.jpg)
-
-注意 KAFKA_ZOOKEEPER_CONNECT=192.168.31.199:2181 换成自己主机的IP端口
-
-5. 编译代码
-
-配置hosts
-dev.java110.com
-dev.redis.java110.com
-dev.zk.java110.com
-dev.db.java110.com
-dev.kafka.java110.com
-
-修改 MicroCommunity/XXService/src/main/resources 下的application-dev(开发环境) application-prod(生产环境) application-test(测试环境) 中的数据库地址 kafka地址 zookeeper地址 redis地址等
-
-XXService 代表 CenterService,CodeService,CommentService,ConsoleService,ShopService,StoreService,UserService 等
-
-```
-mvn clean install
-```
-![mvn code](/images/code_01.jpg)
-
-第一次编译需要下载jar 时间有点长
-
-6. 启动eureka 服务
-
-```
-  cd MicroCommunity/eureka/docker
-  chmod u+x onStart.sh
-  sh onStart.sh
-```
-![eureka 启动](/images/eureka_01.jpg)
-![eureka 启动](/images/eureka_02.jpg)
-![eureka 启动](/images/eureka_03.jpg)
-
-注意:如果报 Cannot connect to the Docker daemon. Is the docker daemon running on this host?错,执行
-下面代码
-
-```
-sudo gpasswd -a ${USER} docker
-sudo service docker restart
-```
-退出后重新进入
-
-7. 编码生成服务(CodeService)
-
-```
-  cd MicroCommunity/CodeService/docker
-  chmod u+x onStart.sh
-  sh onStart.sh
-```
-
-![code install](/images/code_01.jpg)
-
-8. 中心服务(CenterService)
-
-```
-  cd MicroCommunity/CenterService/docker
-  chmod u+x onStart.sh
-  sh onStart.sh
-```
-
-![中心服务](/images/center_01.jpg)
-![中心服务](/images/center_02.jpg)
-
-9. 评论服务(CommentService)
-
-```
-  cd MicroCommunity/CommentService/docker
-  chmod u+x onStart.sh
-  sh onStart.sh
-```
-
-![评论服务](/images/comment_01.jpg)
-![评论服务](/images/comment_02.jpg)
-
-10. 控制服务(ConsoleService)
-
-```
-  cd MicroCommunity/ConsoleService/docker
-  chmod u+x onStart.sh
-  sh onStart.sh
-```
-
-![控制服务](/images/console_01.jpg)
-
-11. 商品服务(ShopService)
-
-```
-  cd MicroCommunity/ShopService/docker
-  chmod u+x onStart.sh
-  sh onStart.sh
-```
-
-![商品服务](/images/shop_01.jpg)
-
-12. 商户服务(StoreService)
-
-```
-  cd MicroCommunity/StoreService/docker
-  chmod u+x onStart.sh
-  sh onStart.sh
-```
-
-![商户服务](/images/store_01.jpg)
-
-13. 用户服务(UserService)
-
-```
-  cd MicroCommunity/UserService/docker
-  chmod u+x onStart.sh
-  sh onStart.sh
-```
-
-![用户服务](/images/user_01.jpg)
-
-目前为止全部启动完成
-
-![启动完成](/images/all.jpg)
-
-![docker](/images/docker_all.jpg)
-
-
-
-## 普通安装
-
-
-[>回到首页](home)

+ 125 - 0
docs/start/prod_install.md

@@ -0,0 +1,125 @@
+### 变更历史
+版本|变更内容|变更时间|变更人员
+:-: | :-: | :-: | :-:
+v0.01|初稿|2018-07-24|wuxw
+
+### 本页内容
+
+生产环境用docker方式安装代码
+
+## 生产环境部署
+
+    这里推荐用docker 安装
+
+#### 下载代码
+
+```
+  git clone https://github.com/java110/MicroCommunity.git
+```
+
+![下载代码](images/git_code.jpg)
+
+
+#### mysql 安装
+
+切换目录到
+
+```
+
+cd MicroCommunity/java110-config/docker/mysql
+
+docker build -t java110/docker-mysql .
+
+```
+![mysql](images/mysql_01.jpg)
+
+```
+  docker run -ti --name mysql_test -e MYSQL_ROOT_PASSWORD=123456 -p3306:3306 -idt java110/docker-mysql:latest
+
+  docker logs -f mysql_test
+
+```
+出现如下图安装成功
+
+![mysql安装成功](images/mysql_02.jpg)
+
+用工具登录 如下图:
+
+![mysql_login](images/mysql_03.jpg)
+
+![mysql_login](images/mysql_04.jpg)
+
+安装完成
+
+#### redis 安装
+
+```
+docker pull redis
+docker run -ti --name redis_test -p6379:6379 -idt redis:latest
+docker logs -f redis_test
+```
+![redis download](images/redis_01.jpg)
+![redis install complate](images/redis_02.jpg)
+
+#### zookeeper 安装
+
+```
+docker pull zookeeper
+docker run -ti --name zookeeper_test -p2181:2181 -idt zookeeper:latest
+docker logs -f zookeeper_test
+```
+![zookeeper_download](images/zookeeper_01.jpg)
+![zookeeper install complate](images/zookeeper_02.jpg)
+
+#### kafka 安装
+
+```
+docker pull wurstmeister/kafka
+docker run --name kafka_test -e HOST_IP=localhost -e KAFKA_ADVERTISED_PORT=9092 -e KAFKA_BROKER_ID=1 -e KAFKA_ZOOKEEPER_CONNECT=192.168.31.199:2181 -e KAFKA_ADVERTISED_HOST_NAME=localhost -e ZK=zk -p 9092 --link zookeeper_test:zk -tdi wurstmeister/kafka
+docker logs -f kafka_test
+```
+![kafka install](images/kafka_01.jpg)
+
+注意 KAFKA_ZOOKEEPER_CONNECT=192.168.31.199:2181 换成自己主机的IP端口
+
+#### 编译代码
+
+配置hosts
+dev.java110.com 您的eureka服务IP
+dev.redis.java110.com 您的redis服务器IP
+dev.zk.java110.com 您的zookeeper服务器IP
+dev.db.java110.com 您的mysql服务器IP
+dev.kafka.java110.com 您的kafka服务器IP
+api.java110.com 您的api服务服务器IP
+
+修改 MicroCommunity/XXService/src/main/resources 下的application-dev(开发环境) application-prod(生产环境) application-test(测试环境) 中的数据库地址 kafka地址 zookeeper地址 redis地址等
+
+XXService 代表 CenterService,CodeService,CommentService,ConsoleService,ShopService,StoreService,UserService 等
+
+```
+mvn clean install
+```
+![mvn code](images/code_01.jpg)
+
+第一次编译需要下载jar 时间有点长
+
+#### 启动服务
+
+修改 reBuildAll.sh 中的 #docker-compose -f ./eureka/docker/docker-compose.yml       up -d --build --force-recreate;
+
+删除注释 # 号
+
+执行命令
+
+```
+    sh reBuildAll.sh
+```
+
+开始构建代码启动服务
+
+目前为止全部启动完成
+
+![启动完成](images/all.jpg)
+
+![docker](images/docker_all.jpg)
+