速览
各位如果需要将项目部署在本地进行测试,以下环境请提前备好:
- Java 8
- MySQL 5.7
- Redis
- Kafka 2.13-2.7.0
- Elasticsearch 6.4.3
使用 IDEA 打开本项目,等待所有的依赖下载完毕。然后「修改配置文件中的信息为你自己的本地环境,直接运行是运行不了的」,而且相关私密信息我全部用 xxxxxxx 代替了。
本地运行需要修改的配置文件信息如下:
1)application-develop.properties
:
- MySQL
- Spring Mail(邮箱需要开启 SMTP 服务)
- Kafka:consumer.group-id(该字段见 Kafka 安装包中的 consumer.proerties,可自行修改, 修改完毕后需要重启 Kafka)
- Elasticsearch:cluster-name(该字段见 Elasticsearch 安装包中的 elasticsearch.yml,可自行修改)
- 七牛云(需要新建一个七牛云的对象存储空间,用来存放上传的头像图片)
2)logback-spring-develop.xml
:
- LOG_PATH:日志存放的位置
每次运行之前都需要打开:
- MySQL
- Redis
- Elasticsearch
- Kafka
另外,还需要事件建好数据库 greatecommunity,然后依次运行项目 sql 文件夹下的这几个 sql 文件建立数据库表:
下文是各个组件的详细配置,关于 Java、Maven 的配置这里就不说了,各位自行百度。
MySQL
① 下载并安装 MySQL 5.7 版本,下载地址:https://dev.mysql.com/downloads/installer/
② 设置数据库帐号密码
③ 下载并安装客户端连接工具 Navicat,下载地址:http://www.formysql.com/xiazai.html
④ 创建数据库 greatecommunity
⑤ 依次导入本项目 sql 文件夹下的 5 个 sql 文件
⑥ 修改项目配置文件 application-develop.properties
下的相关配置
Redis
① 下载 Redis for Windows,下载地址:https://github.com/MicrosoftArchive/redis/releases
② 下载完后直接解压即可
③ 配置环境变量(系统变量 Path),方便通过命令行启动 Redis
④ 通过命令 redis-server
启动 Redis
❝如果启动报错找不到 6379 端口,可以先输入
redis-cli
命令,然后exit
,再输入redis-server
❞
Elasticsearch
① 下载 Elasticsearch 6.4.3:https://www.elastic.co/cn/downloads/past-releases/elasticsearch-6-4-3
❝注意,下载 ElasticSearch 版本一定要与你的 SpringBoot 版本内部规定的一致,我的是 SpringBoot 2.1.5。为了防止后面出现各种各样的 Bug,各位小伙伴还是尽量和我的版本保持一致。 ❞
② 解压完毕后,需要简单配置一下:config/elasticsearch.yml
③ 然后再配到环境变量(系统变量 Path)中去:
④ 还需要安装一个「中文分词插件」(Elasticsearch 自带一个英文分词插件)elasticsearch-analysis-ik 6.4.3,下载地址:https://github.com/medcl/elasticsearch-analysis-ik/releases/tag/v6.4.3)
注意:必须解压到你的 Elasticsearch 安装目录的 plugins/ik
文件夹下(比如我的就是 D:elasticsearch-6.4.3pluginsik)
⑤ 修改项目配置文件 application-develop.properties
下的相关配置:
⑥ 启动 Elasticsearch:双击 elasticsearch.bat
即可(首次运行可能会需要一点时间才能启动)
Kafka
① 下载并安装 Kafka_2.13-2.7.0:https://www.apache.org/dyn/closer.cgi?path=/kafka/2.7.0/kafka_2.13-2.7.0.tgz
② Kafka 自带 Zookeeper,对其配置文件 zookeeper.properties
进行相应的修改:
③ 修改 Kafka 日志文件的存放位置 server.properties
:
❝如果后续 Kafka 的启动出现了问题,删除这个文件夹 kafka-logs 然后重新启动就好了,这是 Windows 下的一个 BUG。 ❞
④ 修改 consumer.group-id,在 consumer.proerties
文件下
⑤ 修改项目配置文件 application-develop.properties
下的相关配置:
⑥ 启动 Kafka
第一步:开启一个命令行,输入如下命令
代码语言:javascript复制cd d:kafka_2.13-2.7.0
binwindowszookeeper-server-start.bat configzookeeper.properties
第二步:开启另一个命令行,输入如下命令
代码语言:javascript复制cd d:kafka_2.13-2.7.0
binwindowskafka-server-start.bat configserver.properties
Spring Mail
① Spring Mail 用于发送激活邮件,你需要注册一个邮箱,并开启 SMTP 服务,这里以新浪邮箱为例:
② 修改项目配置文件 application-develop.properties
下的相关配置:
七牛云
本项目的头像文件存储在七牛云服务器。
① 在七牛云创建一个对象存储空间,测试域名有效期 30 天,且不支持 https 访问,只能 http。
❝30 天后这个测试域名就失效了,再重新创建一个空间就行了,或者也可以绑定自己购买的域名。 ❞
② 查看密钥:
- AK:标识身份
- SK:用于加密上传文件
③ 修改项目配置文件 application-develop.properties
下的相关配置:
日志
最后,修改一下 logback-spring-develop.xml
中日志文件的存放位置:
本地环境全部配置完毕,运行 com.greate.community.CommunityApplication
开始体验 Echo 吧 ?