Files
configure_nginx_manager/docs/RELEASE_GUIDE.md
Dmitriy Fofanov 44f7ab1f5c
Синхронизация Wiki / Синхронизация Wiki (push) Successful in 3s
Добавлены новые документы и инструкции по автоматизации SSL сертификатов Let's Encrypt для reg.ru, включая:
- Структура проекта и основные скрипты (PROJECT_STRUCTURE.md)
- Быстрый старт сборки исполняемых файлов (QUICKSTART_BUILD.md)
- Автоматические релизы через GitHub и Gitea (RELEASE_GUIDE.md)
- Подробная инструкция по использованию скриптов (SSL_SCRIPTS_README.md)
- Руководство по тестированию SSL сертификатов (TESTING_GUIDE.md)
- Инструкции по настройке Nginx Proxy Manager с SSL (Настройке Nginx Manager с SSL .md)
- Создание и продление wildcard сертификата в Nginx Proxy Manager (Создание и продление SSL сертификата.md)
2026-02-25 01:42:29 +03:00

3.7 KiB

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

Для 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

См. также: