Skip to content

chore(ci): bound GHCR sha-* retention (#11) - #83

Merged
eSlider merged 1 commit into
mainfrom
chore/ghcr-retention-11
Nov 11, 2026
Merged

eSlider merged 1 commit into
mainfrom
chore/ghcr-retention-11

Conversation

@eSlider

@eSlider eSlider commented Nov 11, 2026

Copy link
Copy Markdown
Owner

Closes #11 (epic #12). Только .github/workflows/ci.yml.

Что добавлено

Новый job retention — раз в неделю (cron: '17 3 * * 1') плюс существующий
workflow_dispatch (без новых inputs). Guard: github.server_url == 'https://github.com',
поэтому на Gitea job не запускается.

Почему не actions/delete-package-versions@v5

Задача допускала этот action, но его ignore-versions не может защитить
api/latest/v* в нашем случае. В src/version/get-versions.ts (v5) версия
для матчинга формируется так:

version: version.name          // ← только поле name

metadata.container.tags action не читает вообще. А наш docker job пушит
api + sha-<12 hex> как один и тот же манифест (на релизе ещё v* и
latest), т.е. защищённый тег живёт на версии, которую по name не отличить
(name для container-версий не документирован и тегом не гарантирован).
Ошибка в регулярке → удаление версии-носителя api/latest/v0.24.13,
и мы теряем точку входа, на которую ссылаются пользователи. Проверить
фактическое значение name в нашем пакете нельзя: у токена нет
read:packages, API отвечает 403 (и анонимно — 401).

Поэтому вместо action — один шаг с GitHub REST API, который решает задачу
по полному списку тегов версии:

gh api --paginate "/users/$OWNER/packages/container/2dph/versions?per_page=100" \
  --jq '.[] | {id, created_at, tags: (.metadata.container.tags // [])}'

Как защищены latest / api / v*

Кандидат на удаление — версия, у которой все теги матчатся
^sha-[0-9a-f]{12}$, и только если она не входит в 20 самых новых таких версий.
Любая версия, несущая хотя бы один не-sha тег, в список удаления не попадает
структурно, независимо от того, что вернёт API. Дополнительно:

  • untagged-версии не трогаем (только логируем) — scope строго sha-*;
  • перед удалением — «belt and braces» проверка: если в /tmp/delete.txt попадёт
    строка не вида <id> sha-…[,sha-…], job падает до первого DELETE;
  • если листинг вернул 0 версий — падаем (значит нет прав / пакет не тот),
    а не «успешно» ничего не делаем;
  • все неудачные DELETE считаются, в конце job краснеет с числом.

Сколько остаётся

20 последних sha-* версий + все версии с api/latest/v* + untagged.
Сейчас в GHCR ~47 sha-*, т.е. первый прогон удалит ~27 (лимит action'а в
100 версий за прогон неактуален — здесь пагинация без ограничения, но объём
маленький).

OCI labels (title/source/revision/version/created) — на месте, шов не тронут.
Release / docker / smoke / backfill не изменены.

Что ещё поправлено (иначе schedule ломал бы CI)

  • schedule стартует весь workflow, поэтому guard, test, secret-scan
    (и ocr) получили if: ... github.event_name != 'schedule' — в понедельник
    ночью гоняется только retention, а не 30-минутный test;
  • concurrency.group получил суффикс по событию
    (...-${{ github.event_name == 'schedule' && 'retention' || 'ci' }}):
    иначе weekly-прогон с cancel-in-progress: true на той же группе
    ci-refs/heads/main отменял бы идущий push-ран, в т.ч. в середине
    docker push. Для push/PR ключ группы не меняется по смыслу.

Как запустить вручную

Actions → Tests → Run workflow (ветка main, любой прогон
workflow_dispatch, release/backfill_version можно оставить пустыми) —
job Retention (GHCR sha-* versions) выполнится вместе с обычным CI.
Секретов не требуется: GITHUB_TOKEN + permissions: packages: write
(пакет привязан к репозиторию, поэтому токен имеет admin на него).

Проверки

  • yq '.jobs | keys' → guard, test, secret-scan, ocr, release, docker, smoke, backfill, retention;
  • actionlint v1.7.12 — новых замечаний нет; остаются только те, что уже есть
    на main (setup-go@v4 deprecated, SC1007/SC2086/SC2129 в старых шагах).
    Новый run: shellcheck-чистый;
  • YAML: yq -o=json парсится без ошибок;
  • логика удаления прогнана локально на синтетическом наборе (52 версии:
    47 sha-* + latest/v*/sha/api + старый latest/v*/sha + untagged +
    sha-ABCDEF012345): удалено 28 самых старых sha-*, оставлено 20,
    ни одна версия с api/latest/v*, untagged или не-sha тегом не тронута;
    кейсы «меньше 20 версий» (0 удалений) и «пустой пакет» (осознанный fail)
    проверены; stub-gh пишет только DELETE, сеть не использовалась.

Риски

  • GITHUB_TOKEN без delete:packages (PAT-scope) — удаление возможно, т.к.
    пакет привязан к репо и токену выдано packages: write; если GitHub начнёт
    отвечать 403, job упадёт с числом неудачных удалений (данные не теряются,
    ничего лишнего не удаляется).
  • Schedule отключается GitHub'ом после 60 дней неактивности репо —
    тогда retention просто не идёт; ручной workflow_dispatch работает.
  • Переход владельца пакета в организацию потребует /orgs/-эндпоинта
    (сейчас owner — user eSlider, эндпоинт зафиксирован комментарием).
  • Первый прогон удалит исторические sha-* (≈27 версий). Если какая-то из них
    кому-то нужна для отладки — скажите до мержа, поднимем KEEP.

Add a weekly retention job that deletes old sha-<12 hex> image versions and
keeps the newest 20. Only versions whose complete tag list is sha-* are
candidates, so api/latest/v* can never be deleted.

actions/delete-package-versions is not used: it matches ignore-versions
against the version's name field only, never against metadata.container.tags,
and this workflow pushes api + sha-* as the same manifest.

The schedule event runs the retention job only (guard/test/secret-scan/ocr
are skipped) and uses its own concurrency group so it cannot cancel a CI run.
@eSlider
eSlider merged commit 049c17e into main Nov 11, 2026
9 checks passed
@eSlider
eSlider deleted the chore/ghcr-retention-11 branch November 11, 2026 16:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant