configure_nginx_manager/docs/ru/RELEASE_GUIDE.md

🎯 Краткое руководство: Автоматические релизы

Для GitHub

1. Создание релиза

# Создать тег
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:

[actions]
ENABLED = true
DEFAULT_ACTIONS_URL = https://gitea.com

Установить Gitea Runner:

# Скачать
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. Создание релиза

# Создать тег
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

---

🔧 Проверка перед релизом

# 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

---

🐛 Если что-то пошло не так

Удалить тег и релиз:

# Удалить локальный тег
git tag -d v1.0.0

# Удалить удаленный тег
git push --delete origin v1.0.0

# Удалить релиз вручную через веб-интерфейс

Пересоздать релиз:

# Исправить проблему
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

# 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 Actions
• BUILD_GUIDE.md - Руководство по сборке