docs(forgejo): document automated package prune retention policy
All checks were successful
CI Smoke / host-smoke (push) Successful in 11s
CI Smoke / container-smoke (push) Successful in 2s

Reference ACTIVITY-WP-0020 weekly prune lane and depth-3 retention.
This commit is contained in:
tegwick 2026-07-12 11:35:04 +02:00
parent 7d003a9d6c
commit a307041cac

View file

@ -64,12 +64,19 @@ Use for binaries, checksum files, and non-OCI release assets.
| Type | Storage | Backup | Cleanup |
| --- | --- | --- | --- |
| OCI | `/data/packages` in Forgejo PVC | `make forgejo-backup` (`forgejo dump`) | Delete unused tags in UI; no auto-prune yet |
| npm | same | same | `npm unpublish @coulomb/pkg@version` or UI package settings |
| generic | same | same | per-package UI delete |
| OCI | `/data/packages` in Forgejo PVC | `make forgejo-backup` (`forgejo dump`) | `make forgejo-package-prune` — keep **3** newest tags per package (weekly via activity-core) |
| npm | same | same | Same prune lane (`npm` type); manual `npm unpublish` still available |
| generic | same | same | Same prune lane (`generic` type) |
| PyPI | same | same | Same prune lane (`pypi` type) |
Package blobs are included in daily `forgejo dump` (~686M with 14 repos, 2026-07-07).
Restore drills must verify package metadata after isolated restore (T09).
**Protected tags:** production image tags pinned in `helm/*-values.yaml` and
`charts/*/values.yaml` are never deleted even when outside the top 3.
**Automation:** `activity-core` activity `weekly-forgejo-package-prune` (Sunday
03:30 UTC). Policy: `railiance-platform/docs/forgejo-package-prune.md`.
Package blobs are included in daily `forgejo dump` (~1.3G with registry growth,
2026-07-12). Restore drills must verify package metadata after isolated restore (T09).
RPO/RTO for package data matches Forgejo backup policy: 24h / 4h
(`the-custodian/docs/forgejo-production-decisions.md` § Backup).