# `deploy/`

| 文件 | 用途 |
| --- | --- |
| `docker-compose.dev.yml` | 本地开发栈：PostgreSQL 16 + pgvector、Redis 7（均带 healthcheck） |
| `Dockerfile.api` | API 镜像（gunicorn + uvicorn worker） |
| `Dockerfile.worker` | Celery worker 镜像（队列由 `CELERY_QUEUES` 注入） |

```bash
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）。