Files
gitea-server/README.md
S.Gromov 1753d0871a Добавлена поддержка PostgreSQL и автоматические бэкапы в S3 для Gitea
- Добавлены переменные окружения для PostgreSQL в env.example.
- Обновлен README.md с описанием новых возможностей: автоматические бэкапы и интеграция PostgreSQL.
2025-10-23 22:33:28 +03:00

3.7 KiB
Raw Blame History

Gitea Server

Docker-окружение для развертывания Gitea с PostgreSQL, интеграцией S3 и автоматическими бэкапами.

Возможности

⚠️ Ограничение: Container Registry требует https, не работает в локальном режиме.

Оглавление

  1. Быстрый старт
  2. Автоматические бэкапы в S3
  3. Настройка ранеров
  4. Устранение проблем

Быстрый старт

1. Конфигурация

cp env.example .env

Отредактируйте .env, укажите пароли и S3 креденшелы (опционально).

2. Запуск

docker-compose up -d

Сервер доступен по адресу http://127.0.0.1:8080.

3. Первичная настройка

При первом входе укажите:

  • Название сайта
  • Логин и пароль администратора
  • Опционально: капча, регистрация, другие настройки

Автоматические бэкапы в S3

Используется решение docker-s3-backup — элегантный способ бэкапа всего проекта (база данных + файлы).

Настройка

  1. В .env укажите S3 креденшелы:
S3_ENDPOINT=storage.yandexcloud.net
S3_ACCESS_KEY=ваш_ключ
S3_SECRET_KEY=ваш_секрет
S3_BUCKET=ваш_бакет
  1. Сервис backup автоматически:

    • Останавливает Gitea и PostgreSQL перед бэкапом
    • Создает архив всего проекта (база данных + файлы)
    • Загружает в S3 (папка gitea-backups/)
    • Запускает сервисы обратно
  2. Расписание настраивается в docker-compose.yaml (по умолчанию ежедневно в 05:00).

Восстановление

Просто скачайте архив из S3 и разархивируйте — всё готово к запуску.


Настройка ранеров

Gitea Actions ранеры находятся в отдельном репозитории: gromov-io/gitea-runner

Быстрая настройка:

  1. Перейдите в админ-панель: http://127.0.0.1:8080/-/admin/actions/runners/
  2. Нажмите "Создать новый раннер" и скопируйте токен
  3. Следуйте инструкциям в репозитории gitea-runner

Устранение проблем

Изменения в .env не применяются

Пересоздайте контейнеры:

docker-compose down
docker-compose up -d --force-recreate

Сброс настроек

Для полного сброса удалите данные:

docker-compose down
sudo rm -rf data/ postgres-data/