多节点部署必须用 serialgroup 或 threadinggroup；serialgroup 顺序执行、失败中断，threadinggroup 并行执行、需调优超时与线程数；connection 需显式配置 host/user/key。
fabric 2.x 的 Connection 和 SerialGroup 怎么选
多节点部署必须用 SerialGroup 或 ThreadingGroup，不能直接对多个 Connection 对象循环调用——那样会丢失并行控制、异常传播和结果聚合能力。Fabric 2.x 已废弃 env.hosts 和 @hosts 装饰器，所有主机调度必须显式构造 Group。
-
SerialGroup：适合强依赖顺序的操作（比如先停服务、再同步代码、最后启服务），失败时自动中断后续节点 -
ThreadingGroup：适合独立操作（如批量检查磁盘空间），但要注意远程命令超时或并发连接数限制，默认最多 10 线程，可通过connect_kwargs={'timeout': 5}和pool_size=20调整 - 每个
Connection实例应带明确的host、user、connect_kwargs={'key_filename': '/path/id_rsa'}，避免混用全局配置
如何让 deploy() 和 rollback() 共享状态且不污染全局变量
部署和回滚常需共享版本号、包路径、备份目录等上下文，但 Fabric 任务函数是无状态的。硬编码或模块级变量在并发执行时会出错；用 invoke.Context 传参又太重。最简方案是把关键状态封装进一个轻量类，并作为参数传给每个任务函数。
- 定义
DeployContext类，含version、release_dir、backup_dir等字段，在deploy()开头生成实例，然后透传给rollback() - 避免在
rollback()中重新解析current软链目标——它可能已被破坏，应由deploy()在成功部署后主动记录到context.prev_release - 不要在任务中修改
context的属性来“传递”数据，而是返回结构化结果（如{'status': 'ok', 'release_id': 'v1.2.3'}），由调用方决定是否保存
fabfile.py 里怎么组织 deploy/rollback 逻辑才不容易漏步骤
典型部署流程包含「校验 → 备份 → 上传 → 配置渲染 → 服务重启」五步，回滚则是「停止 → 切换软链 → 恢复配置 → 启动」。把每步拆成独立函数（如 _check_disk_space(c)、_backup_current(c, ctx)），并在主函数里线性调用，比堆在一个大函数里更易测试和复用。
使用 font_manager.addfont() 添加中文字体文件，设置 rcParams['font.family']，并禁用 unicode_minus，使 matplotlib 显示中文。
- 每步函数都应有明确的失败语义：用
c.run(..., warn=True)捕获非致命错误，用raise Exit("xxx")终止整个流程 - 上传文件别用
c.put()直传大包——它不支持断点续传且内存占用高；改用c.run('curl -sSL {url} | tar -C /opt/app -xzf -')或先rsync到临时目录再解压 - 配置渲染建议用
jinja2模板 +dict上下文，而非字符串拼接，避免引号转义混乱；模板路径统一放在./templates/下，通过os.path.join(os.path.dirname(__file__), 'templates')加载
回滚失败时为什么总是切不到上个版本
最常见的原因是 current 软链接损坏或 releases/ 目录权限不对，但脚本仍试图 ln -sf v1.2.2 current。必须在回滚前做两级校验：先确认 ctx.prev_release 目录存在且可读，再确认该目录下有预期的 app.py 或 healthz 端点。
- 不要依赖
ls -t releases/ | head -n2排序取上一版——文件系统 mtime 可能不准，且 NFS 下不可靠 - 每次成功部署后，除了更新
current软链，务必写一个releases/v1.2.3/.deployed标记文件，回滚时只认带这个标记的目录 - 回滚命令本身要加
sudo=True且指定pty=True，否则某些 systemd 服务 reload 会因缺少 TTY 报Failed to connect to bus
真正难的不是写完 deploy 和 rollback，而是让它们在任意中间步骤失败后，还能被再次安全调用——这意味着每步都要幂等，且状态检查必须覆盖临界条件（比如软链指向不存在目录、backup/ 写满、systemctl is-active 返回 degraded）。这些细节不写进函数签名里，很容易被忽略。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
