Flask 云端更新
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_d7127a82/flask-cloud-update。
技能介绍
要解决什么问题
Flask 项目已经跑在云服务器上(常见是腾讯云轻量 + 宝塔),本地开发和自测都在 GitHub 上完成。每次 git push 之后,若仍要手动 SSH、git pull、装依赖、再 systemctl restart,既慢也容易漏步骤;更新失败时也不一定马上知道是代码问题还是服务没起来。
技能如何工作
本技能面向已按配套部署流程完成首次上线的环境:服务器上已有同一仓库的 clone、GitHub 已信任服务器 SSH 公钥、并存在如 flask-app 的 systemd 单元。你只要在对话里说「更新服务器上的 Flask」「把最新代码同步到线上」等,助手会优先通过 SSH 在项目目录执行附带的 update.sh(或等价的内联命令),典型顺序是:
git fetch/git pull --ff-only(可按分支参数拉取)- 若存在
requirements.txt则pip3 install -r(无变更时大致幂等) - 确认 systemd 单元存在后
systemctl restart - 打印服务状态与近期日志,并对
127.0.0.1:5000做本地健康检查
数据侧:Excel、users.json、backups/、audit.jsonl、.env 等不进 git,git pull 只动代码,线上业务文件不会被覆盖。
脚本支持 PROJECT_DIR、SERVICE_NAME、BRANCH 等可选参数;出问题时可按 SKILL 中的方式回滚到上一提交或指定版本。
适用边界与注意点
首次使用前需把 update.sh 放到服务器项目目录(只做一次)。若助手环境没有 SSH 密钥,会改给可在本机终端粘贴的命令。git pull 报 Permission denied 通常是服务器公钥未加入 GitHub;服务器上若有未提交的手改文件需先 stash 或还原。健康检查未通过时应对照 journalctl -u <服务名> 日志,再考虑回滚。
使用场景
- 本地功能自测通过并已 push,需要把 GitHub 主分支同步到 `/www/wwwroot/flask-app` 并重启 systemd 服务
- 本次提交修改了 `requirements.txt`,希望在服务器自动 pip 安装后重启,而不触碰不进 git 的 Excel 与用户数据文件
- 助手环境无法直连 SSH,需要拿到一条可在本机终端执行的 pull+重启+健康检查命令
- 线上更新后首页异常,需要按技能流程查看 `journalctl` 日志并回滚到上一可用提交
适合人员
- 独立维护宝塔+systemd 上 Flask 的开发者,希望在每次 push 后用固定流程更新线上而非手工 SSH
- 负责腾讯云轻量实例、仓库已与 GitHub SSH 打通的运维,要把 git pull 与重启写成可重复步骤
- 已完成 flask-bt-lighthouse-deploy 首次部署、进入频繁迭代的项目负责人,需要与首次部署技能衔接的更新路径
- 用 Python Web 承载内部工具、数据文件留在服务器本地的维护者,关心 pull 不覆盖业务数据