89 lines
4.2 KiB
Markdown
89 lines
4.2 KiB
Markdown
# 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 проверен.
|