xsl
8a4720472b
docker-compose brings up PostgreSQL 16 with pgvector and Redis 7 on non-standard host ports so it never collides with an existing local database. scripts/smoke.sh is the proof: compose, migrate, boot the API, issue a token, call the real DeepSeek API and print the resulting ob_ai_call and bl_ledger rows. services/vision and services/matting are placeholders noting that the local RTX 5090 makes BiRefNet and RTMPose developable without cloud GPU.
deploy/
| 文件 | 用途 |
|---|---|
docker-compose.dev.yml |
本地开发栈：PostgreSQL 16 + pgvector、Redis 7（均带 healthcheck） |
Dockerfile.api |
API 镜像（gunicorn + uvicorn worker） |
Dockerfile.worker |
Celery worker 镜像（队列由 CELERY_QUEUES 注入） |
make up # 只起 postgres + redis
make down
docker compose -f deploy/docker-compose.dev.yml --profile app up -d # 连 api/worker 一起
本地端口刻意用 55432 / 56379，避免和开发机上已有的 PG/Redis 撞车。
V1 生产形态（架构 §14.1）
单可用区 + Docker Compose，不上 K8s（TD-03、团队规模）：
CLB → CVM-app: nginx / api / admin / worker-cpu / worker-io / beat / vision-svc
CVM-gpu（按需启停）: tryon-svc / worker-gpu / matting
云数据库 PostgreSQL(pgvector) · 云数据库 Redis · COS×4 + CDN · CLS
GPU 实例按需启停是 V1 最有效的成本手段：队列有积压时拉起，空闲一段时间后 释放（NFR-COST-04）。
规矩
- 镜像里不许有密钥（架构 §11.2）。配置一律从环境变量注入，生产走 SSM/KMS。
env_file: ../.env只在本地 compose 用。 - 数据库迁移是发布流程里的独立步骤，先迁移后发布（§14.3）。
- 镜像打标签化版本，不要用
latest发布。 - 容器以非 root 用户运行，两个 Dockerfile 都已如此。
还没有的东西
nginx 配置、TLS 终止、CLB/CDN 配置、COS 四桶的生命周期策略（临时桶 ≤ 2 小时， CR-02）、Grafana 三张看板、告警规则、备份与恢复演练脚本（FR-SYS-09）。