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
+30 -12
View File
@@ -35,7 +35,7 @@ outline: deep
| 操作系统 | Linux x86_64(CentOS 7+ / Ubuntu 20.04+ / Debian 11+) |
| 内核 | 3.10 以上 |
| 文件系统 | ext4 / xfs |
| 时区 | 建议 `Asia/Shanghai`,与 `.env` 的 `TZ` 保持一致 |
| 时区 | 建议 `Asia/Shanghai`,与 `docker-compose.yml` 的 `TZ` 保持一致 |
## Docker 要求
@@ -55,22 +55,40 @@ docker compose version
## 镜像仓库
平台镜像由官方镜像仓库分发,需要:
平台镜像发布在阿里云容器镜像服务,**仓库类型为公开,无需登录即可拉取**。
1. 能访问镜像仓库地址(内网仓库需先配置网络或代理)
2. 具备拉取权限
| 项 | 值 |
| --- | --- |
| 公网地址 | `crpi-qflrqrxoohllkvgc.cn-chengdu.personal.cr.aliyuncs.com` |
| VPC 地址 | `crpi-qflrqrxoohllkvgc-vpc.cn-chengdu.personal.cr.aliyuncs.com` |
| 命名空间 | `iotlcm` |
| 地域 | 西南1(成都) |
```bash
docker login <镜像仓库地址>
业务镜像路径为:
```text
crpi-qflrqrxoohllkvgc.cn-chengdu.personal.cr.aliyuncs.com/iotlcm/iotlcm-admin-svr:1.0.3
crpi-qflrqrxoohllkvgc.cn-chengdu.personal.cr.aliyuncs.com/iotlcm/iotlcm-openapi:1.0.3
...
```
`.env` 的 `REGISTRY` 填写仓库地址,不含 `https://` 与末尾斜杠:
`docker-compose.yml` 里的镜像地址已预置为上述公网地址,一般无需修改。
```bash
REGISTRY=registry.example.com
::: tip 基础组件也在同一仓库
MySQL、Redis、RabbitMQ、Consul、nginx 同样托管在 `library/` 命名空间下,不从 Docker Hub 直连(公网不稳定且 tag 会漂)。版本已在编排文件中固定,**必须与仓库里实际同步的标签一致**。
:::
::: warning 基础组件需先同步
部署前 `library/` 下必须已有这五个镜像,否则拉取失败。同步方法见[自建镜像](build-image)的「同步基础组件」一节。
:::
::: tip 阿里云 VPC 地址
若部署在阿里云同地域 ECS 上,可把编排文件里的镜像前缀改为 VPC 地址,走内网流量、不消耗公网带宽:
```yaml
image: 'crpi-qflrqrxoohllkvgc-vpc.cn-chengdu.personal.cr.aliyuncs.com/library/mysql:8.0'
```
基础组件从 `<REGISTRY>/library/` 拉取(mysql、redis、rabbitmq、consul、nginx),业务镜像从 `<REGISTRY>/iotlcm/` 拉取。
:::
## 网络与防火墙
@@ -96,7 +114,7 @@ firewall-cmd --reload
| 微信支付 | 在线支付 | 支付功能不可用 |
| 飞书 | 运维通知 | 不启动 bot 即可 |
TDengine 需开启 WebSocket 接口(默认 6041),在 `.env` 中配置:
TDengine 需开启 WebSocket 接口(默认 6041),在 `docker-compose.yml` 中配置:
```bash
TDENGINE_HOST=tdengine.example.com