social-app/docs/runtime/runtime-runbook.md

Runtime Runbook

Date: 2026-02-25
Status: Active

开发环境启动

一键启动

# 1. 首次或 schema 变更后，执行 bootstrap
docker compose --env-file .env -f infra/docker/docker-compose.yml run --rm init-job bootstrap

# 2. 日常启动服务（tmux）
bash infra/scripts/app-up.sh

# 查看 tmux 窗口
tmux list-windows -t social-dev

# 进入会话观察日志
tmux attach -t social-dev

tmux 会话管理

# 杀掉会话（停止 web/workers）
tmux kill-session -t social-dev

日志文件

每个服务自动生成独立日志文件：

服务	日志文件
Web	logs/web.log, logs/web.error.log
Worker Critical	logs/worker-critical.log, logs/worker-critical.error.log
Worker Default	logs/worker-default.log, logs/worker-default.error.log
Worker Bulk	logs/worker-bulk.log, logs/worker-bulk.error.log

---

生产环境启动

TODO: 待补充

# TBD

---

服务说明

服务	说明
redis	缓存与 Celery broker
supabase-*	认证与数据库相关服务
init-job	数据库迁移和初始化（一次性）
web	Web 服务 (gunicorn)
worker-*	Celery worker (3 个队列)

配置说明

Web 服务器配置

环境变量	说明	默认值
SOCIAL_WEB__HOST	监听地址	0.0.0.0
SOCIAL_WEB__PORT	监听端口	8000
SOCIAL_WEB__GUNICORN__WORKERS	Gunicorn 工作进程数	2
SOCIAL_WEB__GUNICORN__WORKER_CLASS	Gunicorn worker 类	uvicorn.workers.UvicornWorker
SOCIAL_WEB__GUNICORN__TIMEOUT	请求超时秒数	60

Celery 队列路由

任务前缀	队列
tasks.critical.*	critical
tasks.bulk.*	bulk
其他	default

---

变更日志

日期	变更
2026-02-25	简化启动方式：dev-app-up → app-up，分离 bootstrap 与服务启动