Добавлены новые документы и инструкции по настройке, использованию и тестированию SSL сертификатов Let's Encrypt с использованием API reg.ru. Обновлены зависимости в requirements.txt для поддержки новых функций. Включены подробные шаги по автоматизации, созданию и продлению сертификатов, а также интеграции с Nginx Proxy Manager.

2025-10-28 13:01:05 +03:00
parent 70c9932554
commit ed4531fa64
40 changed files with 4027 additions and 15 deletions
--- a/docs/ru/RELEASE_GUIDE.md
+++ b/docs/ru/RELEASE_GUIDE.md
@@ -0,0 +1,173 @@
+# 🎯 Краткое руководство: Автоматические релизы
+
+## Для GitHub
+
+### 1. Создание релиза
+
+```bash
+# Создать тег
+git tag -a v1.0.0 -m "Release version 1.0.0"
+
+# Отправить тег
+git push origin v1.0.0
+```
+
+### 2. Что произойдет автоматически
+
+GitHub Actions запустит `.github/workflows/build-release.yml`:
+
+1. ✅ Сборка Linux версии (Ubuntu runner)
+2. ✅ Сборка Windows версии (Windows runner)
+3. ✅ Создание пакетов
+4. ✅ Генерация SHA256 checksums
+5. ✅ Создание GitHub Release
+6. ✅ Загрузка артефактов
+
+### 3. Результат
+
+Релиз появится на: `https://github.com/USER/REPO/releases/tag/v1.0.0`
+
+**Файлы:**
+- `letsencrypt-regru-linux-x86_64.tar.gz`
+- `letsencrypt-regru-linux-x86_64.tar.gz.sha256`
+- `letsencrypt-regru-windows-x86_64.zip`
+- `letsencrypt-regru-windows-x86_64.zip.sha256`
+
+---
+
+## Для Gitea
+
+### 1. Настройка (один раз)
+
+#### Включить Actions в Gitea:
+
+Отредактируйте `app.ini`:
+
+```ini
+[actions]
+ENABLED = true
+DEFAULT_ACTIONS_URL = https://gitea.com
+```
+
+#### Установить Gitea Runner:
+
+```bash
+# Скачать
+wget https://dl.gitea.com/act_runner/latest/act_runner-linux-amd64 -O act_runner
+chmod +x act_runner
+
+# Зарегистрировать
+./act_runner register --no-interactive \
+  --instance https://your-gitea.com \
+  --token YOUR_RUNNER_TOKEN
+
+# Запустить
+./act_runner daemon
+```
+
+### 2. Создание релиза
+
+```bash
+# Создать тег
+git tag -a v1.0.0 -m "Release version 1.0.0"
+
+# Отправить тег
+git push origin v1.0.0
+```
+
+### 3. Что произойдет
+
+Gitea Actions запустит `.gitea/workflows/release.yml`:
+
+1. ✅ Сборка Linux версии
+2. ✅ Сборка Windows версии
+3. ✅ Создание пакетов
+4. ✅ Генерация SHA256 + MD5 checksums
+5. ✅ Создание Gitea Release
+6. ✅ Детальные release notes
+
+### 4. Результат
+
+Релиз появится на: `https://your-gitea.com/USER/REPO/releases/tag/v1.0.0`
+
+---
+
+## 🔧 Проверка перед релизом
+
+```bash
+# 1. Локальная сборка
+make clean-build
+make release
+
+# 2. Тестирование
+make test-build
+
+# 3. Проверка файлов
+ls -lh dist/
+
+# 4. Если все OK - создать тег
+git tag -a v1.0.0 -m "Release 1.0.0"
+git push origin v1.0.0
+```
+
+---
+
+## 📊 Мониторинг
+
+### GitHub:
+`https://github.com/USER/REPO/actions`
+
+### Gitea:
+`https://your-gitea.com/USER/REPO/actions`
+
+---
+
+## 🐛 Если что-то пошло не так
+
+### Удалить тег и релиз:
+
+```bash
+# Удалить локальный тег
+git tag -d v1.0.0
+
+# Удалить удаленный тег
+git push --delete origin v1.0.0
+
+# Удалить релиз вручную через веб-интерфейс
+```
+
+### Пересоздать релиз:
+
+```bash
+# Исправить проблему
+git commit -am "Fix build"
+
+# Пересоздать тег
+git tag -a v1.0.0 -m "Release 1.0.0" --force
+git push origin v1.0.0 --force
+```
+
+---
+
+## 📝 Semantic Versioning
+
+```bash
+# Major (несовместимые изменения)
+git tag v2.0.0
+
+# Minor (новые функции)
+git tag v1.1.0
+
+# Patch (исправления)
+git tag v1.0.1
+
+# Pre-release
+git tag v1.0.0-beta.1
+git tag v1.0.0-rc.1
+```
+
+---
+
+**См. также:**
+- [.gitea/README.md](.gitea/README.md) - Полная документация по Gitea Actions
+- [BUILD_GUIDE.md](BUILD_GUIDE.md) - Руководство по сборке