nex_buddy/server/scripts/smoke_firmware.py

173 lines
8.4 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

"""固件发布链路端到端冒烟:上传 → 发布 → 设备 check → 下载 → 上报 → 再 check。
用法(后端已 ./scripts/dev.sh 起来):
.venv/bin/python scripts/smoke_firmware.py [http://127.0.0.1:8000]
管理端用例需要管理员账号,默认 admin@nexbuddy.com / NexBuddy2026。
脚本会在库里留下一个 SMOKE-OTA 设备和一个 9.9.9 的固件包,跑完自动清掉。
"""
from __future__ import annotations
import hashlib
import os
import random
import sys
import time
import httpx
BASE = (sys.argv[1] if len(sys.argv) > 1 else "http://127.0.0.1:8000").rstrip("/")
ADMIN_ACCOUNT = os.getenv("ADMIN_ACCOUNT", "admin@nexbuddy.com")
ADMIN_PASSWORD = os.getenv("ADMIN_PASSWORD", "NexBuddy2026")
CHIP = f"SMOKEOTA{random.randint(0x100000, 0xFFFFFF):06X}"
ACCOUNT = f"otas{int(time.time())}@test.local"
PASSWORD = "otas-pass-123"
VERSION = f"9.9.{random.randint(1, 99)}"
MODEL = "JC3636K518C_I_W"
# 假固件:真机不会拿它启动,这里只验服务端的字节流、sha、计数
PAYLOAD = bytes([0xE9]) + os.urandom(200 * 1024)
SHA = hashlib.sha256(PAYLOAD).hexdigest()
ok_count = 0
def step(name: str, cond: bool, extra: str = "") -> None:
global ok_count
print(f"[{'PASS' if cond else 'FAIL'}] {name} {extra}")
if cond:
ok_count += 1
else:
raise SystemExit(f"中止于:{name}")
with httpx.Client(base_url=BASE, timeout=20) as c:
# ---------------------------------------------------------------- 管理员
r = c.post("/api/auth/login", json={"account": ADMIN_ACCOUNT, "password": ADMIN_PASSWORD})
step("admin login", r.status_code == 200, f"{r.status_code}")
a_tok = {"Authorization": f"Bearer {r.json()['token']}"}
# ---------------------------------------------------------------- 普通用户 + 绑一台假设备
r = c.post("/api/auth/register", json={"account": ACCOUNT, "password": PASSWORD, "nickname": "OTA冒烟"})
step("register user", r.status_code == 201, f"{r.status_code}")
u_tok = {"Authorization": f"Bearer {r.json()['token']}"}
r = c.post("/device/v1/pair/code", json={"chip_id": CHIP, "model": MODEL, "fw_version": "0.1.0"})
step("device asks code", r.status_code == 200, f"{r.status_code}")
code = r.json()["code"]
r = c.post("/api/devices/pair", json={"code": code}, headers=u_tok)
step("web binds device", r.status_code == 200, f"{r.status_code}")
r = c.post("/device/v1/pair/claim", json={"code": code, "chip_id": CHIP})
step("device claims token", r.status_code == 200, f"{r.status_code}")
d_tok = {"Authorization": f"Bearer {r.json()['token']}"}
# ---------------------------------------------------------------- 初始状态:接口可用(库里可能已经有别的已发布包)
r = c.get("/device/v1/firmware/check", params={"current": "0.1.0", "lang": "zh"}, headers=d_tok)
step("check reachable", r.status_code == 200 and "update" in r.json(), r.text[:90])
print(f" 库里最新已发布:{r.json().get('version') or '(无)'}")
# ---------------------------------------------------------------- 上传(先不发布)
files = {"file": (f"knob_os-{VERSION}.bin", PAYLOAD, "application/octet-stream")}
data = {
"version": VERSION,
"model": MODEL,
"channel": "stable",
"notes": "冒烟用固件",
"notes_en": "smoke firmware",
"publish": "false",
}
r = c.post("/api/admin/firmwares", files=files, data=data, headers=a_tok)
step("admin upload", r.status_code == 200, f"{r.status_code} {r.text[:120]}")
r = c.get("/api/admin/firmwares", headers=a_tok)
rows = r.json()
row = next((x for x in rows["items"] if x["version"] == VERSION), None)
step("uploaded listed", row is not None)
fw_id = row["id"]
step("sha matches file", row["sha256"].lower() == SHA, f"{row['sha256'][:12]}… vs {SHA[:12]}…")
step("size matches file", row["size_bytes"] == len(PAYLOAD), str(row["size_bytes"]))
step("not published yet", row["published"] is False)
# 未发布 → 设备不该看见它(9.9.x 是最高的,一旦可见就会被选中)
r = c.get("/device/v1/firmware/check", params={"current": "0.1.0"}, headers=d_tok)
step("unpublished invisible", r.json().get("version") != VERSION, str(r.json().get("version")))
# ---------------------------------------------------------------- 发布
r = c.put(f"/api/admin/firmwares/{fw_id}", json={"published": True}, headers=a_tok)
step("publish", r.status_code == 200, f"{r.status_code}")
r = c.get("/device/v1/firmware/check", params={"current": "0.1.0", "lang": "zh"}, headers=d_tok)
j = r.json()
step("check -> update", j["update"] is True, j.get("version", ""))
step("version correct", j["version"] == VERSION)
step("size in payload", j["size"] == len(PAYLOAD), str(j["size"]))
step("sha in payload", j["sha256"].lower() == SHA)
step("url is relative", j["url"].startswith("/device/v1/firmware/"), j["url"])
step("reason newer", j["reason"] in ("newer", "forced"), j["reason"])
# 同版本 → 不该再推
r = c.get("/device/v1/firmware/check", params={"current": VERSION}, headers=d_tok)
step("same version -> no update", r.json()["update"] is False)
# ---------------------------------------------------------------- 下载
r = c.get(j["url"], headers=d_tok)
step("download 200", r.status_code == 200, f"{r.status_code}")
body = r.content
step("download bytes match", body == PAYLOAD, f"{len(body)} bytes")
step("download sha match", hashlib.sha256(body).hexdigest() == SHA)
step("x-firmware-version header", r.headers.get("x-firmware-version") == VERSION,
r.headers.get("x-firmware-version", "-"))
# 无 token → 401
r = c.get(j["url"])
step("download needs token", r.status_code in (401, 403), f"{r.status_code}")
# ---------------------------------------------------------------- 上报成功
r = c.post("/device/v1/firmware/report",
json={"version": VERSION, "status": "success", "slot": "app1"}, headers=d_tok)
step("report success", r.status_code == 200 and r.json()["state"] == "success", r.text[:80])
r = c.get("/device/v1/firmware/check", params={"current": VERSION}, headers=d_tok)
step("after report -> no update", r.json()["update"] is False)
# 设备列表里能看到新版本与槽位
r = c.get("/api/admin/devices/upgrades", headers=a_tok)
drows = r.json()
items = drows["items"]
dev = next((x for x in items if x["chip_id"] == CHIP), None)
step("device row exists", dev is not None)
step("device fw_version updated", dev and dev["fw_version"] == VERSION, (dev or {}).get("fw_version", "-"))
step("device slot recorded", dev and dev["boot_slot"] == "app1", (dev or {}).get("boot_slot", "-"))
step("upgrade_state success", dev and dev["upgrade_state"] == "success", (dev or {}).get("upgrade_state", "-"))
# ---------------------------------------------------------------- 上报失败
r = c.post("/device/v1/firmware/report",
json={"version": VERSION, "status": "failed", "error": "sha256 校验失败", "slot": "app1"},
headers=d_tok)
step("report failed", r.status_code == 200 and r.json()["state"] == "failed", r.text[:80])
# ---------------------------------------------------------------- 点名推送(强制)
r = c.post(f"/api/admin/devices/{dev['id']}/upgrade",
json={"firmware_id": fw_id}, headers=a_tok)
step("force upgrade 200", r.status_code == 200, f"{r.status_code} {r.text[:100]}")
r = c.get("/device/v1/firmware/check", params={"current": VERSION}, headers=d_tok)
step("forced even if same version", r.json()["update"] is True and r.json()["mandatory"] is True,
f"update={r.json().get('update')} mandatory={r.json().get('mandatory')}")
# 点名回滚到更低的版本也得能推(compare 会把 lower 判成"不升",点名要绕过它)
r = c.post(f"/api/admin/firmwares/{fw_id}/rollout",
json={"firmware_id": fw_id, "device_ids": [dev["id"]]}, headers=a_tok)
step("rollout ok", r.status_code == 200, r.text[:80])
# ---------------------------------------------------------------- 清理
r = c.delete(f"/api/admin/devices/{dev['id']}/upgrade", headers=a_tok)
step("cancel target", r.status_code == 200, f"{r.status_code}")
r = c.delete(f"/api/admin/firmwares/{fw_id}", headers=a_tok)
step("cleanup firmware", r.status_code == 200, f"{r.status_code} {r.text[:100]}")
print(f"\n全部通过:{ok_count} 项")