From 6dfb79334555e4a869b36f34fe31ddfe5fc30c89 Mon Sep 17 00:00:00 2001 From: ronger Date: Tue, 25 Apr 2023 15:46:04 +0800 Subject: [PATCH] =?UTF-8?q?:memo:=20=E5=AE=8C=E5=96=84=E7=94=A8=E6=88=B7?= =?UTF-8?q?=E6=89=8B=E5=86=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- UserManual.md | 64 ++++++++++++++++++--------------------------------- 1 file changed, 22 insertions(+), 42 deletions(-) diff --git a/UserManual.md b/UserManual.md index 7df412d..5b2503b 100644 --- a/UserManual.md +++ b/UserManual.md @@ -1,10 +1,9 @@ # forest 食用手册 -感谢使用 forest,以下是本项目的开发手册,你将了解到如何从零开始进行开发环境的搭建。运行本项目需要用到Mysql和Redis,你可以使用自己配置好的 -Mysql 和 Redis,也可以使用本项目提供的`docker`的方式快速搭建 Mysql 和 Redis 环境。 +感谢使用 forest,以下是本项目的开发手册,你将了解到如何从零开始进行开发环境的搭建。运行本项目需要用到 MySQL 和 Redis,你可以使用自己配置好的 +MySQL 和 Redis,也可以使用本项目提供的 `docker` 的方式快速搭建 MySQL 和 Redis 环境。 -本项目提供了两种方式,你可以一步一步按照教程来配置,也可以 -直接使用`docker`快速运行本项目。 +本项目提供了两种方式,你可以一步一步按照教程来配置,也可以直接使用 `docker` 快速运行本项目。 ## 获取最新代码到本地 @@ -13,42 +12,37 @@ git clone "https://github.com/rymcu/forest" ``` ## 开发环境搭建 - -你可以使用自己配置好的 Mysql 和 Redis,也可以使用本项目提供的`docker`的方式快速搭建 Mysql 和 Redis 环境。 - -### 方式1 - -你需要自己配置好下面的环境,下面是本项目所使用的基础开发环境,在运行项目前,请确保你已经配置好基础开发环境。 - +> 本项目在以下开发环境下开发,其他环境下可能会出现兼容性问题,建议使用以下环境进行开发。 - IDE: `JetBrains IntelliJ IDEA UItimate` -- `Java 8` -- `Mysql v8.0.29` -- `Redis v7.0.8` +- `Java 8(8u101 +)` +- `MySQL v7.x +` +- `Redis v7.x +` -### 方式2 +### 手动搭建 MySQL 和 Redis 环境 +> 手动安装 MySQL 时,需初始化数据库。 -该方式使用 Docker 搭建 Mysql 和 Redis 的开发环境 +在配置好 MySQL 和 Redis 的环境之后,在运行项目前,你还需要初始化好数据库中数据。通过执行 `src/main/resources/static` +目录下的 `forest.sql` 文件进行数据库初始化操作。 + +![forest-sql](https://static.rymcu.com/article/1650261394563.png) + + +### 使用 docker 快速搭建 MySQL 和 Redis 环境 +> 使用 docker 快速搭建 MySQL 和 Redis 环境时,请修改 `docker\dev` 目录下的 `docker-compose.yml` 文件中的默认密码。 - 确保你已经安装了 `Docker`和`Docker-compose` - 在 `docker\dev` 目录下执行 `docker-compose up` 可初始化 `redis` 和 `mysql` 环境 - 如需修改相关配置,请编辑 `docker\dev` 目录下的 `docker-compose.yml` 文件 -### 初始化数据库 - -在配置好 Mysql 和 Redis 的环境之后,在运行项目前,你还需要初始化好数据库中数据。通过执行 `src/main/resources/static` -目录下的 `forest.sql` 文件进行数据库初始化操作。 - -![forest-sql](https://static.rymcu.com/article/1650261394563.png) - ### 配置文件说明 -在初始化好数据库之后,你需要在`application.yml`中进行基本信息的配置,具体分为如下几个部分。 +在初始化好数据库之后,你需要在`application.yml`中进行相关信息的配置,具体分为如下几个部分。 #### 数据库配置 ```yaml datasource: - url: jdbc:mysql://localhost:3306/forest?characterEncoding=UTF-8&autoReconnect=true&useSSL=false&serverTimezone=Asia/Shanghai&allowMultiQueries=true + url: jdbc:mysql://localhost:3306/forest?characterEncoding=UTF-8&autoReconnect=true&useSSL=false&serverTimezone=Asia/Shanghai username: root password: # 数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver @@ -56,7 +50,6 @@ datasource: - `characterEncoding` 指定处理字符的解码和编码的格式 - `serverTimezone` 指定时区 -- `allowMultiQueries` 允许多行 `sql` 一起执行 #### redis 配置 @@ -96,23 +89,10 @@ resource: pic-path: /yoursrc/xx/nebula/static # 上传文件存储地址,本地测试时填写前端项目路径下的 static 目录即可 ``` -#### 百度相关配置(可选择) - -```yaml -baidu: - data: - site: https://yourdomain.com # 百度搜索(SEO)绑定网站域名 - token: xxxx - ai: - appId: xxx # 百度AI-文字识别 应用 appId - appKey: xxxx # 百度AI-文字识别 应用 appKey - secretKey: xxxx # 百度AI-文字识别 应用 secretKey -``` - ### 运行项目 -在你完成了前面的操作之后,就可以直接运行`ForestApplication.java`启动项目了,至此,如果后端项目已经成功启动,则可以切换到 -[nebula](https://github.com/rymcu/nebula)运行 前端项目了。 +在你完成了前面的操作之后,就可以直接运行`ForestApplication.java`启动项目了,至此,如果后端项目已经成功启动,则可以切换到 +[nebula](https://github.com/rymcu/nebula) 运行前端项目了。 ## 常见问题 @@ -135,4 +115,4 @@ spring: druid: # 关闭密码加密 connection-properties: config.decrypt=false;config.decrypt.key=${publicKey} -``` \ No newline at end of file +```