Add restore validation report

RESTORE_VALIDATION.md

@@ -0,0 +1,88 @@
+# Gitea Helm Chart And Restore Validation
+
+Дата проверки: 2026-05-06
+
+## Что входит в чарт
+
+Чарт расположен в `gitea/.helm` и ставится как release `gitea` в namespace `gitea`.
+
+- Gitea `gitea/gitea:1.22.6`.
+- Gitea runner `gitea/act_runner:0.2.11`.
+- PostgreSQL через dependency `postgresql-preprod:16.4.8` из `cr.yandex/crp3ccidau046kdj8g9q/charts/postgresql-preprod`.
+- `universal-chart:0.1.9` используется для runner.
+- Для Gitea используется статический Deployment template, потому что нужны sidecar containers для файлового backup без Multi-Attach PVC.
+- Ingress/VirtualService в чарте нет, внешний routing остается в отдельном чарте.
+- Чувствительные значения не лежат в `values.yaml`; секреты берутся из `gitea-secret`/`postgresql-secret`, шаблон секрета использует `lookup` и generated fallback values.
+
+## Backup
+
+Файлы Gitea backup:
+
+- Реализованы sidecar containers в pod Gitea.
+- `gitea-files-archive` читает `/data` read-only и собирает архив во временный `emptyDir`.
+- `gitea-files-upload` отправляет архив в S3.
+- Такой режим не монтирует `gitea-data` во второй pod и не ловит Multi-Attach на RWO PVC.
+
+PostgreSQL backup:
+
+- В чарте есть `CronJob/gitea-postgresql-backup`.
+- Dump создается через `pg_dump` пользователем `gitea`.
+- Upload идет в S3 через `amazon/aws-cli:2.15.57`.
+
+Использованные S3 keys:
+
+- Files: `gitops-backups/gitea-files/gitea-files-2026-05-06-145356.tar.gz`
+- PostgreSQL: `gitops-backups/postgresql/gitea-postgresql-2026-05-06-145822.sql.gz`
+
+## Restore
+
+Restore запускается через `helm upgrade --install` с отдельным values-файлом:
+
+- `restore.enabled=true`
+- `restore.files.enabled=true`
+- `restore.postgresql.enabled=true`
+- `restore.s3.giteaFilesKey=<files backup key>`
+- `restore.s3.postgresqlDumpKey=<postgresql dump key>`
+
+Restore hook делает:
+
+- scale down Deployment `gitea`;
+- скачивание backup archives из S3;
+- очистку `/data` и распаковку файлового backup;
+- drop schema `public` в базе `gitea`;
+- restore SQL dump через пользователя `gitea`;
+- verification количества public tables и core tables;
+- scale up Deployment `gitea`.
+
+## Проверка
+
+Проверено на `yc-infra-prod`, namespace `gitea`.
+
+- Release `gitea` установлен заново после полной очистки namespace/PVC/PV.
+- Pods после чистой установки: `gitea`, `gitea-ci-worker`, `postgresql-0`.
+- Создан admin user `bootstrap`.
+- Создан access token для API/git push.
+- В свежий Gitea запушен репозиторий `bootstrap/gitea`.
+- В репозиторий добавлен workflow `.gitea/workflows/trash-ci.yaml`.
+- Runner зарегистрирован через generated registration token.
+- Runner объявился с labels `linux-amd64` и `linux-shell`.
+- CI task по `bootstrap/gitea` был принят runner.
+- Тестовые файлы для restore созданы в `/data/backup-test` и `/data/gitea/custom/backup-test`.
+- Файловый backup отправлен в S3.
+- PostgreSQL backup вручную запущен из существующего `CronJob/gitea-postgresql-backup`.
+- Restore запущен через `helm upgrade --install`.
+- Restore job завершился успешно.
+- Verification restore job: `110 public tables`, `3 core tables`.
+- После restore Gitea API вернул `bootstrap/gitea|main`.
+- После restore на PVC найдены:
+  - `/data/backup-test/blob.bin`
+  - `/data/backup-test/generated-at.txt`
+  - `/data/gitea/custom/backup-test/marker.txt`
+  - `/data/git/repositories/bootstrap/gitea.git`
+- После restore в базе:
+  - `users=1`
+  - `repos=1`
+  - repository `bootstrap/gitea`
+  - action runs `1` и `2`
+
+Итог: полный цикл install, runner, CI, backup files, backup PostgreSQL и restore из S3 проверен.