signalscout-backend/docs/deployment.md

SignalScout 部署

SignalScout 使用和 agent-desk 一致的 Gitea + Jenkins 发布链路。

服务器路径

• Gitea 仓库：gitadmin/signalscout-backend
• Jenkins Job：signalscout-backend
• 源码目录：/opt/signalscout-source
• 发布目录：/opt/signalscout
• systemd 服务：signalscout
• 本机监听：127.0.0.1:8020
• 线上域名：https://signalscout.jaycode.online

流水线

Jenkins 从 Gitea 仓库读取根目录 Jenkinsfile，然后通过已有凭据 SSH 到服务器执行：

deployment/jenkins/deploy_backend.sh

脚本负责：

• 从 Gitea 拉取 main 分支
• 创建测试虚拟环境
• 执行 ruff 和 pytest
• 生成发布目录
• 执行 Alembic 迁移和主题种子初始化
• 重启 signalscout systemd 服务
• 检查本机和公网健康接口

Nginx 与 Cloudflare Tunnel

域名通过 Cloudflare Tunnel 进入服务器，Nginx 监听本机端口：

server {
    listen 127.0.0.1:8360;
    server_name signalscout.jaycode.online;

    location / {
        proxy_pass http://127.0.0.1:8020;
    }
}

Cloudflare Tunnel ingress 指向：

- hostname: signalscout.jaycode.online
  service: http://127.0.0.1:8360