✨ feat: add storage config document

Author: lwnmengjing

docs/admin/docker.md

@@ -0,0 +1,47 @@
+---
+title: 容器化
+order: 12
+nav:
+  order: 1
+  title: admin
+description: 在容器中运行mss-boot-admin
+keywords: [admin docker run]
+---
+## 准备环境
+[本地安装docker环境](https://blog.csdn.net/m0_67393295/article/details/126327312?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522170460779016800180620265%2522%252C%2522scm%2522%253A%252220140713.130102334..%2522%257D&request_id=170460779016800180620265&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~top_click~default-2-126327312-null-null.142^v99^pc_search_result_base1&utm_term=docker%20desktop%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&spm=1018.2226.3001.4187)
+
+## 运行mysql
+```shell
+docker run -d \
+  --name mysql \
+  --network host \
+  -e MYSQL_ROOT_PASSWORD=123456 \
+  -e MYSQL_DATABASE=mss-boot-admin-local \
+  -p 3306:3306 \
+  mysql:8
+```
+## 迁移数据
+```shell
+docker run \
+  --rm \
+  --network host \
+  ghcr.io/mss-boot-io/mss-boot-admin:latest \
+  migrate
+```
+## 运行服务端
+```shell
+docker run -d \
+  --name mss-boot-admin \
+  --network host \
+  -p 8080:8080 \
+  ghcr.io/mss-boot-io/mss-boot-admin:latest \
+  server
+```
+## 运行前端
+```shell
+docker run -d \
+  --name mss-boot-admin-antd \
+  --network host \
+  -p 8000:80 \
+  ghcr.io/mss-boot-io/mss-boot-admin-antd:latest
+```

docs/admin/tutorials.md

@@ -52,3 +52,80 @@ oauth2:
 export CLIENTID=xxxx
 export CLIENTSECRET=xxxx
 ```
+
+### 缓存配置
+:::info
+利用缓存模块(memory/redis)可以提高系统性能，同时系统的应用配置模块也支持缓存配置，可以通过缓存配置来提高系统性能，自己在开发时，可以合理利用缓存来提高系统性能。
+:::
+> `mss-boot-admin`的缓存配置支持`redis`和`memory`两种缓存方式，`memory`为内存缓存一般用于本地开发，`redis`为redis缓存，一般用于生产环境，如下所示：
+> 
+#### 将redis密码作为环境变量传入
+```shell
+export REDIS_PASSWORD=xxxx
+```
+#### 配置memory缓存
+```yaml
+cache:
+  memory: ''
+```
+#### 配置redis缓存
+```yaml
+cache:
+  redis:
+    addr: 'localhost:6379'
+    password: {{ .Env.REDIS_PASSWORD }}
+    db: 9
+```
+
+### 队列配置
+:::info
+利用队列模块(memory/kafka/redis/nsq)可以将一些耗时的任务放入队列中，然后异步执行，这样可以提高系统性能，同时系统的应用配置模块也支持队列配置，可以通过队列配置来提高系统性能和可靠性，自己在开发时，可以合理利用队列。
+:::
+> `mss-boot-admin`的队列配置支持`memory`、`kafka`、`nsq`和`redis`四种队列方式，`memory`为内存队列一般用于本地开发，`kafka`为kafka队列，一般用于生产环境，`nsq`为nsq队列，一般用于生产环境且对消息没有顺序要求的场景，`redis`为redis队列，一般用于负载极小的场景。
+> 
+:::warning
+`kafka`适用于对消息有顺序要求的场景，`nsq`适用于对消息没有顺序要求的场景，`redis`适用于负载极小的场景，请根据自己的业务场景选择合适的队列。
+:::
+#### 配置memory队列
+```yaml
+queue:
+  memory:
+    poolNum: 10 # 队列池大小
+```
+#### 配置kafka队列
+```yaml
+queue:
+  kafka:
+    brokers:
+      - 'localhost:9092'
+    version: '3.6.0' # kafka版本(默认1.0.0)
+```
+#### 配置nsq队列
+```yaml
+queue:
+  nsq:
+    addresses:
+      - 'localhost:4150'
+    lookupdAddr: 'localhost:4161' # nsqlookupd地址, 用于监听和topic管理nsqd节点, 供消费者使用
+    adminAddr: 'localhost:4171'  # nsqadmin地址, 用于获取所有节点信息供生产者使用
+```
+### 分布式锁配置
+:::info
+利用分布式锁可以解决分布式环境下的并发问题，同时系统的应用配置模块也支持分布式锁配置，可以通过分布式锁配置来解决分布式环境下的并发问题，自己在开发时，可以合理利用分布式锁。
+:::
+> `mss-boot-admin`的分布式锁配置只支持`redis`，一般用于生产环境。
+> 
+#### 配置redis分布式锁
+```yaml
+### 如果cache和queue都没有使用redis，需要完整配置redis
+locker:
+  redis:
+    addr: 'localhost:6379'
+    password: {{ .Env.REDIS_PASSWORD }}
+    db: 9
+```
+```yaml
+### 如果cache或queue使用redis，只需要配置redis这个参数即可
+locker:
+  redis: {}
+```