Release Automation

Ordinis uses semantic-release для автоматического создания tag'ов на основе conventional commits. После merge в main CI анализирует commits, решает bump (patch/minor/major), генерирует CHANGELOG.md и пушит tag vX.Y.Z.

Tag pipeline далее собирает images и ждёт manual gate на trigger-deploy-prod. Prod deploy остаётся под human control — semantic-release создаёт tag, human кликает Deploy.

One-time setup

Create Project Access Token (GitLab UI):
- Settings → Access Tokens → Add new token
- Name: semantic-release
- Role: Maintainer
- Scopes: write_repository, api
- Expiry: 1 год (renew annually)
Add CI variable:
- Settings → CI/CD → Variables → Add variable
- Key: GITLAB_TOKEN
- Value: (token из шага 1)
- Type: Variable
- Flags: Masked ✅, Protected ✅ (только main + tag pipelines)

После этого release job в .gitlab-ci.yml будет работать.

Commit conventions

Conventional Commits (https://www.conventionalcommits.org/):

Type	Bump	Section в CHANGELOG
`feat:`	minor	✨ Features
`fix:`	patch	🐛 Fixes
`perf:`	patch	⚡ Performance
`refactor:`	patch	♻️ Refactoring
`revert:`	patch	⏪ Reverts
`docs:`	none	📝 Docs
`chore:`	none	hidden
`test:`	none	hidden
`style:`	none	hidden
`ci:`	none	hidden
`build:`	none	hidden

Breaking changes — добавь BREAKING CHANGE: в footer commit message → major bump.

feat(api): drop legacy v1 endpoint

BREAKING CHANGE: /api/v1/* paths больше не поддерживаются.
Все клиенты должны мигрировать на /api/v2.

⚠ Lesson learned (v2.0.0 false-major): до 2026-05-12 в .releaserc.json noteKeywords содержал bare "BREAKING". Слово «Breaking» в обычном commit body (например «Breaking down PATCH into atomic ops…») триггерило major bump. Конфиг исправлен — оставлены только canonical BREAKING CHANGE / BREAKING CHANGES. Когда нужен major — используй точно эти триггеры в footer.

Skip release for specific commit

Если хочешь смержить feat: или fix: но не делать release сейчас — добавь [skip ci] в commit message ИЛИ используй non-release type (chore:, docs:, etc).

chore(deps): bump axios 1.7 -> 1.8

Loop prevention

Release job создаёт commit chore(release): vX.Y.Z [skip ci]. [skip ci] — стандартный GitLab marker, новый pipeline не триггерится. Версия package.json

CHANGELOG.md обновляются в этом коммите.

Branch policy

Релизы создаются ТОЛЬКО с main. Feature branches (feat/*, fix/*) собираются для staging но НЕ создают tag'и. Релиз = merge в main + успешный staging deploy + наличие релизных commits.

Local dry-run

Проверить что semantic-release решит сделать без push:

cd ordinis-admin-ui
pnpm install
npx semantic-release --dry-run --no-ci

Покажет следующую версию + preview CHANGELOG entries.

Rollback

Если случайно зарелизили — удали tag:

git tag -d v1.3.1
git push origin :refs/tags/v1.3.1

GitLab Releases UI — удали release object отдельно.

3.7 KiB Raw Blame History