Add Web 2 workspace and controlled deployment updates
This commit is contained in:
@@ -0,0 +1,317 @@
|
||||
"""Official stable Web 2 releases and a file-only host updater handshake.
|
||||
|
||||
This module is also used by the Linux host, so it imports no application, Qt,
|
||||
HTTP framework, or third-party library. It never executes an update itself.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import datetime, timedelta, timezone
|
||||
import json
|
||||
import os
|
||||
from pathlib import Path
|
||||
import re
|
||||
import stat
|
||||
import tempfile
|
||||
import threading
|
||||
from urllib.error import HTTPError
|
||||
from urllib.request import HTTPRedirectHandler, Request, build_opener
|
||||
import uuid
|
||||
|
||||
REPOSITORY = "attilanet/myrzx_bot"
|
||||
IMAGE = "ghcr.io/attilanet/myrzx_bot-web"
|
||||
RELEASES_API = f"https://api.github.com/repos/{REPOSITORY}/releases"
|
||||
PROTOCOL = 1
|
||||
_TAG = re.compile(r"v2\.(0|[1-9][0-9]{0,8})\.(0|[1-9][0-9]{0,8})", re.ASCII)
|
||||
_CURRENT = re.compile(r"v?2\.(0|[1-9][0-9]{0,8})\.(0|[1-9][0-9]{0,8})(\.dev[0-9]+)?", re.ASCII)
|
||||
_ID = re.compile(r"[0-9a-f]{32}", re.ASCII)
|
||||
HOST_STATES = frozenset({"pending", "applying", "succeeded", "rolled_back", "failed"})
|
||||
_MESSAGES = {
|
||||
"unchecked": "尚未检查官方 Web 2 正式版本。",
|
||||
"no_release": "官方尚无稳定 Web 2 正式版;不会安装旧版桌面程序。",
|
||||
"up_to_date": "当前已是最新稳定 Web 2 版本。",
|
||||
"available": "发现稳定 Web 2 更新。",
|
||||
"check_failed": "GitHub 发布检查失败,请稍后重试。",
|
||||
"unavailable": "未启用有效的 Linux 宿主机执行器;当前仅可检查更新。",
|
||||
"pending": "更新请求已提交,等待宿主机处理。",
|
||||
"applying": "宿主机正在备份、更新并检查服务健康。",
|
||||
"succeeded": "宿主机已确认更新后服务健康。",
|
||||
"rolled_back": "更新未通过健康检查,宿主机已恢复旧镜像及更新前数据。",
|
||||
"failed": "宿主机更新失败,请操作者检查部署状态。",
|
||||
}
|
||||
|
||||
|
||||
def utc_now():
|
||||
return datetime.now(timezone.utc)
|
||||
|
||||
|
||||
def timestamp(value=None):
|
||||
return (value or utc_now()).isoformat(timespec="seconds").replace("+00:00", "Z")
|
||||
|
||||
|
||||
def parse_time(value):
|
||||
if not isinstance(value, str) or len(value) > 40:
|
||||
return None
|
||||
try:
|
||||
result = datetime.fromisoformat(value.replace("Z", "+00:00"))
|
||||
except ValueError:
|
||||
return None
|
||||
return result.astimezone(timezone.utc) if result.tzinfo is not None else None
|
||||
|
||||
|
||||
def stable_version(tag):
|
||||
"""Accept only canonical official image tags in the stable 2.x channel."""
|
||||
match = _TAG.fullmatch(tag) if isinstance(tag, str) else None
|
||||
if match is None:
|
||||
raise ValueError("更新版本必须是稳定的 v2.x.y,且数字不含前导零。")
|
||||
return 2, int(match[1]), int(match[2]), 1
|
||||
|
||||
|
||||
def current_version_key(version):
|
||||
match = _CURRENT.fullmatch(version) if isinstance(version, str) else None
|
||||
if match is None:
|
||||
raise ValueError("当前 Web 版本必须是 2.x.y 或 2.x.y.devN。")
|
||||
return 2, int(match[1]), int(match[2]), int(match[3] is None)
|
||||
|
||||
|
||||
def validate_image_release(repository, tag, source_version):
|
||||
"""Gate publishing on the official repository and the actual source version."""
|
||||
if not isinstance(repository, str) or repository.lower() != REPOSITORY:
|
||||
raise ValueError("只有官方仓库可发布此镜像。")
|
||||
stable_version(tag)
|
||||
if source_version != tag[1:]:
|
||||
raise ValueError("源码版本必须与稳定发布标签完全一致。")
|
||||
return tag
|
||||
|
||||
|
||||
def valid_id(value):
|
||||
return isinstance(value, str) and _ID.fullmatch(value) is not None
|
||||
|
||||
|
||||
def read_json(path, *, limit=65536):
|
||||
"""Read a small regular control file without following Linux symlinks."""
|
||||
flags = os.O_RDONLY | getattr(os, "O_NOFOLLOW", 0) | getattr(os, "O_NONBLOCK", 0)
|
||||
try:
|
||||
if Path(path).is_symlink():
|
||||
return None
|
||||
descriptor = os.open(path, flags)
|
||||
with os.fdopen(descriptor, "rb") as stream:
|
||||
info = os.fstat(stream.fileno())
|
||||
if not stat.S_ISREG(info.st_mode) or info.st_size > limit:
|
||||
return None
|
||||
payload = stream.read(limit + 1)
|
||||
if len(payload) > limit:
|
||||
return None
|
||||
return json.loads(payload)
|
||||
except (OSError, ValueError, UnicodeError):
|
||||
return None
|
||||
|
||||
|
||||
def atomic_json(path, value, *, mode=0o644):
|
||||
"""Replace a complete control file; never write through a destination link."""
|
||||
path = Path(path)
|
||||
path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
|
||||
descriptor, temporary = tempfile.mkstemp(prefix=f".{path.name}.", dir=path.parent)
|
||||
try:
|
||||
with os.fdopen(descriptor, "w", encoding="utf-8", newline="\n") as stream:
|
||||
os.chmod(temporary, mode)
|
||||
json.dump(value, stream, ensure_ascii=False, indent=2)
|
||||
stream.write("\n")
|
||||
stream.flush()
|
||||
os.fsync(stream.fileno())
|
||||
os.replace(temporary, path)
|
||||
finally:
|
||||
if os.path.exists(temporary):
|
||||
os.unlink(temporary)
|
||||
|
||||
|
||||
class _NoRedirect(HTTPRedirectHandler):
|
||||
def redirect_request(self, req, fp, code, msg, headers, newurl):
|
||||
return None
|
||||
|
||||
|
||||
def github_releases():
|
||||
"""Fetch only the fixed public repository. No tokens or asset downloads."""
|
||||
opener = build_opener(_NoRedirect())
|
||||
releases = []
|
||||
for page in range(1, 11):
|
||||
request = Request(f"{RELEASES_API}?per_page=100&page={page}", headers={
|
||||
"Accept": "application/vnd.github+json",
|
||||
"User-Agent": "ranch-web-release-checker/2",
|
||||
"X-GitHub-Api-Version": "2022-11-28",
|
||||
})
|
||||
try:
|
||||
with opener.open(request, timeout=8) as response:
|
||||
payload = response.read(2 * 1024 * 1024 + 1)
|
||||
except HTTPError as error:
|
||||
if error.code == 404: # A repository without public releases.
|
||||
return []
|
||||
raise
|
||||
if len(payload) > 2 * 1024 * 1024:
|
||||
raise ValueError("发布列表超出大小限制。")
|
||||
items = json.loads(payload)
|
||||
if not isinstance(items, list) or len(items) > 100:
|
||||
raise ValueError("发布列表格式无效。")
|
||||
releases.extend(items)
|
||||
if len(items) < 100:
|
||||
return releases
|
||||
raise ValueError("发布列表超出页数限制,请稍后重试。")
|
||||
|
||||
|
||||
def official_tags(releases):
|
||||
tags = set()
|
||||
for release in releases:
|
||||
if not isinstance(release, dict):
|
||||
continue
|
||||
if release.get("draft") is not False or release.get("prerelease") is not False:
|
||||
continue
|
||||
tag = release.get("tag_name")
|
||||
try:
|
||||
stable_version(tag)
|
||||
except ValueError:
|
||||
continue
|
||||
tags.add(tag)
|
||||
return tags
|
||||
|
||||
|
||||
class UpdateService:
|
||||
def __init__(self, root, current_version):
|
||||
self.root = Path(root)
|
||||
self.current_version = current_version
|
||||
self._current = current_version_key(current_version)
|
||||
self._lock = threading.RLock()
|
||||
|
||||
def _executor(self):
|
||||
directory = os.environ.get("RANCH_WEB_UPDATER_DIR", "")
|
||||
result = {"configured": False, "enabled": False, "auto_apply": False,
|
||||
"state": "unconfigured", "heartbeat_at": None}
|
||||
if not directory:
|
||||
return result, None
|
||||
value = read_json(Path(directory) / "capability.json")
|
||||
if not isinstance(value, dict) or value.get("protocol") != PROTOCOL:
|
||||
return result, None
|
||||
if not valid_id(value.get("executor_id")):
|
||||
return result, None
|
||||
seen, expiry = parse_time(value.get("heartbeat_at")), parse_time(value.get("expires_at"))
|
||||
if seen is None or expiry is None:
|
||||
return result, None
|
||||
now = utc_now()
|
||||
result.update(configured=True, heartbeat_at=timestamp(seen),
|
||||
auto_apply=value.get("auto_apply") is True)
|
||||
if seen > now + timedelta(seconds=60) or expiry <= now or expiry > seen + timedelta(minutes=16):
|
||||
result["state"] = "expired"
|
||||
return result, None
|
||||
result["enabled"] = value.get("enabled") is True
|
||||
result["state"] = "ready" if result["enabled"] else "disabled"
|
||||
return result, value["executor_id"] if result["enabled"] else None
|
||||
|
||||
def _request(self):
|
||||
value = read_json(self.root / "update-request.json")
|
||||
if not isinstance(value, dict) or value.get("protocol") != PROTOCOL:
|
||||
return None
|
||||
if not valid_id(value.get("request_id")) or parse_time(value.get("requested_at")) is None:
|
||||
return None
|
||||
try:
|
||||
stable_version(value.get("version"))
|
||||
except ValueError:
|
||||
return None
|
||||
return {key: value[key] for key in ("request_id", "version", "requested_at")}
|
||||
|
||||
def _host_status(self):
|
||||
value = read_json(self.root / "updater-status.json")
|
||||
if not isinstance(value, dict) or value.get("protocol") != PROTOCOL:
|
||||
return None
|
||||
if value.get("status") not in HOST_STATES or not valid_id(value.get("request_id")):
|
||||
return None
|
||||
if parse_time(value.get("updated_at")) is None:
|
||||
return None
|
||||
try:
|
||||
stable_version(value.get("version"))
|
||||
except ValueError:
|
||||
return None
|
||||
# Advisory files in /data are not trusted to supply public free text.
|
||||
result = {key: value[key] for key in ("request_id", "status", "version", "updated_at")}
|
||||
result["error"] = _MESSAGES[value["status"]] if value["status"] in {"failed", "rolled_back"} else None
|
||||
return result
|
||||
|
||||
def status(self):
|
||||
with self._lock:
|
||||
cache = read_json(self.root / "update-check.json")
|
||||
cache = cache if isinstance(cache, dict) else {}
|
||||
state = cache.get("status", "unchecked")
|
||||
if state not in {"unchecked", "no_release", "up_to_date", "available", "check_failed"}:
|
||||
state = "unchecked"
|
||||
checked = parse_time(cache.get("checked_at"))
|
||||
latest = cache.get("latest_version")
|
||||
try:
|
||||
key = stable_version(latest)
|
||||
except ValueError:
|
||||
latest, key = None, None
|
||||
available = key is not None and key > self._current and state != "check_failed"
|
||||
if latest and state != "check_failed":
|
||||
state = "available" if available else "up_to_date"
|
||||
elif state in {"available", "up_to_date"}:
|
||||
state = "unchecked"
|
||||
executor, _ = self._executor()
|
||||
request, host = self._request(), self._host_status()
|
||||
if request:
|
||||
request["status"] = "pending"
|
||||
if host and host["request_id"] == request["request_id"]:
|
||||
request["status"] = host["status"]
|
||||
state = request["status"]
|
||||
elif host:
|
||||
state = host["status"]
|
||||
result = {
|
||||
"current_version": self.current_version, "latest_version": latest,
|
||||
"available": available, "checked_at": timestamp(checked) if checked else None,
|
||||
"release_url": f"https://github.com/{REPOSITORY}/releases/tag/{latest}" if latest else None,
|
||||
"channel": "stable-2.x", "repository": REPOSITORY,
|
||||
"status": state, "message": _MESSAGES[state],
|
||||
"error": _MESSAGES[state] if state in {"check_failed", "failed", "rolled_back"} else None,
|
||||
"can_apply": available and executor["enabled"] and state not in {"pending", "applying"},
|
||||
"executor": executor, "request": request, "host_status": host,
|
||||
}
|
||||
return result
|
||||
|
||||
def check(self):
|
||||
with self._lock:
|
||||
try:
|
||||
tags = official_tags(github_releases())
|
||||
latest = max(tags, key=stable_version) if tags else None
|
||||
state = "no_release" if latest is None else "available" if stable_version(latest) > self._current else "up_to_date"
|
||||
cache = {"status": state, "latest_version": latest, "checked_at": timestamp()}
|
||||
except Exception:
|
||||
# Never expose response bodies, proxy addresses, tokens, or paths.
|
||||
cache = {"status": "check_failed", "latest_version": None, "checked_at": timestamp()}
|
||||
atomic_json(self.root / "update-check.json", cache)
|
||||
return self.status()
|
||||
|
||||
def request_update(self, version=None):
|
||||
with self._lock:
|
||||
if version is not None:
|
||||
stable_version(version)
|
||||
executor, executor_id = self._executor()
|
||||
if not executor["enabled"]:
|
||||
result = self.status()
|
||||
result.update(status="unavailable", message=_MESSAGES["unavailable"], can_apply=False)
|
||||
return result
|
||||
state = self.status()
|
||||
if state["status"] in {"pending", "applying"}:
|
||||
return state
|
||||
# Revalidate against live official releases, never just a local cache.
|
||||
try:
|
||||
tags = official_tags(github_releases())
|
||||
except Exception:
|
||||
raise ValueError(_MESSAGES["check_failed"]) from None
|
||||
target = version or (max(tags, key=stable_version) if tags else None)
|
||||
if target is None or target not in tags:
|
||||
raise ValueError("指定版本不是官方已发布的稳定 Web 2 正式版。")
|
||||
if stable_version(target) <= self._current:
|
||||
raise ValueError("仅允许升级到比当前版本更新的稳定 Web 2 正式版。")
|
||||
atomic_json(self.root / "update-check.json", {
|
||||
"status": "available", "latest_version": max(tags, key=stable_version), "checked_at": timestamp(),
|
||||
})
|
||||
atomic_json(self.root / "update-request.json", {
|
||||
"protocol": PROTOCOL, "request_id": uuid.uuid4().hex, "executor_id": executor_id,
|
||||
"version": target, "requested_at": timestamp(),
|
||||
}, mode=0o600)
|
||||
return self.status()
|
||||
Reference in New Issue
Block a user