- Introduced `ci` type in `.releaserc.json` for patch releases.
- Updated conventional commits documentation to reflect the new `ci` type and its implications for versioning.
- Clarified the role of `ci` in the context of patch releases in the releasing guide.

Co-authored-by: Cursor <[email protected]>

2026-05-20 15:24:21 +07:00

4.3 KiB

Raw Permalink Blame History

Релизы и версионирование EvoBGP

EvoBGP использует Conventional Commits и semantic-release для полностью автоматических релизов на Gitea (git.shts.su). Ручное повышение версии в коде не требуется.

Как определяется версия

Тип коммита	Bump
`feat`	minor (1.0.0 → 1.1.0)
`fix`, `perf`, `ci`	patch (1.5.1 → 1.5.2)
`feat!`, `fix!` или `BREAKING CHANGE:` в теле	major (1.0.0 → 2.0.0)
`docs`, `chore`, `test`, `refactor`	без релиза

Отдельного суффикса 1.x.y.fix в semver нет: «fix» в Conventional Commits означает patch (третья цифра). Для починки пайплайна без смены продукта — fix(ci): или ci: (оба дают patch после настройки .releaserc.json).

Первый релиз при отсутствии git-тегов — 1.0.0, если есть releasable-коммиты.

Как не перепутать feat и fix: см. раздел «Выбор type: semver, а не «красивые слова»» в .cursor/rules/conventional-commits.mdc. Кратко: feat — новая возможность (minor); fix — починка ожидаемого поведения (patch); follow-up баги после недавнего feat — всегда fix, даже если diff большой.

Подробные правила сообщений коммитов: .cursor/rules/conventional-commits.mdc.

CI-пайплайн (один push в main)

push/merge в main
  → CI: openapi, web, go, bird2 (параллельно)
  → job release (в том же workflow, после quality gates):
       → semantic-release: git tag vX.Y.Z на текущий commit (без доп. commit)
       → Gitea Release + CHANGELOG.md как attachment
       → docker buildx bake с VERSION=X.Y.Z
       → образы: latest, vX.Y.Z, X.Y.Z, sha-*, короткий SHA

Pull request: только quality gates + commitlint; релиз и образы не публикуются.

Workflow: .gitea/workflows/ci.yaml (job release).

Конфиг semantic-release: .releaserc.json — без @semantic-release/git (CHANGELOG не коммитится в репозиторий).

Секреты Gitea

Один PAT — ACTIONS_PAT (Settings → Actions → Secrets).

Право PAT	Зачем
push tags	git tag `vX.Y.Z` на commit merge
releases	Gitea Release + notes
packages (Container Registry)	push образов

Fallback: gitea.token (нужны права на releases и packages).

Источник правды для версии в runtime

Semver из git-тега пробрасывается в Go-бинарники через -ldflags при сборке Docker (deploy/docker/gobinary/Dockerfile). Пакет internal/version:

локально (go run) — version: "dev"
в образе после релиза — совпадает с тегом (например 1.2.3)

API: GET /version, GET /v1/version — поля version, git_sha, build_time.

Web UI показывает версию из API (footer sidebar, страница «Мониторинг»).

CHANGELOG

Release notes — в Gitea Release; файл CHANGELOG.md генерируется в CI и прикрепляется как asset, не попадает в git history.

Проверка после релиза

Один run workflow CI на push в main: job release зелёный.
Gitea: тег vX.Y.Z на том же commit, что и merge; Release с notes.
Container Registry: evobgp-api:vX.Y.Z, evobgp-api:X.Y.Z, evobgp-api:latest.
curl http://localhost:8080/version → "version":"X.Y.Z".

Первый релиз (bootstrap)

Merge в main с feat(release): ... → v1.0.0 в том же CI run.

4.3 KiB Raw Permalink Blame History Unescape Escape