chore: initialize local deployment baseline
This commit is contained in:
commit
9e2196d69f
30 files changed
+1436
No files matched your search
@@ -0,0 +1,58 @@
|
||||
# 本地部署目标架构
|
||||
|
||||
## 第一阶段:中心适配服务器
|
||||
|
||||
```text
|
||||
浏览器 / 管理员
|
||||
|
|
||||
HTTPS 443
|
||||
|
|
||||
统一网关(Nginx 或客户现有网关)
|
||||
|--------------------|
|
||||
平台前端 AI SoulMate 管理端
|
||||
|--------------------|
|
||||
平台后端
|
||||
|----------|----------|
|
||||
PostgreSQL Redis 本地 S3 兼容对象存储
|
||||
|
||||
平台后端 ---- HTTPS 出站 ---- Tripo API
|
||||
```
|
||||
|
||||
除 Tripo 调用外,数据库、缓存、对象文件、平台服务和管理端均位于客户局域网。默认只对业务网开放网关的 `443`;PostgreSQL、Redis 和对象存储管理端口不直接暴露。
|
||||
|
||||
## 第二阶段:农场工作站
|
||||
|
||||
```text
|
||||
中心平台后端 -- HTTPS / 设备身份认证 --> 农场端工作站
|
||||
|
|
||||
本地任务缓存 / 客户端数据库
|
||||
|
|
||||
打印机 / Moonraker
|
||||
```
|
||||
|
||||
农场端主动发起心跳、拉取任务和上报状态,中心端不直接访问打印机网络。后续需要补齐设备级凭证、幂等任务、断网重试、升级和审计能力。
|
||||
|
||||
## 服务职责
|
||||
|
||||
| 服务 | 第一阶段位置 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| `ai-soulmate-server` | 中心服务器 | 前端与 FastAPI 后端 |
|
||||
| `mlkj-admin` AI SoulMate 部分 | 中心服务器 | 必须支持 AI-only 模式,不能强依赖其他业务库 |
|
||||
| PostgreSQL | 中心服务器 | 使用独立数据库/角色,定期备份 |
|
||||
| Redis | 中心服务器 | 只在容器网络开放,启用持久化与认证 |
|
||||
| 本地对象存储 | 中心服务器 | 通过统一存储接口接入,不继续绑定阿里 `oss2` |
|
||||
| 统一网关 | 中心服务器 | TLS、路由、上传限制、访问日志和基础限流 |
|
||||
| Tripo | 外部服务 | 当前为必要出站依赖,指标必须与本地容量分开 |
|
||||
| `ai-soulmate-client` | 后续农场工作站 | 靠近打印机,暂不纳入中心服务器 POC |
|
||||
|
||||
## 网关判断
|
||||
|
||||
网关能力需要保留,但不建议直接部署现有 `nginx-server`:它面向现有公网域名和固定容器名,目前也没有完整覆盖管理端与农场端。私有版应在本仓库维护环境无关的路由模板;如果客户已有负载均衡或企业网关,则由其替代 Nginx。
|
||||
|
||||
## 安全边界
|
||||
|
||||
- 禁止把数据库、Redis 和对象存储管理端口映射到公网。
|
||||
- Tripo、短信、支付等外部能力按现场需求逐项启用,默认关闭非必要集成。
|
||||
- 平台用户、管理员和农场设备使用不同身份体系与凭证。
|
||||
- 所有密码和 API Key 在部署时注入,不构建进镜像、不写入 Git。
|
||||
- 管理端、备份和监控访问应限制到管理网或 VPN。
|
||||
@@ -0,0 +1,66 @@
|
||||
# 容量与压测方案
|
||||
|
||||
## 目标
|
||||
|
||||
压测用于回答“在某个明确硬件、软件版本、配置和业务模型下,能够稳定承载多少负载”,而不是只给出一个脱离场景的并发数。
|
||||
|
||||
必须分开衡量:
|
||||
|
||||
1. 本地平台容量:网关、后端、数据库、Redis 和对象存储。
|
||||
2. 外部依赖体验:Tripo 的排队、生成、轮询、下载、限流和错误。
|
||||
3. 农场端能力:后续工作站接入后的任务吞吐、断线恢复和打印机处理速度。
|
||||
|
||||
## 测试场景
|
||||
|
||||
| 编号 | 场景 | 主要瓶颈 |
|
||||
| --- | --- | --- |
|
||||
| S01 | 健康检查、登录、用户与模型列表读取 | 网关、API、数据库连接池 |
|
||||
| S02 | 管理端搜索、分页、统计查询 | SQL、索引、CPU、数据库缓存 |
|
||||
| S03 | 文件预签名、上传和下载 | 网络、对象存储、磁盘 I/O |
|
||||
| S04 | 任务创建、状态轮询、结果持久化 | API、Redis、数据库写入 |
|
||||
| S05 | Tripo 提交与轮询 | 外部 API 延迟/限流、本地状态机 |
|
||||
| S06 | 读写、文件和任务的业务比例混合负载 | 整机资源争用 |
|
||||
| S07 | 后续中心到农场端任务分发与状态回传 | 设备队列、网络、幂等与重试 |
|
||||
|
||||
S05 必须同时报告“本地处理耗时”和“Tripo 外部等待耗时”,不能用 Tripo 的波动推导本地服务器极限。
|
||||
|
||||
## 负载方法
|
||||
|
||||
- 先做 5 分钟预热,再保持 15–30 分钟稳态,最后观察 5 分钟恢复。
|
||||
- 从低负载开始,以 `1、2、5、10、15、20…` 并发逐级增加;接近瓶颈后缩小步长。
|
||||
- 每个稳态档位重复至少 3 次,报告中位数以及最好/最差值,不只保留一次结果。
|
||||
- 使用固定的脱敏数据集、对象大小分布和业务操作比例。
|
||||
- 文件场景至少区分小文件、典型模型文件和大文件;记录客户端与服务器网络速率。
|
||||
- 在 32GB、64GB 或不同磁盘方案之间对比时,只改变一个主要变量。
|
||||
|
||||
## 必采指标
|
||||
|
||||
- 业务:吞吐量、成功率、错误码、p50/p95/p99、超时、队列长度。
|
||||
- 主机:CPU/Load、可用内存、Swap in/out、磁盘吞吐/IOPS/await/利用率、网络吞吐与丢包。
|
||||
- 容器:CPU、内存、重启次数、健康状态、限额和 OOM。
|
||||
- PostgreSQL:活跃/等待连接、连接池、慢 SQL、锁等待、缓存命中、事务率。
|
||||
- Redis:命令延迟、连接、内存、eviction、持久化状态。
|
||||
- 对象存储:上传/下载吞吐、首字节时间、错误率、磁盘占用。
|
||||
- Tripo:提交/轮询/下载分别耗时,API 限流、错误、外部排队时长。
|
||||
|
||||
## 停止与失效条件
|
||||
|
||||
以下任一情况出现时停止继续加压,保留现场数据并定位瓶颈:
|
||||
|
||||
- 发生 OOM、持续 Swap 抖动、容器反复重启或数据错误;
|
||||
- 错误率持续超过该场景 SLA(初始探索可用 1% 作为警戒线);
|
||||
- p95/p99 持续恶化且负载降低后不能恢复;
|
||||
- CPU 长时间接近满载,或磁盘等待/队列持续增长;
|
||||
- 数据库连接池耗尽、锁等待累积或任务队列只增不减;
|
||||
- 外部 API 进入限流,此时记录为外部边界,不继续推高调用。
|
||||
|
||||
## 单次运行产物
|
||||
|
||||
每次运行必须保存:
|
||||
|
||||
- `benchmark/run-metadata.template.yml` 对应的完整元数据;
|
||||
- 压测脚本版本、开始/结束时间、场景和并发曲线;
|
||||
- 原始请求结果与监控快照(放 `results/raw/`);
|
||||
- 瓶颈分析和客户可读结论(放 `results/reports/`);
|
||||
- 本次结论的适用范围、已知限制和下一步验证。
|
||||
|
||||
@@ -0,0 +1,183 @@
|
||||
# AI SoulMate 本地部署跨电脑交接说明
|
||||
|
||||
## 2026-08-05 本次接管更新
|
||||
|
||||
- 已从用户提供的压缩包恢复部署仓库,确认 Git 分支为 main,但此前没有任何 commit,也没有远端。
|
||||
- 已新增 Ubuntu 22.04 运行手册、源码版本核对说明、Docker 官方仓库安装脚本、随机密钥生成脚本和源码基线采集脚本。
|
||||
- 已新增 PostgreSQL、Redis、MinIO 基础设施 POC Compose;三个宿主机端口只绑定到 127.0.0.1,并带持久化、健康检查、资源上限和日志轮换。
|
||||
- 接管前当前工作区只有另一个指向 Gitee/Spring Boot 的 ai-soulmate-server 本地仓库,不能作为内部 FastAPI 仓库的发布基线。
|
||||
- 已只读核对并浅克隆四个内部远端:server develop6@9a6f7a5、client master@9ebb082、admin main@40bd686、nginx master@6f552f4;server/client 与旧交接基线不同。
|
||||
- server 默认分支使用 Hunyuan3D/Bailian 而不是需求描述的 Tripo,因此发布分支选择仍是业务改造前的阻断项。
|
||||
- 四个仓库存在被 Git 跟踪的真实环境文件,server 还含支付/私钥类值;所有相关凭据必须先轮换,具体值未复制到部署仓库。
|
||||
- 当前 ai-soulmate-server 的 Dockerfile 只有开发目标,开发 Compose 使用源码 bind mount,而且 backend-java/.env 已被源码仓库跟踪;部署前必须审查并轮换其中凭据。
|
||||
- 下一安全动作是在服务器运行 collect-host-facts.sh,完成系统更新和 Docker 安装,然后重新克隆四个源码仓库并生成 source-check 报告。
|
||||
- 首次 Git commit 会在本次接管检查完成后创建;远端仍需用户在 Gitea 建立空的私有仓库后再配置和推送。
|
||||
|
||||
更新时间:2026-08-05
|
||||
|
||||
这份文档用于在另一台电脑继续本地部署适配。它记录事实、已完成事项和下一步顺序;不要把文档中的示例 IP、密码或 API Key 当成生产配置。
|
||||
|
||||
## 一句话状态
|
||||
|
||||
服务器已经可以通过 SSH 访问,但业务系统尚未部署;本地部署 Git 仓库只在当前电脑创建过,尚未建立远端、尚未完成首个提交。换电脑时需要复制或重新建立该仓库。
|
||||
|
||||
## 已确认事实
|
||||
|
||||
### 服务器
|
||||
|
||||
- Ubuntu 22.04.2 LTS,x86_64,内核 5.19.0-32-generic。
|
||||
- 网卡 `enp1s0` 已拿到 `192.168.3.102`,SSH 已成功连接。
|
||||
- `openssh-server` 已安装并可以连接。
|
||||
- `ufw status verbose` 显示 `inactive`,目前没有 UFW 规则阻断 SSH。
|
||||
- 尚未确认 SSH 公钥登录是否完成;尚未关闭密码登录。
|
||||
- 尚未完成系统更新、Docker、Compose、PostgreSQL、Redis、对象存储和网关部署。
|
||||
- 应在路由器或网络设备上为服务器做 DHCP 地址保留,避免重启后 IP 变化。
|
||||
|
||||
### 样机硬件
|
||||
|
||||
- HP ZCentral 4R Workstation。
|
||||
- Intel Xeon W-2225,4 核 8 线程。
|
||||
- 32GiB ECC DDR4,单条内存,约 1TB 单块 Samsung NVMe。
|
||||
- Swap 2GiB,单盘无冗余。
|
||||
- 适合 POC、适配和容量边界测试,不可直接作为生产高可用承诺。
|
||||
|
||||
### 源码版本基线
|
||||
|
||||
| 仓库 | 当前提交 |
|
||||
| --- | --- |
|
||||
| `ai-soulmate-server` | `24769465d3ac2cb840c5266c8c0def2aacb641aa` |
|
||||
| `ai-soulmate-client` | `170847159a787c7b52e3f9f792d72ea67cbd7fa4` |
|
||||
| `mlkj-admin` | `40bd686128010fbbc6c33f6156a7a3cda5336b3a` |
|
||||
| `nginx-server` | `6f552f4b37505ec055cdd179fe9cc5a6825a4189`,仅做过远端检查 |
|
||||
|
||||
完整清单见 [`inventory/source-baselines.yml`](../inventory/source-baselines.yml)。
|
||||
|
||||
## 当前部署目标
|
||||
|
||||
中心服务器先运行:
|
||||
|
||||
```text
|
||||
统一网关 → 平台前端 / AI SoulMate 管理端 → 平台后端
|
||||
├→ PostgreSQL
|
||||
├→ Redis
|
||||
├→ 本地 S3 兼容对象存储
|
||||
└→ Tripo 外部 API
|
||||
```
|
||||
|
||||
后续农场工作站运行 `ai-soulmate-client`,通过 HTTPS 心跳、拉取任务和上报状态,不把打印机直接暴露给中心服务器。
|
||||
|
||||
Tripo 当前仍是外部 API,因此目标是本地化业务平台和数据基础设施,不是当前阶段的完全离线部署。
|
||||
|
||||
## 换电脑时重建 Git 仓库
|
||||
|
||||
### 推荐:复制现有部署目录
|
||||
|
||||
把当前电脑的整个目录复制到新电脑,包含未提交文件但不需要复制 `.git`:
|
||||
|
||||
```text
|
||||
/Users/max/AI SoulMate/开发/ai-soulmate-local-deployment
|
||||
```
|
||||
|
||||
在新电脑进入目录后检查:
|
||||
|
||||
```bash
|
||||
git status
|
||||
git branch --show-current
|
||||
```
|
||||
|
||||
如果没有 `.git`,重新初始化:
|
||||
|
||||
```bash
|
||||
git init -b main
|
||||
```
|
||||
|
||||
### 需要长期留档时
|
||||
|
||||
先在 Gitea 创建一个空的私有仓库,例如 `MLKJ/ai-soulmate-local-deployment`,再在新电脑执行:
|
||||
|
||||
```bash
|
||||
git add .
|
||||
git commit -m "chore: initialize local deployment baseline"
|
||||
git remote add origin <GITEA_REPOSITORY_URL>
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
远端 URL、账号和访问令牌不要写入文档或 `.env`。如果部署目录没有复制过来,必须先恢复本目录中的 `README.md`、`docs/`、`inventory/`、`benchmark/`、`scripts/`、`compose/` 和 `decisions/`,再执行上述提交。
|
||||
|
||||
## 新电脑接管顺序
|
||||
|
||||
### A. 先固定 SSH 访问
|
||||
|
||||
在新电脑生成或准备 SSH 密钥,把公钥加入服务器 `hp` 用户:
|
||||
|
||||
```bash
|
||||
ssh-keygen -t ed25519 -a 64 -f ~/.ssh/id_ed25519_ai_soulmate
|
||||
cat ~/.ssh/id_ed25519_ai_soulmate.pub | ssh hp@192.168.3.102 \
|
||||
'umask 077; mkdir -p ~/.ssh; cat >> ~/.ssh/authorized_keys'
|
||||
```
|
||||
|
||||
确认密钥登录成功后,才考虑关闭密码登录。修改 SSH 配置前保留当前会话,并先用 `sudo sshd -t` 检查配置。
|
||||
|
||||
### B. 记录并更新服务器
|
||||
|
||||
在服务器上执行:
|
||||
|
||||
```bash
|
||||
whoami
|
||||
hostnamectl
|
||||
ip -br addr
|
||||
sudo systemctl is-active ssh
|
||||
df -hT /
|
||||
free -h
|
||||
lscpu
|
||||
|
||||
sudo timedatectl set-timezone Asia/Shanghai
|
||||
sudo apt update
|
||||
sudo apt install -y git curl ca-certificates gnupg jq unzip rsync tmux htop nvme-cli smartmontools
|
||||
sudo apt upgrade -y
|
||||
```
|
||||
|
||||
如果出现 `/var/run/reboot-required`,记录后再重启,并重新确认服务器 IP。
|
||||
|
||||
### C. 安装容器运行时
|
||||
|
||||
使用 Docker 官方 Ubuntu 仓库安装 Docker Engine、Buildx 和 Compose plugin。安装前确认网络、DNS、NTP 和磁盘空间;不要使用来源不明的一键安装脚本。
|
||||
|
||||
安装后至少验证:
|
||||
|
||||
```bash
|
||||
docker version
|
||||
docker compose version
|
||||
sudo systemctl is-active docker
|
||||
```
|
||||
|
||||
### D. 再开始业务改造
|
||||
|
||||
不要直接把当前四个仓库用现有 Compose 上线。必须先完成:
|
||||
|
||||
1. 平台后端和管理端的 OSS provider 抽象,并验证本地 S3 兼容对象存储。
|
||||
2. 管理端 `ai-soulmate-only` 模式,避免强制连接其他业务数据库。
|
||||
3. 生产前端构建和不可变镜像,去除源码 bind mount。
|
||||
4. 初始化/迁移、备份/恢复、健康检查和密钥注入。
|
||||
5. 网关路由、TLS、上传限制和管理入口隔离。
|
||||
|
||||
具体路线见 [`IMPLEMENTATION-ROADMAP.md`](IMPLEMENTATION-ROADMAP.md),压测规则见 [`BENCHMARK-PLAN.md`](BENCHMARK-PLAN.md)。
|
||||
|
||||
## 不要做的事情
|
||||
|
||||
- 不要把 SSH、PostgreSQL、Redis 或对象存储管理端口暴露到公网。
|
||||
- 不要把真实密码、Tripo Key、OSS Key、证书或客户数据提交到 Git。
|
||||
- 不要把 Tripo 的端到端延迟直接当作本地服务器并发能力。
|
||||
- 不要在单盘、32GB POC 样机上直接承诺生产高可用或客户 SLA。
|
||||
- 不要在没有备份恢复演练前导入唯一生产数据。
|
||||
|
||||
## 接管清单
|
||||
|
||||
- [ ] 新电脑已恢复部署仓库目录。
|
||||
- [ ] Git 仓库已初始化并完成首次提交。
|
||||
- [ ] 已创建私有远端并推送 `main`。
|
||||
- [ ] Mac/新电脑使用密钥登录服务器。
|
||||
- [ ] 服务器 IP 已固定或完成 DHCP 保留。
|
||||
- [ ] 已完成系统更新和硬件基线采集。
|
||||
- [ ] 已安装并验证 Docker Compose。
|
||||
- [ ] 已完成 P1/P2 源码改造后再创建正式 Compose。
|
||||
@@ -0,0 +1,110 @@
|
||||
# Ubuntu 22.04 本地部署运行手册
|
||||
|
||||
这台 HP ZCentral 4R 是 POC 和适配样机。当前目标是跑通中心服务、管理端、PostgreSQL、Redis、本地对象存储和 Tripo 出站调用;它不是生产高可用承诺。
|
||||
|
||||
## 0. 先确认网络和 SSH
|
||||
|
||||
在服务器本地控制台或当前 SSH 会话记录:
|
||||
|
||||
~~~bash
|
||||
hostnamectl
|
||||
nmcli device status
|
||||
ip -br addr
|
||||
sudo systemctl is-active ssh
|
||||
df -hT /
|
||||
free -h
|
||||
~~~
|
||||
|
||||
在路由器上为有线网卡做 DHCP reservation,或者使用网络管理员批准的静态地址。不要凭 enp1s0、eno1 这样的示例名修改连接。保留当前密码 SSH 会话,直到另一台电脑用 Ed25519 密钥成功登录。
|
||||
|
||||
## 1. 固化主机基线
|
||||
|
||||
~~~bash
|
||||
cd /srv/ai-soulmate-local-deployment
|
||||
chmod +x scripts/*.sh
|
||||
./scripts/collect-host-facts.sh \
|
||||
> results/raw/host-facts-$(date +%Y%m%d-%H%M%S).txt
|
||||
~~~
|
||||
|
||||
原始文件默认不进 Git。审阅后只把脱敏结论写入 results/reports/,不要记录 IP、MAC、序列号、UUID 或客户数据。
|
||||
|
||||
## 2. 安装 Docker 和工具
|
||||
|
||||
~~~bash
|
||||
cd /srv/ai-soulmate-local-deployment
|
||||
sudo TIMEZONE_NAME=Asia/Shanghai RUN_UPGRADE=1 \
|
||||
./scripts/bootstrap-ubuntu-22.04.sh
|
||||
~~~
|
||||
|
||||
脚本使用 Docker 官方 apt 仓库,不修改网络地址、不自动打开防火墙端口,也不会替代现场重启决策。若出现 /var/run/reboot-required,先记下结果,再重启并重新确认 IP、SSH、磁盘和 Docker。
|
||||
|
||||
## 3. 放置并核对源码
|
||||
|
||||
源码与部署仓库分开,例如:
|
||||
|
||||
~~~bash
|
||||
sudo mkdir -p /srv/ai-soulmate/sources
|
||||
sudo chown -R "$USER":"$USER" /srv/ai-soulmate
|
||||
cd /srv/ai-soulmate/sources
|
||||
git clone http://39.106.119.229:3000/MLKJ/ai-soulmate-server
|
||||
git clone http://39.106.119.229:3000/MLKJ/ai-soulmate-client
|
||||
git clone http://39.106.119.229:3000/MLKJ/mlkj-admin
|
||||
git clone http://39.106.119.229:3000/MLKJ/nginx-server
|
||||
~~~
|
||||
|
||||
如果仓库已经存在,不要直接覆盖用户改动;逐个执行 git status --short、git remote -v 和 git rev-parse HEAD。完成后生成核对报告:
|
||||
|
||||
截至 2026-08-05,server 默认分支是 develop6,但其 AI provider 与需求描述不一致;client 的旧交接 SHA 也不是默认分支 HEAD。克隆完成不代表发布分支已经选定,必须由仓库负责人确认 release branch/tag 后再继续。
|
||||
|
||||
~~~bash
|
||||
cd /srv/ai-soulmate-local-deployment
|
||||
SOURCE_ROOT=/srv/ai-soulmate/sources \
|
||||
./scripts/record-source-baseline.sh \
|
||||
> inventory/source-check-$(date +%F-%H%M%S).yml
|
||||
~~~
|
||||
|
||||
## 4. 先启动基础设施
|
||||
|
||||
~~~bash
|
||||
cd /srv/ai-soulmate-local-deployment
|
||||
./scripts/create-local-env.sh compose/.env
|
||||
docker compose --env-file compose/.env \
|
||||
-f compose/docker-compose.infra.yml config
|
||||
docker compose --env-file compose/.env \
|
||||
-f compose/docker-compose.infra.yml pull
|
||||
docker compose --env-file compose/.env \
|
||||
-f compose/docker-compose.infra.yml up -d
|
||||
docker compose --env-file compose/.env \
|
||||
-f compose/docker-compose.infra.yml ps
|
||||
./scripts/verify-infra.sh compose/.env
|
||||
~~~
|
||||
|
||||
PostgreSQL、Redis 和 MinIO 只绑定到 127.0.0.1。未来业务容器使用 postgres:5432、redis:6379 和 minio:9000,不要把 .env 中的宿主机端口当作容器间地址。MinIO 控制台需要时使用 SSH 隧道,不开放公网管理端口。
|
||||
|
||||
## 5. 业务部署门槛
|
||||
|
||||
当前 ai-soulmate-server 的 Dockerfile 只有开发目标,开发 Compose 还挂载源码;压缩包中的 ai-soulmate-server-master 没有可验证的 Git 历史。先完成以下改造,再写应用 Compose:
|
||||
|
||||
1. 平台和管理端引入统一对象存储接口,同时保留 Alibaba OSS provider,并让 MinIO 等本地 S3 provider 通过预签名上传、下载、分片、CORS、权限、元数据和恢复测试。
|
||||
2. mlkj-admin 增加 AI SoulMate-only profile,不能初始化无关业务库、默认账号或固定密码。
|
||||
3. 为后端、平台前端和管理端生成生产镜像;禁止源码 bind mount,固定基础镜像版本并记录 digest。
|
||||
4. 添加迁移、健康检查、资源上限、日志轮换、备份恢复和回滚流程。
|
||||
5. 再决定是否使用 nginx-server。它只承担环境无关的 TLS、路由、上传限制、访问日志和限流;若现场已有企业网关,优先复用企业网关。
|
||||
|
||||
## 6. 验收顺序
|
||||
|
||||
按 S01 到 S07 的场景逐级验收:健康检查和登录 → 管理端查询 → 对象上传下载 → 任务创建与轮询 → Tripo 出站 → 混合负载 → 工作站任务下发。Tripo 的提交、轮询、下载、外部排队和限流时间必须单独记录,不能作为本地并发能力。
|
||||
|
||||
每次压测使用固定数据集和请求比例,从并发 1, 2, 5, 10, 15, 20... 逐级增加;每个稳定档位至少重复三次,保存元数据、脱敏报告和原始日志位置。出现 OOM、持续 swap、容器重启、数据错误、队列增长或外部 API 限流时停止加压。
|
||||
|
||||
## 7. Git 留档
|
||||
|
||||
~~~bash
|
||||
cd /srv/ai-soulmate-local-deployment
|
||||
git add .
|
||||
git commit -m "chore: initialize local deployment baseline"
|
||||
git remote add origin <GITEA_REPOSITORY_URL>
|
||||
git push -u origin main
|
||||
~~~
|
||||
|
||||
远端仓库需要先在 Gitea 创建为空的私有仓库。不要把账号密码、访问令牌或真实 .env 写进 URL、文档或 Git;当前部署仓库只有在产生首个 commit 后才算完成留档。
|
||||
@@ -0,0 +1,67 @@
|
||||
# 本地部署改造路线
|
||||
|
||||
## P0:冻结基线
|
||||
|
||||
- [x] 记录现有三个源码仓库提交。
|
||||
- [x] 记录样机 CPU、内存、磁盘、操作系统和网络状态。
|
||||
- [ ] 为四个源码仓库建立本地部署开发分支和对应需求清单。
|
||||
- [ ] 确认数据库版本、现有数据量、OSS 对象量和允许停机窗口。
|
||||
|
||||
验收:任何一次测试都能关联到硬件、源码、配置和数据集版本。
|
||||
|
||||
## P1:平台后端与对象存储解耦
|
||||
|
||||
- [ ] 将阿里 OSS 调用收敛为对象存储接口。
|
||||
- [ ] 实现 Alibaba OSS 与本地 S3 兼容存储两个 provider。
|
||||
- [ ] 验证预签名上传/下载、分片上传、CORS、文件元数据和清理任务。
|
||||
- [ ] 将 Tripo 封装为 provider,保留外部 API,并为未来私有端点预留配置。
|
||||
- [ ] 移除生产 Compose 中的源码 bind mount,构建不可变镜像。
|
||||
|
||||
验收:切换存储 provider 不需要修改业务代码;对象迁移后原有 URL 使用场景可回归。
|
||||
|
||||
## P2:管理端 AI-only 模式
|
||||
|
||||
- [ ] 增加 `ai-soulmate-only` 配置或 profile。
|
||||
- [ ] 非 AI SoulMate 数据源和模块在该模式下不初始化。
|
||||
- [ ] 管理端对象存储改用同一 provider/兼容接口。
|
||||
- [ ] 清理默认账号、测试数据和固定密码。
|
||||
|
||||
验收:只配置 AI SoulMate 数据库即可启动管理端并完成核心管理功能。
|
||||
|
||||
## P3:可交付单机编排
|
||||
|
||||
- [ ] 编排网关、前后端、管理端、PostgreSQL、Redis 和对象存储。
|
||||
- [ ] 所有镜像固定版本或 digest,服务带健康检查与资源限制。
|
||||
- [ ] 提供初始化、升级、回滚、备份、恢复和日志收集脚本。
|
||||
- [ ] 将持久化目录与容器生命周期分离,定义磁盘容量告警。
|
||||
- [ ] 默认只开放 `22`(受限管理)和 `443`(业务)端口。
|
||||
|
||||
验收:在干净 Ubuntu 22.04 主机上按文档可重复安装、重启和恢复。
|
||||
|
||||
## P4:样机 POC
|
||||
|
||||
- [ ] 激活有线网络并分配固定地址,校准 NTP,验证 DNS 与 Tripo 出站访问。
|
||||
- [ ] 导入脱敏数据库和对象样本,执行数据库迁移。
|
||||
- [ ] 回归登录、模型生成、上传下载、订单/任务和管理端流程。
|
||||
- [ ] 完成一次备份恢复演练和宿主机重启演练。
|
||||
|
||||
验收:核心业务链路跑通,重启无数据丢失,备份能够在空环境恢复。
|
||||
|
||||
## P5:农场工作站接入
|
||||
|
||||
- [ ] 将前端改为生产构建,不使用 Vite 开发服务器。
|
||||
- [ ] 每台设备使用独立身份和可撤销凭证,替换全局客户端令牌。
|
||||
- [ ] 实现任务幂等、断线续传、失败重试和本地队列上限。
|
||||
- [ ] 验证 Moonraker/打印机协议、升级和远程诊断。
|
||||
|
||||
验收:中心短暂断网后任务不重复、不丢失,恢复后状态最终一致。
|
||||
|
||||
## P6:容量测试与客户档位
|
||||
|
||||
- [ ] 先测本地只读、写入、文件和混合负载。
|
||||
- [ ] 再测包含 Tripo 的端到端链路,并剥离外部等待时间。
|
||||
- [ ] 分别测试当前 32GB 和内存升级后的配置。
|
||||
- [ ] 将稳定并发、瓶颈、资源余量和推荐参数写入版本化报告。
|
||||
|
||||
验收:每个客户硬件档位都由可复现的测试数据支撑,并明确适用业务模型与 SLA。
|
||||
|
||||
@@ -0,0 +1,51 @@
|
||||
# POC 样机硬件基线
|
||||
|
||||
基线日期:2026-08-05。数据来自现场命令截图;首次联网部署前应运行 `scripts/collect-host-facts.sh` 生成机器可读基线并复核。
|
||||
|
||||
## 已确认配置
|
||||
|
||||
| 项目 | 当前配置 |
|
||||
| --- | --- |
|
||||
| 设备 | HP ZCentral 4R Workstation |
|
||||
| 操作系统 | Ubuntu 22.04.2 LTS |
|
||||
| 内核/架构 | Linux 5.19.0-32-generic,x86_64 |
|
||||
| CPU | Intel Xeon W-2225,4 核 8 线程,单路,最高约 4.6GHz |
|
||||
| NUMA | 1 个节点 |
|
||||
| 内存 | 32GiB ECC DDR4,单条,标称 3200 MT/s,配置 2933 MT/s |
|
||||
| Swap | 2GiB |
|
||||
| 磁盘 | 单块约 1TB Samsung NVMe,根分区 ext4 |
|
||||
| 可用空间 | 根分区约 882GiB 可用(截图时) |
|
||||
| 网络 | `enp1s0` 与 `eno1` 均为 DOWN,尚未形成网络基线 |
|
||||
|
||||
为避免泄露现场资产信息,本仓库不记录主机序列号、UUID、磁盘序列号、MAC 地址和真实 IP。
|
||||
|
||||
## 适用范围
|
||||
|
||||
这台机器适合:
|
||||
|
||||
- 单机容器化适配与功能回归;
|
||||
- PostgreSQL、Redis、对象存储和业务服务共机时的容量边界测试;
|
||||
- 识别 CPU、内存、磁盘和外部 API 的首个瓶颈;
|
||||
- 为后续不同硬件档位建立对照基线。
|
||||
|
||||
它不代表生产高可用能力:只有一块系统/数据盘,任一磁盘故障都会影响全部服务;4 核 CPU 也会让数据库、对象存储与应用争抢资源。
|
||||
|
||||
## 部署前动作
|
||||
|
||||
1. 接通有线网络,确定固定 IP、DNS、NTP、默认路由和 Tripo 所需出站策略。
|
||||
2. 更新 Ubuntu 22.04 安全补丁,记录 BIOS、内核与 Docker 版本。
|
||||
3. 确认 NVMe SMART/健康状态;生产方案必须设计独立数据盘、备份目标或冗余。
|
||||
4. 将 Swap 调整视为防 OOM 保护而非可用内存,压测报告必须记录 swap in/out。
|
||||
5. 若条件允许,增加同规格 ECC 内存至 64GB,再做一组对照测试;不要把升级后的结论套用到 32GB 配置。
|
||||
6. 压测期间关闭无关桌面应用,固定电源/性能策略,并记录所有参数变化。
|
||||
|
||||
## 当前风险
|
||||
|
||||
| 风险 | 对测试的影响 | 处理方式 |
|
||||
| --- | --- | --- |
|
||||
| 单块 NVMe | 数据库、对象存储、日志相互争抢 I/O | 监测磁盘延迟和利用率;容量报告明确单盘条件 |
|
||||
| 单条 32GB 内存 | 内存容量和带宽可能先成为瓶颈 | 记录内存/Swap;增加 64GB 对照组 |
|
||||
| 4 核 8 线程 | 共机服务容易发生 CPU 争用 | 设置容器资源上限并逐级加压 |
|
||||
| 网卡未启用 | 无法验证局域网和 Tripo 端到端链路 | 部署前先完成网络基线与出站测试 |
|
||||
| 无冗余 | 不适合据此宣称生产可用性 | 将 POC 容量与生产可靠性方案分开 |
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
# 安全与发布阻断项
|
||||
|
||||
## P0:凭据轮换
|
||||
|
||||
四个远端仓库的当前检出版本中存在被 Git 跟踪的非示例 .env 或 .env.server。ai-soulmate-server 的 Compose 还包含真实或疑似真实的支付密钥、私钥和固定数据库密码。
|
||||
|
||||
这些值必须视为已泄露:
|
||||
|
||||
1. 先在支付、短信、邮件、数据库、Redis、对象存储、JWT 和外部 AI 服务侧轮换或撤销。
|
||||
2. 从当前源码和后续镜像中移除真实值,只保留变量名与安全示例。
|
||||
3. 检查 Git 历史和镜像层;历史清理需要团队协调,不能在共享仓库上直接强推。
|
||||
4. 用服务器本地 0600 权限的 .env、Docker secrets 或客户密钥系统注入。
|
||||
|
||||
部署仓库不保存任何发现到的真实值。
|
||||
|
||||
## P0:选择发布基线
|
||||
|
||||
ai-soulmate-server 默认分支 develop6 的 3D 集成是 Hunyuan3D/Bailian,不是用户描述的 Tripo;旧交接 SHA 也不是任何远端分支的当前 tip。ai-soulmate-client 的旧交接 SHA 位于 fix/client-login-403,而默认 master 已前进。
|
||||
|
||||
在用户或仓库负责人明确 server/client 的发布分支或 tag 前,不开始业务代码改造,也不生成应用镜像。选择后应创建 local-deployment 分支并把 SHA 写入 inventory。
|
||||
|
||||
## P1:开发配置不能上线
|
||||
|
||||
- server 使用 Uvicorn reload、Vite 开发服务器、源码 bind mount、latest 镜像和对外数据库/Redis 端口。
|
||||
- client 前端仍使用 Vite 开发服务器和源码 bind mount,数据库使用固定密码并对宿主机开放。
|
||||
- admin 同时强依赖四个数据源,尚未验证 AI SoulMate-only 模式。
|
||||
- nginx 绑定现有公网域名、证书路径和固定 upstream,不能直接交付给内网客户。
|
||||
|
||||
应用 Compose 必须等到生产镜像、最小权限、健康检查、资源上限、迁移、备份恢复、端口收敛和凭据注入全部完成。
|
||||
@@ -0,0 +1,38 @@
|
||||
# 源码版本核对
|
||||
|
||||
## 为什么要重新核对
|
||||
|
||||
压缩包中的 inventory/source-baselines.yml 记录了上一台电脑看到的四个提交。只读远端核对后,server 默认分支是 develop6@9a6f7a5,client 默认分支是 master@9ebb082;两者均与旧记录不同。admin 和 nginx 与旧记录一致。另一个本地 ai-soulmate-server 目录指向不同的 Gitee/Spring Boot 代码库,不能与内部 FastAPI 仓库混用。
|
||||
|
||||
因此,当前状态是“交接资料已恢复,源码基线尚未复核”,不是“源码已经可以部署”。
|
||||
|
||||
server 默认分支还使用 Hunyuan3D/Bailian,而用户描述的是 Tripo。必须先由仓库负责人明确 server/client 的发布分支或 tag,再创建本地部署适配分支;默认分支不能自动视为发布版本。
|
||||
|
||||
## 在服务器上复核
|
||||
|
||||
把四个源码仓库放在同一个目录,例如 /srv/ai-soulmate/sources,然后执行:
|
||||
|
||||
~~~bash
|
||||
cd /srv/ai-soulmate-local-deployment
|
||||
SOURCE_ROOT=/srv/ai-soulmate/sources \
|
||||
./scripts/record-source-baseline.sh \
|
||||
> inventory/source-check-$(date +%F-%H%M%S).yml
|
||||
~~~
|
||||
|
||||
提交前检查:
|
||||
|
||||
~~~bash
|
||||
git diff -- inventory/source-check-*.yml
|
||||
git status --short
|
||||
~~~
|
||||
|
||||
报告可以提交,但真实 .env、Token、证书、用户数据和原始日志不能提交。脚本会标记仓库是否跟踪任何非示例 .env 文件;一旦为 true,先审查历史并轮换凭据,再做远端推送。
|
||||
|
||||
## 当前四个仓库的边界
|
||||
|
||||
| 仓库 | 当前行动 |
|
||||
| --- | --- |
|
||||
| ai-soulmate-server | 先完成本地 PostgreSQL、Redis、S3 provider 和生产镜像适配 |
|
||||
| ai-soulmate-client | 后续放到靠近打印机的工作站,先做设备凭证、离线队列和幂等重试 |
|
||||
| mlkj-admin | 只启用 AI SoulMate 数据源和模块,移除无关初始化与默认账号 |
|
||||
| nginx-server | 只参考网关职责,不直接复制公网域名和路由;应用镜像完成后再决定是否使用 |
|
||||
Reference in new issue
Block a user