feat(F6-3): version-watch — контроль контрольной суммы для плавающих тегов

This commit is contained in:
root committed 2026-10-14 12:44:51 +03:00
1 parent 114f8cf101
commit 200dbf1284
2 files changed
+108 -44

No files matched your search

+75 -43
View File
@@ -2,17 +2,23 @@
# ============================================================
# version-watch.sh — F6-3: слежение за выходом новых версий
# ============================================================
# Сравнивает версии из stable-versions.json с последними стабильными тегами
# соответствующих образов на Docker Hub и уведомляет n8n об обновлении.
# Умеет два режима:
#
# 1. Закреплённый тег (semver, например gitea:1.22.0)
# — сравнивается со старшим стабильным semver-тегом образа на Docker Hub.
# Уведомление: «доступна версия X».
#
# 2. Плавающий тег (latest, 7-alpine и подобные)
# — версию по тегу определить нельзя, поэтому отслеживается контрольная
# сумма (digest) этого тега. Уведомление: «образ X:latest обновился».
# Именно этот режим важен сейчас: 62 из 63 контейнеров работают
# на плавающих тегах.
#
# Что исправлено по сравнению с прежней версией:
# 1. Раньше скрипт сравнивал зафиксированный тег со строкой "latest"
# (page_size=1&name=latest), поэтому находил «обновление» при каждом
# запуске. Теперь берётся старший semver-тег и сравнение осмысленно.
# 2. Добавлен файл состояния: об одной и той же версии сообщается один раз.
# 3. Первый запуск только фиксирует текущие версии, не рассылая уведомлений.
# 4. Образы с плавающими тегами (latest/edge/nightly) пропускаются:
# их версию по тегу определить нельзя, а сравнивать нечего.
# * раньше скрипт сравнивал закреплённый тег со строкой "latest"
# (page_size=1&name=latest) и поэтому находил «обновление» каждый запуск;
# * добавлен файл состояния — об одном и том же изменении сообщается один раз;
# * первый запуск только фиксирует базу и не рассылает уведомлений.
#
# Запуск: вручную или по cron каждые 6 часов.
# ============================================================
@@ -35,12 +41,23 @@ command -v curl >/dev/null 2>&1 || { log "нужен curl"; exit 1; }
is_semver() { echo "$1" | grep -qE '^v?[0-9]+(\.[0-9]+){1,2}$'; }
# Старший стабильный semver-тег образа на Docker Hub.
# pre-release и служебные теги (latest, edge, stable, nightly) отбрасываются.
latest_stable_tag() {
# --- Docker Hub -------------------------------------------------------------
dh_repo() { # приводит имя образа к пути на Docker Hub, либо пусто
local image="$1"
case "$image" in
ghcr.io/*|lscr.io/*|quay.io/*|docker.io/*|registry.*) return 1 ;;
esac
case "$image" in
*/*) echo "$image" ;;
*) echo "library/$image" ;;
esac
}
latest_stable_tag() {
local image="$1" repo
repo=$(dh_repo "$image") || return 1
curl -s -m 25 \
"https://hub.docker.com/v2/repositories/${image}/tags/?page_size=100&ordering=last_updated" \
"https://hub.docker.com/v2/repositories/${repo}/tags/?page_size=100&ordering=last_updated" \
| jq -r '.results[]?.name' 2>/dev/null \
| grep -E '^v?[0-9]+(\.[0-9]+){1,2}$' \
| sed 's/^v//' \
@@ -48,58 +65,73 @@ latest_stable_tag() {
| tail -1
}
save_state() { # $1 service, $2 value
tag_digest() {
local image="$1" tag="$2" repo
repo=$(dh_repo "$image") || return 1
curl -s -m 25 "https://hub.docker.com/v2/repositories/${repo}/tags/${tag}" \
| jq -r '.digest // empty' 2>/dev/null
}
save_state() {
local tmp
tmp=$(mktemp)
jq --arg s "$1" --arg v "$2" '.[$s] = $v' "$STATE_FILE" > "$tmp" && mv "$tmp" "$STATE_FILE"
}
checked=0; skipped=0; found=0; baseline=0
notify() { # service image current target ct
local payload
payload=$(jq -n \
--arg s "$1" --arg i "$2" --arg c "$3" --arg n "$4" --arg ct "$5" \
'{service:$s, image:$i, current_version:$c, new_version:$n, ct:$ct}')
curl -s -m 20 -X POST -H 'Content-Type: application/json' \
-d "$payload" "$N8N_WEBHOOK" >/dev/null
}
# --- Основной цикл ----------------------------------------------------------
pinned=0; floating=0; skipped=0; baseline=0; found=0
for service in $(jq -r 'keys[]' "$VERSIONS_FILE"); do
image=$(jq -r --arg s "$service" '.[$s].image // empty' "$VERSIONS_FILE")
current=$(jq -r --arg s "$service" '.[$s].stable_tag // empty' "$VERSIONS_FILE")
ct=$(jq -r --arg s "$service" '.[$s].ct // empty' "$VERSIONS_FILE")
[ -n "$image" ] || continue
if ! is_semver "$current"; then
log "пропуск $service: плавающий тег '$current' — версия не определяется"
skipped=$((skipped + 1))
continue
fi
checked=$((checked + 1))
latest=$(latest_stable_tag "$image")
[ -n "$latest" ] || { log "не удалось узнать версию $image"; continue; }
[ -n "$current" ] || continue
seen=$(jq -r --arg s "$service" '.[$s] // empty' "$STATE_FILE")
# Первый запуск: фиксируем базу, не уведомляя.
if is_semver "$current"; then
# Режим 1: закреплённый тег — ищем новую версию.
key=$(latest_stable_tag "$image")
[ -n "$key" ] || { log "нет данных Docker Hub: $image"; skipped=$((skipped+1)); continue; }
value="ver:$key"
human="$key"
pinned=$((pinned+1))
else
# Режим 2: плавающий тег — следим за контрольной суммой.
key=$(tag_digest "$image" "$current")
[ -n "$key" ] || { log "нет данных Docker Hub: $image:$current"; skipped=$((skipped+1)); continue; }
key="sha256:${key#sha256:}"
value="dig:$key"
human="${current} (обновлён)"
floating=$((floating+1))
fi
if [ -z "$seen" ]; then
save_state "$service" "$latest"
baseline=$((baseline + 1))
[ "$latest" = "$current" ] && continue
log "базовая версия $service: зафиксировано $current, доступно $latest (уведомление со следующего изменения)"
save_state "$service" "$value"
baseline=$((baseline+1))
continue
fi
[ "$latest" = "$seen" ] && continue
[ "$value" = "$seen" ] && continue
log "обновление: $service $current -> $latest ($image)"
payload=$(jq -n \
--arg s "$service" --arg i "$image" \
--arg c "$current" --arg n "$latest" --arg ct "$ct" \
'{service:$s, image:$i, current_version:$c, new_version:$n, ct:$ct}')
if curl -s -m 20 -X POST -H 'Content-Type: application/json' \
-d "$payload" "$N8N_WEBHOOK" >/dev/null; then
save_state "$service" "$latest"
found=$((found + 1))
log "изменение: $service — было ${seen%%:*}, стало ${human} ($image)"
if notify "$service" "$image" "$current" "$human" "$ct"; then
save_state "$service" "$value"
found=$((found+1))
else
log "не удалось отправить уведомление для $service"
fi
done
log "[$LOG_TAG] проверено: $checked, пропущено (плавающий тег): $skipped, база зафиксирована: $baseline, новых обновлений: $found"
log "[$LOG_TAG] закреплённых: $pinned, плавающих: $floating, без данных: $skipped, база: $baseline, изменений: $found"
exit 0
+33 -1
View File
@@ -1 +1,33 @@
{}
{
"adguard": "dig:sha256:aba9e3bf0613be3ba3755e1fc311b126e2c24bec25e18b6483894a88283074f0",
"authentik-security-redis-1": "dig:sha256:858f009f9709ce576febc734aa78b8f6d624b82571f9ddb6bda4377c833b3499",
"calibre-web": "dig:sha256:5dcbcb381d29c4ccb2236910eb547679f482c3eb1c9e458138729e89eceb4774",
"dashy": "dig:sha256:a877dd3d182b8d6b57aedbd879f2d1c0e76771be3ee54ff1ef4a8a725a09ed11",
"duplicati": "dig:sha256:e32e280cc30e98ac5cea8d2b339cd19810b1b39e638fb9d39253786630104de0",
"element-web": "dig:sha256:041550f9000bf31ab96a622e35c47d604a0e7c343da4e3c8f69f00638cd5adbe",
"files_db": "ver:13.0.2",
"firefly": "dig:sha256:a2b53539338d1cd04d341b229c3806cb178cf64c72459060e3ed34bec4167bd8",
"freshrss": "dig:sha256:48b63b9bc3d042a1301c32971b01af8841c7f059b452589c5bf77f475ba44c61",
"grafana": "dig:sha256:dbbc38ea21103cefb50396340cd88afec779c7e070b0a7bf5a75b4ce46651d3f",
"jellyfin": "dig:sha256:357724bf0ae27a672c7cbaa899db2d9abeb13dbd8657ccce750258a4c059d037",
"linkding": "dig:sha256:e35cb50e0581178f245125ffaa909c565416c94c9f22ace305a7d234a4345522",
"livekit": "dig:sha256:89ca9ce0791e18d6e03bf6e2c49ceb27e1c754eae8bd50c989386c1a5963791a",
"matrix-coturn": "dig:sha256:bbefd3e1fdfdc0d58770fe01b581fd8b00d9f3a5580d00acb77cf719a6bc78e3",
"matrix-synapse": "dig:sha256:abeb932f2a9293fcbb886d5ddd0f55a34d532708ebb8dc5642934dd91ca26237",
"mosquitto": "dig:sha256:38c0da4f2ef84284d47b3b3eeea1cb3bdeabe81ee10caf0cd5c5ff61ee3ea408",
"n8n": "dig:sha256:4fc4c67bf5fb990201a71d94c7070abf8dd0619cb8af1d059877a447f3640392",
"nats": "dig:sha256:b7752304692bc0612b7fbae6add53cdd14059ec83cad1795d78edade6025ef07",
"navidrome": "dig:sha256:38dc2727bfcfd5ede290f8ada114fc90368146f265ae4701ddddbcbe2a44ee52",
"nextcloud": "dig:sha256:8f2f0e93aca5e9457019933936dea1f313052e72c696b4aecb31580a208b859f",
"node_red": "dig:sha256:b5adb6c9dd29ab80c852d82bc87daed84e729dcff9b00ca1bf958e6de470f2c1",
"npm-app-1": "dig:sha256:4393e642e233e5efd5adeb7f10918d4aaea71c9ed875b94190273fc8e87f9594",
"paperless_redis": "dig:sha256:858f009f9709ce576febc734aa78b8f6d624b82571f9ddb6bda4377c833b3499",
"plex": "dig:sha256:06e07af2851e6a822e89062b148435495dd794d6d5aaf36247dee05fb3dcc4b8",
"prometheus": "dig:sha256:efd719c99d83b060d9daefdcf00360461adf279f45ef5391f8d111892118753e",
"swarm-redis": "dig:sha256:858f009f9709ce576febc734aa78b8f6d624b82571f9ddb6bda4377c833b3499",
"syncthing": "dig:sha256:4d0281bdcb4ed9baf503d251d0544ddd856f49fce3f114056257ae172b7fb670",
"tautulli": "dig:sha256:a4323bc09b27e265e269d79421ed3eb795083ef988bb84788eba89e5738c8005",
"uptime_kuma": "dig:sha256:70233f4acb5163fd2a59a49909cf01e44415cecff13dba69e3a86647a2919f83",
"vaultwarden": "dig:sha256:efb3cde962015fcc036b2ea625242248611943b27212ebf4392841fb30fad055",
"zigbee2mqtt": "dig:sha256:addbfb08fcef2e4477de1535636118241e10d13e898fbe4d9faba8a4d7396311"
}