Python 运维自动化系列（10）：脚本如何交付——zipapp 单文件分发与系列收尾

import zipapp
zipapp.create_archive("src目录", target="工具名.pyz", interpreter="python", compressed=True)

import shutil
import sys
import zipfile
from pathlib import Path

import zipapp

HERE = Path(__file__).parent
SRC = HERE / "opsmonitor_src"        # 打包源：一个普通的 Python 包目录
PYZ = HERE / "ops_monitor.pyz"       # 产物：单文件可执行归档


def main() -> None:
    # 1. 准备包结构：把 monitor.py 复制成 opsmonitor 包
    if SRC.exists():
        shutil.rmtree(SRC)
    (SRC / "opsmonitor").mkdir(parents=True)
    (SRC / "opsmonitor" / "__init__.py").write_text("", encoding="utf-8")
    shutil.copy(HERE.parent / "monitor.py", SRC / "opsmonitor" / "monitor.py")
    # 入口文件：zipapp 运行时会执行它
    (SRC / "__main__.py").write_text(
        "from opsmonitor.monitor import main\nmain()\n", encoding="utf-8"
    )

    # 2. 打包：compressed=True 开启 zip 压缩
    zipapp.create_archive(SRC, target=PYZ, interpreter=sys.executable, compressed=True)
    print(f"打包完成: {PYZ.name}（{PYZ.stat().st_size / 1024:.0f} KB）")

    # 3. 验证它本质上就是个 zip
    with zipfile.ZipFile(PYZ) as z:
        names = z.namelist()
    print(f"内部结构: {sorted(names)}")

    # 4. 真实运行这个 .pyz——它就是我们的监控脚本
    import subprocess
    r = subprocess.run([sys.executable, str(PYZ)], capture_output=True, text=True, timeout=60)
    print("\n== python ops_monitor.pyz 的真实输出 ==")
    print(r.stdout.strip())
    if r.returncode != 0:
        print(r.stderr)


if __name__ == "__main__":
    main()

打包完成: ops_monitor.pyz（3 KB）
内部结构: ['__main__.py', 'opsmonitor/', 'opsmonitor/__init__.py', 'opsmonitor/monitor.py']

== python ops_monitor.pyz 的真实输出 ==
== 检查开始 2026-09-28 20:59:58 ==
CPU 使用率: 16.0%
内存使用率: 73.8%（已用 11.3 GB / 共 15.3 GB）
磁盘 C:\      已用 92.3%
磁盘 D:\      已用 70.4%
磁盘 E:\      已用 5.6%
(未配置 MONITOR_WEBHOOK_URL，以上告警只写入了日志)
== 检查结束 ==

【基础层】单机先稳住
  01 监控告警   psutil 读指标 + logging 轮转 + Webhook，脚本首跑抓到真实磁盘告警
  02 日志分析   流式逐行 + 正则 + Counter，GB 级日志稳稳分析；踩过「捕获组是字符串」的坑
  03 磁盘治理   du 等价物 + 扫描/删除分离 + dry-run 铁律，垃圾文件一个不误杀
  04 进程守护   识别/观测/拉起闭环，诚实讨论了 systemd 才是正解
        ↓
【进阶层】从一台到一批
  05 健康检查   TCP 探活 + 失败分类 + 线程池并发，5 目标 4051ms → 2021ms
  06 任务调度   schedule vs APScheduler，max_instances 防重叠，踩过「任务定时自杀」的坑
  07 批量远程   paramiko 安全三原则 + 超时纪律 + 并发骨架 + 诚实的适用边界
        ↓
【工程层】脚本能带得走、靠得住
  08 配置渲染   一份模板 + 一份清单 + StrictUndefined，错误提前到渲染期
  09 脚本测试   真实 RED→GREEN，monkeypatch 隔离 psutil，测试即发布闸门
  10 打包交付   zipapp 单文件分发，代码与环境依赖显式分离