Files
buryan-infra/ops/scripts/research_alternatives.py

101 lines
4.8 KiB
Python
Executable File

#!/usr/bin/env python3
"""Живое исследование альтернатив (пункт 4 контура): факты из сети со ссылками.
Для образов из реестра тянет последний релиз и активность репозитория через
GitHub API, сверяет с тем, что у нас работает, и пишет отчёт с цитатами.
Без токена GitHub: 60 запросов/час — хватает на ~20 сервисов.
Отчёт: ops/evolution/research-YYYY-MM-DD.md
"""
import json
import os
import re
import subprocess
import sys
import time
import urllib.request
from datetime import date
ROOT = "/root/buryan-infra"
OUT = ROOT + "/ops/evolution"
UA = "buryans-hub-research/1.0"
# образ -> (github owner/repo, что это)
TARGETS = {
"ghcr.io/mealie-recipes/mealie": ("mealie-recipes/mealie", "рецепты"),
"fireflyiii/core": ("firefly-iii/firefly-iii", "финансы"),
"vikunja/vikunja": ("go-vikunja/vikunja", "задачи"),
"gitea/gitea": ("go-gitea/gitea", "git"),
"prom/prometheus": ("prometheus/prometheus", "метрики"),
"grafana/grafana": ("grafana/grafana", "графики"),
"grafana/loki": ("grafana/loki", "логи"),
"syncthing/syncthing": ("syncthing/syncthing", "синхронизация"),
"jellyfin/jellyfin": ("jellyfin/jellyfin", "медиа"),
"goauthentik/server": ("goauthentik/authentik", "вход"),
}
def api(url):
req = urllib.request.Request(url)
req.add_header("User-Agent", UA)
req.add_header("Accept", "application/vnd.github+json")
try:
with urllib.request.urlopen(req, timeout=25) as r:
return json.loads(r.read().decode())
except Exception as e:
return {"_error": "%s: %s" % (type(e).__name__, str(e)[:80])}
def running_version(image):
"""Что реально запущено у нас (тег образа)."""
short = image.split("/")[-1].split(":")[0]
out = subprocess.run(
"for ct in $(pct list | awk 'NR>1 && $2==\"running\" {print $1}'); do "
"pct exec $ct -- sh -c 'docker ps --format \"{{.Image}}\" 2>/dev/null' 2>/dev/null; done",
shell=True, capture_output=True, text=True, timeout=120).stdout
versions = [l for l in out.splitlines() if short in l]
return sorted(set(v.split(":")[-1] for v in versions))[:3]
def main():
os.makedirs(OUT, exist_ok=True)
path = os.path.join(OUT, "research-%s.md" % date.today().isoformat())
L = ["# Живое исследование альтернатив — %s" % date.today().isoformat(), "",
"Источник фактов: GitHub API (публичные данные, на момент запуска).",
"Каждая строка — проверяемое утверждение со ссылкой.", ""]
L += ["| Сервис | У нас | Последний релиз | Обновлён | Звёзд | Ссылка |",
"|---|---|---|---|---|---|"]
used = 0
for image, (repo, purpose) in TARGETS.items():
info = api("https://api.github.com/repos/%s" % repo)
if "_error" in info:
L.append("| `%s` (%s) | — | — | — | — | ошибка: %s |"
% (repo, purpose, info["_error"]))
continue
rel = api("https://api.github.com/repos/%s/releases/latest" % repo)
used += 2
tag = rel.get("tag_name") or rel.get("name") or "—"
date_s = (rel.get("published_at") or "")[:10] or "—"
ours = ", ".join(running_version(image)) or "—"
L.append("| `%s` (%s) | %s | %s | %s | %s | https://github.com/%s/releases |"
% (repo, purpose, ours, tag, date_s,
format(info.get("stargazers_count", 0), ","), repo))
time.sleep(0.4)
L += ["", "## Как читать", "",
"- «У нас» — фактический тег запущенного контейнера.",
"- «Последний релиз» — последний публичный релиз по данным GitHub.",
"- **Важно:** расхождение тега ≠ «надо срочно обновлять». Смотреть changelog на breaking changes.",
"- Отчёт не делает выводов «заменить X на Y»: для этого нужны критерии (нагрузка, поддержка, CVE) —",
" они в отчёте агента развития.", ""]
L.append("_Запросов к GitHub API: %d (лимит без токена — 60/час)._ " % used)
open(path, "w", encoding="utf-8").write("\n".join(L) + "\n")
print("отчёт:", path)
print("сервисов исследовано:", len(TARGETS), "| запросов:", used)
if __name__ == "__main__":
sys.exit(main())