Skip to content

Latest commit

 

History

History
241 lines (155 loc) · 6.95 KB

README.md

File metadata and controls

241 lines (155 loc) · 6.95 KB

开发教程

导入项目

环境准备

  1. IDE：IntelliJ IDEA 或者 STS（Spring Tools Suite）

  2. 请使用JDK8及以上版本

  3. 构建工具使用 Maven

  4. 本项目使用了Lombok，所以请确保IDEA安装了Lombok插件,对于IDEA 2020.3及以上版本已默认内置Lombok插件无需安装,低版本IDEA安装Lombok插件后请在设置中启用 Build, Execution, Deployment/Annotation Processors 的 Enable annotation processing

  5. 安装Redis，可以使用docker安装

docker run --name redis -p 6379:6379 -d redis redis-server

更多内容参考: Docker Hub Redis 6. 安装Mysql，本项目使用的mysql驱动版本是8.0.19, 所以可以默认安装mysql最新版，如果是低版本没有测试过不知道是否支持 7. 对于前端项目还需要Nodejs环境，编辑器推荐Vscode

后端项目

克隆项目到本地

git clone https://github.com/guqing/violet-cloud.git

配置Nacos

通过github可以下载到nacos点击👉下载地址👈选择版本即可看到如下内容，版本可以选择最新版

image-20201031225948160

两个文件随意二选一下载即可。

下载好以后解压得到如下目录：

image-20201031230257662

由于nacos不支持mysql8版本需要自备驱动，所以对于使用mysql8及其以上版本的用户需要进行如下操作：

新建一个plugins目录并创建在目录mysql，然后复制一个mysql的驱动放到该目录下名字随意但不要有中文，最后结果如下：

image-20201031230856385

这样在nacos启动时就会自动寻找到该mysql驱动啦。

然后还需要配置nacos连接到mysql数据库，需要修改conf目录下的application.yaml文件

image-20201031231949980

按自己的mysql数据库信息进行如下配置:

端口号改为8001

数据库名称改为violet_nacos

image-20201031232424338

然后到数据库执行项目中的violet_nacos.sql脚本

image-20201031232758430

操作完以上步骤就可以启动nacos了,windows用户点击bin/startup.cmd, Mac及Linux执行如下命令：

sh bin/startup.sh -m standalone

image-20201031233223629

可以查看logs/start.out启动日志确认是否启动成功。

image-20201031234923461

打开浏览器访问:

http://localhost:8001/nacos

即可看到登录页面，登录账号如下:

用户名：violet
密码: 123456

登录成功后就可以看到项目配置列表了，根据需要将这三个配置文件中127.0.0.1修改为自己对应的ip地址

image-20201101000153237

导入基础数据

到数据库管理软件中执行如下脚本，即可完成数据库创建和基础数据导入

image-20201101002023978

系统账号

用户名: guqing
密码: 123456

运行项目

使用IDEA打开项目，并分别给以下三个模块设置运行环境变量指定nacos连接地址

项目后台接口：violet-app-admin
认证中心： violet-auth
服务网关: violet-gateway
服务监控: violet-apm-admin

image-20210113151530591

同时在IDEA的File->Settings菜单中配置Maven运行环境变量否则package时会报错

maven-build-env

做好以上准备即可启动Violet服务:

image-20201101152209895

服务状态监控

  1. 启动成功后可到Nacos控制到查看服务状态

image-20210113152809329

  1. 也可以启动violet-apm-admin模块监控实例状态

启动成功后访问ip:8401

image-20210113153404712

输入以下账号密码即可成功登录

账号: violet
密码: 123456

登录成功后效果如下

image-20210113153505418

violet-apm-admin的账号密码可以在nacos中找到Data Id为violet-apm-admin的配置修改

image-20210113153323178

前端项目

克隆项目

git clone https://github.com/guqing/violet-cloud-web.git

检查api路径

由于我使用travsi ci自动部署预览项目到服务器所以api地址，如果是本地启动需要修改如下文件

image-20201101154403315

中的VUE_APP_API_BASE_URL为网关模块violet-gateway的地址本地启动则是http://127.0.0.1:8301

image-20201101154508723

安装依赖

切换到项目文件夹

使用yarn安装或npm安装都可以，前提是安装了Nodejs

使用yarn方式

# 安装
yarn install
# 启动
yarn run serve

或者使用npm方式

# 安装
npm install
# 启动
npm run serve

启动成功即可看到

image-20201101154818718

配置网关增强

网关管理模块包括:网关用户、网关日志、限流规则、黑名单管理和拦截日志,如果要使用这些功能需要开启网关增强。

安装mongodb数据库

对于Linux或Mac用户可以使用docker安装方式，执行以下步骤时请确保你已安装docker

docker run --name mongo -p 27017:27017 -v $PWD/db:/data/db -d mongo

查看容器

docker ps
# 结果如下示例
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                               NAMES
7b4a174525d3        mongo               "docker-entrypoint..."   24 minutes ago      Up 24 minutes       0.0.0.0:27017->27017/tcp            mongo

复制CONTAINER ID（容器id）执行如下命令

docker exec -it 容器id /bin/bash

再依次执行以下命令

mongo

use violet_cloud_route

db.createUser({ user:'guqing',pwd:'12345678',roles:[ { role:'readWrite', db: 'violet_cloud_route'}]});

结果如下图所示

mongodb创建用户

执行完后别着急退出，继续执行如下图脚本里的内容 img.png

启用网关增强

在nacos控制台修改violet-gateway.yaml如下图所示，注释MongoAutoConfiguration并配置mongodb连接就完成啦

autoconfigure:
  exclude: org.springframework.boot.autoconfigure.mongo.MongoReactiveAutoConfiguration,org.springframework.boot.autoconfigure.data.mongo.MongoReactiveRepositoriesAutoConfiguration,org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration

img.png