docs: 部署手册适配一键部署,去掉环境变量与示例配置

部署仓已改为开箱即用:config/ 直接是配置文件、口令等值内置在
docker-compose.yml、不再有 .env。

同步调整:
- 概览:部署流程改为 git clone + docker compose up -d 三步
- 配置说明:重写为「编排层 + 应用层」,说明为何不用环境变量
  (GoFrame 不展开配置文件中的 ${VAR})、改口令需同步三处、
  口令不能含 @ : / 等字符
- 启动与验证:去掉准备步骤,schema 脚本数改为 13 个
- 环境准备:镜像仓库改为描述编排文件中的实际地址
- 升级备份/离线/分离/自建镜像:.env 相关操作改为修改编排文件
This commit is contained in:
MiFaZhan
2026-10-29 09:20:09 +08:00
parent f169afc1bc
commit 73adad97f3
11 changed files with 244 additions and 168 deletions
+17 -11
View File
@@ -15,10 +15,9 @@ cd iotlcm-deploy
```text
iotlcm-deploy/
├── docker-compose.yml # 服务编排
├── .env.example # 环境变量模板
├── config.example/ # 应用配置模板(10 份)
└── schema/ # 数据库初始化脚本(12 个)
├── docker-compose.yml # 服务编排(含默认口令与端口)
├── config/ # 各服务配置,10 份,已带可用默认值
└── schema/ # 数据库初始化脚本,13 个,首次启动自动执行
```
## 部署内容
@@ -37,20 +36,27 @@ iotlcm-deploy/
## 部署流程
```bash
cp .env.example .env # 1. 环境变量
cp -r config.example config # 2. 应用配置
docker compose up -d # 3. 启动
git clone <部署仓地址> iotlcm-deploy
cd iotlcm-deploy
docker compose up -d
```
首次启动自动建库并导入 schema,约 1~2 分钟。
三步,不需要复制或修改任何文件——配置与编排都随仓库分发且带可用默认值。首次启动自动建库并导入 schema,约 1~2 分钟。
启动后访问 `http://<宿主机IP>:8009`,账号 `admin`,口令见 `docker-compose.yml`。
::: warning 默认口令只用于试用
正式部署前必须修改数据库、Redis、RabbitMQ、admin 账号口令与 JWT 密钥,详见[配置说明](configuration)。
:::
## 文档导航
| 文档 | 内容 |
| --- | --- |
| [环境准备](prerequisites) | 硬件、系统、Docker 版本、端口规划 |
| [配置说明](configuration) | `.env` 与 `config/` 各项含义 |
| [环境准备](prerequisites) | 硬件、系统、Docker 版本、镜像仓库、端口规划 |
| [配置说明](configuration) | `docker-compose.yml` 与 `config/` 各项含义 |
| [启动与验证](install) | 启动流程、验证清单、首次登录 |
| [其他部署方式](alternatives) | 二进制、自建镜像、分离、离线 |
| [可选服务](optional) | 接口挡板、飞书通知、反向代理 |
| [升级与备份](operations) | 版本固定、升级回滚、数据备份 |
| [故障排查](troubleshooting) | 常见问题与处理 |
@@ -88,4 +94,4 @@ docker compose up -d # 3. 启动
| 11190 / 11200 | sms | 仅内网 |
| 8080 | onelink-mock | 仅联调 |
端口冲突时修改 `.env` 中对应变量,不要直接改 `docker-compose.yml`。
端口冲突时修改 `docker-compose.yml` 中对应变量,不要直接改 `docker-compose.yml`。