回滚与运行手册

# 查看可用版本
docker images | grep app

# 回滚到上一稳定版本
cd /opt/app
export APP_VERSION=v1.2.3  # 上一稳定版本 tag
docker compose pull
docker compose up -d --no-deps app celery

# 验证
sleep 10
curl -sf http://localhost:8000/health || echo "ROLLBACK FAILED"

cd /opt/app

# 查看最近 tag
git tag --sort=-creatordate | head -5

# 回滚到上一 tag
git checkout v1.2.3

# 重装依赖（如有变更）
pip install -r requirements/prod.txt

# 重启服务
sudo systemctl restart app celery

# 查看当前迁移状态
python manage.py showmigrations

# 备份数据库
pg_dump -U app app_db > /backup/app_db_$(date +%Y%m%d_%H%M%S).sql

# 回滚到指定迁移（Django）
python manage.py migrate app_name 0005_previous_migration

# 回滚全部迁移（极端情况）
python manage.py migrate app_name zero

## 事故报告 - YYYY-MM-DD

**影响时间**：HH:MM ~ HH:MM（共 X 分钟）
**影响范围**：[描述受影响的功能/用户群]
**根因**：[简述根本原因]
**回滚版本**：v1.2.3 → v1.2.2
**处理过程**：
1. HH:MM 发现异常
2. HH:MM 确认需要回滚
3. HH:MM 执行回滚
4. HH:MM 验证恢复
**后续改进**：[防止复发的措施]

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows

# 安装依赖
pip install -r requirements/prod.txt

# 验证安装
python -c "import sys; print(sys.version)"
pip check  # 检查依赖冲突

# .env 文件（禁止提交到版本控制）
DATABASE_URL=postgresql://user:pass@localhost:5432/app_db
REDIS_URL=redis://localhost:6379/0
SECRET_KEY=your-256-bit-secret-key
DEBUG=false
ALLOWED_HOSTS=example.com,www.example.com
SENTRY_DSN=https://xxx@sentry.io/xxx

# 启动开发服务器（Django）
python manage.py runserver 0.0.0.0:8000

# 启动开发服务器（FastAPI）
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# 启动 Celery Worker
celery -A tasks worker --loglevel=info --concurrency=4

# 启动 Celery Beat（定时任务）
celery -A tasks beat --loglevel=info

# 启动应用（WSGI）
gunicorn app.wsgi:application \
  --workers 4 \
  --worker-class gthread \
  --threads 2 \
  --bind 0.0.0.0:8000 \
  --timeout 120 \
  --access-logfile /var/log/app/access.log \
  --error-logfile /var/log/app/error.log

# 启动应用（ASGI - FastAPI）
gunicorn app.main:app \
  --workers 4 \
  --worker-class uvicorn.workers.UvicornWorker \
  --bind 0.0.0.0:8000

# 优雅重启（不中断连接）
kill -HUP $(cat /var/run/app/gunicorn.pid)

# 优雅停止
kill -TERM $(cat /var/run/app/gunicorn.pid)

# /etc/systemd/system/app.service
[Unit]
Description=Python Web Application
After=network.target postgresql.service redis.service

[Service]
User=www-data
Group=www-data
WorkingDirectory=/opt/app
Environment="PATH=/opt/app/.venv/bin"
ExecStart=/opt/app/.venv/bin/gunicorn app.wsgi:application --workers 4 --bind 127.0.0.1:8000
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable app
sudo systemctl start app
sudo systemctl status app

# 应用存活检查
curl -s http://localhost:8000/health | python -m json.tool

# 数据库连接检查
python -c "
import psycopg2
conn = psycopg2.connect('dbname=app_db user=app')
cur = conn.cursor()
cur.execute('SELECT 1')
print('DB OK:', cur.fetchone())
conn.close()
"

# Redis 连接检查
redis-cli ping  # 应返回 PONG

# Celery Worker 状态
celery -A tasks inspect ping

# 磁盘空间
df -h /var/log /opt/app

# 内存使用
free -h
ps aux --sort=-%mem | head -10

# 查看最近错误
tail -100 /var/log/app/error.log | grep -i "error\|traceback"

# 实时跟踪
tail -f /var/log/app/access.log

# 按时间范围查询
awk '/2026-07-31 10:00/,/2026-07-31 11:00/' /var/log/app/error.log

# 统计 5xx 错误
grep " 5[0-9][0-9] " /var/log/app/access.log | wc -l