# 自动部署功能快速参考

## 快速开始

### 1. 安装依赖
```bash
pip install paramiko
# 或使用安装脚本
python scripts/install_deploy_deps.py
```

### 2. 测试连接
```bash
python scripts/auto_execute_tasks.py --test-connection
```

### 3. 启动自动部署
```bash
python scripts/auto_execute_tasks.py --chat-loop --use-agent
```

## 常用命令

| 命令 | 说明 |
|------|------|
| `--test-connection` | 测试 SSH 连接 |
| `--deploy-now 123` | 部署指定任务 ID |
| `--no-deploy` | 禁用自动部署 |
| `--chat-loop --use-agent` | Agent 循环模式（自动部署） |
| `--agent-run` | 单次 Agent 运行（自动部署） |
| `--once` | 单次任务检查（自动部署） |

## 生产服务器信息

- **地址**: 192.168.3.143:22
- **用户**: ubuntu
- **脚本路径**: `/opt/dataops-platform/datafactory/scripts`
- **工作流路径**: `/opt/dataops-platform/n8n/workflows`

## 部署流程

```
任务完成 → 同步数据库 → 上传脚本 → 上传工作流 → 设置权限 → 完成
```

## 故障排查

| 问题 | 解决方案 |
|------|---------|
| SSH 连接失败 | 检查网络、防火墙、SSH 服务 |
| 认证失败 | 验证用户名密码 |
| 权限不足 | 检查目录权限 |
| paramiko 未安装 | `pip install paramiko` |
| 文件未找到 | 检查 code_path 和 code_name |

## 配置位置

文件：`scripts/auto_execute_tasks.py`

```python
PRODUCTION_SERVER = {
    "host": "192.168.3.143",
    "port": 22,
    "username": "ubuntu",
    "password": "citumxl2357",
    "script_path": "/opt/dataops-platform/datafactory/scripts",
    "workflow_path": "/opt/dataops-platform/n8n/workflows",
}
```

## 日志示例

成功部署：
```
🚀 开始自动部署任务: 销售数据生成脚本
📦 部署 Python 脚本: datafactory/scripts/sales_data_generator.py
✅ 脚本部署成功
📦 发现 1 个工作流文件
✅ 工作流部署成功
✅ 任务部署完成
```

## 更多信息

详细文档：[auto_deploy_guide.md](./auto_deploy_guide.md)
