本文主要以图文的形式讲解 mall 项目所需环境在 windows 下的安装，主要包括 IDEA、Mysql、Redis、Mongodb、RabbitMQ、Elasticsearch、Logstash、Kibana、OSS。

#👍 相关视频教程

mall项目后端开发环境搭建open in new window

#IDEA

  • 将项目下载到本地，然后直接打开。

#Mysql

#Redis

  • 下载完后解压到指定目录；

  • 在当前地址栏输入cmd命令后，使用如下命令可以启动Redis服务；
1
redis-server.exe redis.windows.conf
  • 如果你想把Redis注册为系统服务来使用的话可以试试下面的命令。
1
2
3
4
5
6
7
8
# 安装为服务
redis-server --service-install redis.windows.conf
# 启动服务
redis-server --service-start 
# 停止服务
redis-server --service-stop
# 卸载服务
redis-server --service-uninstall

#Elasticsearch

  • 下载完成后解压到Elasticsearch的plugins目录下；

  • 运行bin目录下的elasticsearch.bat启动Elasticsearch服务。

#Kibana

  • 运行bin目录下的kibana.bat，启动Kibana服务；

#Logstash

  • 注意该版本最低要求JDK 11，需要自行安装，然后在环境变量中进行如下配置；
1
LS_JAVA_HOME=D:\developer\env\Java\jdk-11.0.14.1
  • Logstash需要安装json_lines插件；
1
logstash-plugin install logstash-codec-json_lines
  • 运行bin目录下的logstash.bat，启动Logstash服务，启动命令如下。
1
logstash -f logstash.conf

#MongoDB

  • 运行MongoDB安装包并选择自定义安装，设置好安装路径；

  • 配置MongoDB，让MongoDB作为服务运行，并配置好数据目录和日志目录；

  • 取消MongoDB Compass的安装选项（不取消安装极慢），需要可自行安装；

  • 双击mongo.exe可以运行MongoDB自带客户端，操作MongoDB；

  • 连接成功后会显示如下信息；

  • 如果需要移除MongoDB服务，只需使用管理员权限运行cmd工具，并输入如下命令。
1
sc.exe delete MongoDB

#RabbitMQ

  • 安装Erlang，直接双击安装包安装即可；

  • 下载文件为rabbitmq-server-3.10.5.exe，直接双击安装包安装即可；

  • 安装完成后，进入RabbitMQ安装目录下的sbin目录；

  • 在地址栏输入cmd并回车启动命令行，然后输入以下命令启动管理功能：
1
rabbitmq-plugins enable rabbitmq_management
  • 访问RabbitMQ管理页面地址，查看是否安装成功，默认账号密码为guest:guest，访问地址：http://localhost:15672/

  • 创建一个我们需要使用的帐号mall:mall，并设置其角色为管理员；

  • 创建一个新的虚拟host为，名称为/mall；

  • 点击mall用户进入用户配置页面；

  • 给mall用户配置该虚拟host的权限，至此，RabbitMQ的配置完成。

#MinIO

  • 下载完成后创建MinIO的数据存储目录，并使用如下启动命令MinIO服务；
1
minio.exe server D:\developer\env\minio\data --console-address ":9001"
  • 此时MinIO的API将运行在9000端口，MinIO Console管理页面将运行在9001端口；

  • MinIO服务运行成功后就可访问MinIO Console的管理界面了，输入账号密码minioadmin:minioadmin即可登录，访问地址：http://localhost:9001

  • 看下MinIO Console的左侧菜单，不仅支持了存储桶、文件的管理，还增加了用户、权限、监控等管理功能；

#OSS

注意：mall项目能同时支持OSS和MinIO两种对象存储，如果已经安装了MinIO，可以不使用OSS。

#开通OSS服务

  • 登录阿里云官网；
  • 将鼠标移至产品标签页，单击对象存储 OSS，打开OSS 产品详情页面；
  • 在OSS产品详情页，单击立即开通。

#创建存储空间

  • 点击网页右上角控制台按钮进入控制台；

  • 选择我的云产品中的对象存储OSS；

  • 点击左侧存储空间的加号新建存储空间；

  • 新建存储空间并设置读写权限为公共读。

#跨域资源共享（CORS）的设置

  • 选择一个存储空间，打开其基础设置；

  • 点击跨越设置的设置按钮；

  • 点击创建规则；

  • 进行跨域规则设置；

#mall-admin

#mall-portal

#接口文档

由于mall项目中的大部分接口需要登录认证之后才能访问，这里以mall-admin为例，介绍下接口文档的访问。

  • 接下来我们需要访问登录接口/admin/login来获取token；

  • 登录成功后，返回结果中将返回token和tokenHead；

  • 然后点击Swagger文档的Authorize按钮，输入tokenHead+token拼接的认证请求头，注意tokenHead后面有个空格；

  • 之后调用需要登录认证的接口，就可以正常访问了；

  • 对于mall-portal模块的接口调用也是一样的，登录获取token的接口为/sso/login。
    image.png