101 lines
1.7 KiB
Markdown
101 lines
1.7 KiB
Markdown
# Docker 启动与部署说明
|
|
|
|
## 固定入口
|
|
|
|
本项目固定使用 Docker Compose 项目名 `hot-comments-tool`，服务入口固定为：
|
|
|
|
```bash
|
|
http://localhost:8000
|
|
```
|
|
|
|
启动或重建：
|
|
|
|
```bash
|
|
docker compose up -d --build
|
|
curl -f http://localhost:8000/health
|
|
```
|
|
|
|
查看容器：
|
|
|
|
```bash
|
|
docker compose ps
|
|
```
|
|
|
|
正常情况下只需要看到一个应用容器：`hot-comments-tool-app-1`。
|
|
|
|
## 端口占用排查
|
|
|
|
如果 `8000` 被占用，先确认是不是本项目容器：
|
|
|
|
```bash
|
|
lsof -nP -iTCP:8000 -sTCP:LISTEN
|
|
docker compose ps
|
|
```
|
|
|
|
如果是旧的同项目容器，执行：
|
|
|
|
```bash
|
|
docker compose down
|
|
docker compose up -d --build
|
|
```
|
|
|
|
不要临时改到 `8001`，否则浏览器验收和文档记录会混乱。
|
|
|
|
## 环境变量
|
|
|
|
Docker Compose 读取 `.env`，不要把真实 `.env` 提交到 Git。
|
|
|
|
首次启动前可以从示例文件复制：
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
必须配置：
|
|
|
|
```text
|
|
TIKHUB_API_KEY=
|
|
AI_BASE_URL=
|
|
AI_API_KEY=
|
|
AI_MODEL=
|
|
```
|
|
|
|
## 数据目录
|
|
|
|
SQLite 数据固定挂载整个目录：
|
|
|
|
```yaml
|
|
./data:/app/data
|
|
```
|
|
|
|
不要只挂载单个 `app.db` 文件。SQLite WAL 模式会生成：
|
|
|
|
```text
|
|
data/app.db
|
|
data/app.db-wal
|
|
data/app.db-shm
|
|
```
|
|
|
|
这三个文件必须在同一个挂载目录内。
|
|
|
|
## 重置本地验收数据库
|
|
|
|
仅在确认不需要保留历史任务后执行：
|
|
|
|
```bash
|
|
docker compose down
|
|
rm -f data/app.db data/app.db-wal data/app.db-shm
|
|
docker compose up -d --build
|
|
curl -f http://localhost:8000/health
|
|
```
|
|
|
|
重置后历史任务会消失，首页任务列表会从空状态开始。
|
|
|
|
## 验收命令
|
|
|
|
```bash
|
|
.venv/bin/python -m pytest tests/unit tests/integration -q
|
|
docker compose up -d --build
|
|
curl -f http://localhost:8000/health
|
|
```
|