81632c1b35
- 添加架构文档 (ARCHITECTURE.md) - 添加 API 文档 (API.md) - 添加文档索引 (docs/README.md) - 添加部署技能 (skills/city-manual-deploy/SKILL.md) - 添加测试技能 (skills/city-manual-test/SKILL.md) - 添加内容管理技能 (skills/city-manual-content/SKILL.md)
3.0 KiB
3.0 KiB
Skill: city-manual-deploy
Description
城市手册项目部署技能。用于自动化部署城市手册项目到生产环境。
Location
/root/.openclaw/workspace/city-manual/skills/city-manual-deploy/
Capabilities
- 检查部署环境
- 配置 Nginx 反向代理
- 启动 Gunicorn 服务
- 数据库迁移
- 静态文件收集
- 服务健康检查
Usage
当用户提到以下关键词时激活此技能：
- "部署城市手册"
- "deploy city manual"
- "上线项目"
- "生产环境配置"
Scripts
deploy.sh
#!/bin/bash
# 城市手册部署脚本
set -e
PROJECT_DIR="/root/.openclaw/workspace/city-manual"
VENV_DIR="$PROJECT_DIR/backend/venv"
GUNICORN_SOCKET="$PROJECT_DIR/gunicorn.sock"
GUNICORN_LOG="$PROJECT_DIR/gunicorn.log"
echo "=== 城市手册部署开始 ==="
# 1. 激活虚拟环境
source $VENV_DIR/bin/activate
# 2. 数据库迁移
cd $PROJECT_DIR/backend
python manage.py migrate
# 3. 收集静态文件
python manage.py collectstatic --noinput
# 4. 重启 Gunicorn
pkill -f gunicorn || true
sleep 2
cd $PROJECT_DIR
./gunicorn_start.sh
# 5. 检查服务状态
sleep 3
if pgrep -f gunicorn > /dev/null; then
echo "✅ Gunicorn 启动成功"
else
echo "❌ Gunicorn 启动失败"
exit 1
fi
# 6. Nginx 配置检查
nginx -t
if [ $? -eq 0 ]; then
systemctl reload nginx
echo "✅ Nginx 重载成功"
else
echo "❌ Nginx 配置错误"
exit 1
fi
echo "=== 部署完成 ==="
Configuration
环境变量
# .env 文件
DJANGO_SETTINGS_MODULE=config.settings.production
DJANGO_SECRET_KEY=your-secret-key
DATABASE_URL=postgres://user:pass@localhost:5432/cssc
ALLOWED_HOSTS=cssc.datalibstar.com,127.0.0.1
DEBUG=False
Nginx 配置
server {
listen 80;
server_name cssc.datalibstar.com;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
location /static/ {
alias /root/.openclaw/workspace/city-manual/backend/static/;
}
location /media/ {
alias /root/.openclaw/workspace/city-manual/backend/media/;
}
}
Health Check
# 检查 Gunicorn
curl http://127.0.0.1:8000/admin/
# 检查数据库
psql -h localhost -U coder -d cssc -c "SELECT 1"
# 检查 Nginx
curl http://cssc.datalibstar.com/
Troubleshooting
Gunicorn 启动失败
- 检查端口占用：
lsof -i :8000 - 查看日志：
tail -f gunicorn.log - 检查虚拟环境：
source backend/venv/bin/activate
数据库连接失败
- 检查 PostgreSQL 服务：
systemctl status postgresql - 验证连接：
psql -h localhost -U coder -d cssc - 检查 .env 配置
静态文件 404
- 重新收集：
python manage.py collectstatic --noinput - 检查 Nginx 配置路径
- 重载 Nginx：
systemctl reload nginx