Merge branch 'openimsdk:main' into docs/dev

Author: mo3et

docs/guides/gettingStarted/config-center.assets/i0.png

@@ -1,4 +1,78 @@
 ---
 title: '配置中心'
-sidebar_position: 11
+sidebar_position: 11 
 ---
+
+# OpenIM配置中心说明
+
+## 介绍
+
+
+
+配置中心是 OpenIM 提供的可视化配置管理模块，支持用户在图形化界面中便捷地修改服务端配置，并可根据最新配置自动重启相应服务并应用变更。该配置中心分别面向 OpenIMServer 和 Chat 两个系统，二者相互独立，即便存在相同字段（例如 secret），也需要在各自系统中分别修改。
+
+在之前的版本中，开发者可以通过以下两种方式修改配置：  
+- **源码部署**：手动编辑 `config` 目录下的配置文件，并重启服务。  
+- **Docker 部署**：设置相应的环境变量，并重启 Docker 容器。  
+
+上述两种方式统称为“本地修改”或“本地配置文件”方式。
+
+
+
+## 使用说明
+
+### 访问界面
+
+在浏览器中输入 `http://your_server_ip:11002` 来访问管理后台。`your_server_ip` 为服务端部署机器`ip`地址，确保您的浏览器能访问。默认账号和密码均为 `chatAdmin`。
+
+在左侧的菜单栏中选择“运维中心”，选择“IM配置管理”，即可进入OpenIMServer配置中心页面。
+
+配置中心功能默认不启用，第一次进入配置中心页面需要点击“启用配置管理”开启。
+
+
+
+![i0](config-center.assets/i0.png)
+
+### 查看配置
+
+点击“IM配置管理”后，界面左上角会显示部署方式以及当前版本。配置中心仅在源码和docker部署方式下生效，在kubernetes环境下不生效。
+如下图所示为源码部署、服务端为3.8.2版本：
+
+![i1](config-center.assets/i1.png)
+
+`Common Configuration`表示常用的配置，下方展示了常用的配置字段，鼠标悬浮于字段上方可查看字段含义，如下图所示：
+
+![i2](config-center.assets/i2.png)
+
+### 编辑配置
+
+鼠标点击`Common Configuration`下的配置字段或者点击下方各个配置文件右上角的“编辑”按钮，即可对配置文件进行修改。修改后，点击“保存”，即可更新配置，系统会自动重启相关的服务以应用新的配置。如下图所示：
+
+![i3](config-center.assets/i3.png)
+
+![i4](config-center.assets/i4.png)
+
+
+
+### 重启系统/重置配置
+
+配置中心右上角有 `重启系统 `和 `重置配置 `两个按钮。
+
+如果您发现在某些极端情况下，修改了配置之后系统没有正确应用，可点击 `重启系统 `保证配置被正确加载。
+
+ `重置配置 `表示系统将重新以本地配置文件覆盖配置中心的配置，这样会导致之前所有在配置中心的修改全部丢失。
+如在源码部署时修改了本地配置文件，或在docker部署时设置了环境变量，您希望以本地配置为准，则可以点击 `重置配置 `
+
+
+![i5](config-center.assets/i5.png)
+
+### 关闭配置中心
+
+点击上方“关闭配置管理”按钮，可关闭配置中心。关闭配置中心以后，系统以本地配置为准，之前的所有关于配置的修改都不再生效。
+
+## 注意事项
+
+1. 配置中心启用时，在本地配置文件的修改无法生效，只能通过配置中心进行配置的修改。
+2. 配置中心一旦关闭，会丢失在开启过程中进行的配置。
+3. 配置中心启用时，重启服务，已经修改的配置依然生效。
+4. 重置配置，会导致之前所有在配置中心的修改全部丢失。

docs/guides/gettingStarted/config-center.assets/i1.png

@@ -0,0 +1,55 @@
+---
+title: '如何迁移到其他S3存储'
+sidebar_position: 9
+
+---
+
+# S3存储接入
+
+### 获取最新代码
+请下载项目的最新代码版本：
+  - 最新代码已集成`S3`迁移工具，无需单独操作。
+```shell
+git clone https://github.com/openimsdk/open-im-server.git
+cd open-im-server
+```
+
+### 配置文件修改指南
+请根据需要修改`config`目录下的相关配置文件，以完成迁移相关的 S3 配置：
+1. 编辑`openim-rpc-third.yml`配置文件
+   - 定位并更新与 S3 相关的配置项，确保其符合您的实际迁移需求。
+2. 关于 minio.yml 配置文件
+   - 如果项目中未实际使用 MinIO，该文件可以忽略。
+   - 如需使用，请同样根据迁移需求更新 S3 配置相关项。
+3. `openim-rpc-third.yml`中都有`object.enable`字段，用于指定新的S3存储引擎。
+
+### 编译S3迁移工具
+1. 进入工具目录
+```shell
+cd tools/s3
+```
+2. 执行编译命令
+```shell
+go build -o s3convert main.go
+```
+
+### 开始迁移
+为确保数据迁移过程的稳定性，请按照以下建议进行操作：
+1. 准备工作
+   - 关闭服务：建议在服务停止的状态下进行迁移操作，以避免数据不一致或操作冲突。
+   - 备份 MongoDB：重点备份`s3`表的数据，以便在发生意外时快速恢复。
+2. 迁移说明
+   - 迁移工具不会删除原有的`S3`数据，但会修改`MongoDB`中`s3`表的相关记录。
+   - 请在迁移完成后，核对数据完整性，确保所有迁移步骤正确执行。
+3. 执行迁移命令
+   - `<config dir path>`：指定配置文件目录路径。
+   - `<old s3 name>`：填写原 S3 配置名称，例如 minio。
+```shell
+./s3convert -config <config dir path> -name <old s3 name>
+```
+4. 示例命令
+如配置文件位于 config 目录下，且原 S3 名称为 minio，可执行以下命令：
+```shell
+./s3convert -config ./../../config -name minio
+```
+当看到输出信息`success`时，表示迁移操作已完成。