Repository navigation
chore(ci): bound GHCR sha-* retention (#11) - #83
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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) версиядля матчинга формируется так:
metadata.container.tagsaction не читает вообще. А нашdockerjob пушитapi+sha-<12 hex>как один и тот же манифест (на релизе ещёv*иlatest), т.е. защищённый тег живёт на версии, которую поnameне отличить(
nameдля container-версий не документирован и тегом не гарантирован).Ошибка в регулярке → удаление версии-носителя
api/latest/v0.24.13,и мы теряем точку входа, на которую ссылаются пользователи. Проверить
фактическое значение
nameв нашем пакете нельзя: у токена нетread:packages, API отвечает403(и анонимно —401).Поэтому вместо action — один шаг с GitHub REST API, который решает задачу
по полному списку тегов версии:
Как защищены
latest/api/v*Кандидат на удаление — версия, у которой все теги матчатся
^sha-[0-9a-f]{12}$, и только если она не входит в 20 самых новых таких версий.Любая версия, несущая хотя бы один не-
shaтег, в список удаления не попадаетструктурно, независимо от того, что вернёт API. Дополнительно:
sha-*;/tmp/delete.txtпопадётстрока не вида
<id> sha-…[,sha-…], job падает до первогоDELETE;а не «успешно» ничего не делаем;
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@v4deprecated, SC1007/SC2086/SC2129 в старых шагах).Новый
run:shellcheck-чистый;yq -o=jsonпарсится без ошибок;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 упадёт с числом неудачных удалений (данные не теряются,ничего лишнего не удаляется).
тогда retention просто не идёт; ручной
workflow_dispatchработает./orgs/-эндпоинта(сейчас owner — user
eSlider, эндпоинт зафиксирован комментарием).sha-*(≈27 версий). Если какая-то из нихкому-то нужна для отладки — скажите до мержа, поднимем
KEEP.