[SPRINT-V1][C] Живое исследование: факты из GitHub API со ссылками (10 сервисов), отчёт research-*.md

This commit is contained in:
root committed 2026-11-05 22:59:14 +03:00
1 parent 1dc64c7f09
commit 9c3d8b7ec7
2 files changed
+127

No files matched your search

+27
View File
@@ -0,0 +1,27 @@
# Живое исследование альтернатив — 2026-11-05
Источник фактов: GitHub API (публичные данные, на момент запуска).
Каждая строка — проверяемое утверждение со ссылкой.
| Сервис | У нас | Последний релиз | Обновлён | Звёзд | Ссылка |
|---|---|---|---|---|---|
| `mealie-recipes/mealie` (рецепты) | latest | v3.30.0 | 2026-10-31 | 13,822 | https://github.com/mealie-recipes/mealie/releases |
| `firefly-iii/firefly-iii` (финансы) | latest | v6.7.9 | 2026-10-11 | 25,105 | https://github.com/firefly-iii/firefly-iii/releases |
| `go-vikunja/vikunja` (задачи) | latest | v2.7.1 | 2026-10-20 | 5,969 | https://github.com/go-vikunja/vikunja/releases |
| `go-gitea/gitea` (git) | latest | v28.3.0 | 2026-11-01 | 58,913 | https://github.com/go-gitea/gitea/releases |
| `prometheus/prometheus` (метрики) | latest | v3.16.0 | 2026-11-05 | 66,983 | https://github.com/prometheus/prometheus/releases |
| `grafana/grafana` (графики) | 3.2.1, 3.5.1, 3.7.9 | v13.3.0 | 2026-10-27 | 77,719 | https://github.com/grafana/grafana/releases |
| `grafana/loki` (логи) | 3.7.9 | v3.7.9 | 2026-10-20 | 29,130 | https://github.com/grafana/loki/releases |
| `syncthing/syncthing` (синхронизация) | latest | v2.1.7 | 2026-10-21 | 90,127 | https://github.com/syncthing/syncthing/releases |
| `jellyfin/jellyfin` (медиа) | latest | v12.4 | 2026-10-26 | 59,041 | https://github.com/jellyfin/jellyfin/releases |
| `goauthentik/authentik` (вход) | 2026.8.5, latest | version/2026.8.5 | 2026-10-21 | 26,244 | https://github.com/goauthentik/authentik/releases |
## Как читать
- «У нас» — фактический тег запущенного контейнера.
- «Последний релиз» — последний публичный релиз по данным GitHub.
- **Важно:** расхождение тега ≠ «надо срочно обновлять». Смотреть changelog на breaking changes.
- Отчёт не делает выводов «заменить X на Y»: для этого нужны критерии (нагрузка, поддержка, CVE) —
они в отчёте агента развития.
_Запросов к GitHub API: 20 (лимит без токена — 60/час)._
+100
View File
@@ -0,0 +1,100 @@
#!/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())