f0030 - Release-Automatisierung — Release bei jedem Merge auf `main`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/f-cicd-automatisierung/f0030-release-automation.md
Release-Automatisierung — Release bei jedem Merge auf main
Jeder Push auf main (also jeder gemergte Pull Request) löst automatisch einen semantic-release-Lauf aus, der — falls die Commits seit dem letzten Tag das rechtfertigen — eine neue Versionsnummer vergibt, CHANGELOG.md fortschreibt, einen Git-Tag vX.Y.Z setzt und ein GitHub-Release mit Release Notes veröffentlicht. Der Ablauf ist für alle Repos von pkr-lab derselbe und liegt zentral im Repo pkr-lab/.github (github-workflows); capulus-core ruft ihn nur auf.
Warum das funktioniert, ohne extra Konfiguration pro Commit
Die Commit-Historie folgt Conventional Commits (feat(app): …, fix(app): …). semantic-release liest das Präfix, um die nächste Version zu bestimmen:
| Commit-Präfix | Versions-Bump |
|---|---|
fix: ... |
Patch (1.2.3 → 1.2.4) |
feat: ... |
Minor (1.2.3 → 1.3.0) |
feat!: ... oder BREAKING CHANGE: im Footer |
Major (1.2.3 → 2.0.0) |
alles andere (docs:, chore:, refactor:, test:, ci:, …) |
kein Release |
Ein Check (commitlint) prüft auf Pull Requests, dass alle Commits dieses Format haben. Lokal macht make hooks den commit-msg-Hook aktiv.
Architektur
git push origin main (per Merge)
│
▼
.github/workflows/release.yml (Aufrufer in capulus-core)
│ uses: pkr-lab/.github/.github/workflows/release.yml@<sha>
▼
semantic-release (Konfiguration wird zentral erzeugt)
│
├── commit-analyzer, release-notes-generator → Version und Notes
├── changelog → CHANGELOG.md
├── git → Commit "chore(release): X.Y.Z [skip ci]"
└── github → Tag vX.Y.Z + GitHub-Release
Aufrufer: .github/workflows/release.yml. Eine eigene .releaserc.json gibt es in capulus-core nicht mehr.
Was das NICHT tut
- Kein Einfluss auf ArgoCD/Deployment. ArgoCD trackt weiterhin
targetRevision: maindirekt (siehe capulus-ansible/a-betriebssystem/a0010-overview.md). Releases sind Versionshistorie, kein Deployment-Gate. - Kein
npm publish. Dieses Repo ist kein npm-Paket. - Keine Release-Dateien und keine Images. Die Workload-Images baut
build-images.ymlgetrennt (sha-<commit>). - Der CHANGELOG-Commit braucht Schreibrecht auf
main. Ist ein Ruleset aktiv, das Pushes ohne Pull Request verbietet, muss GitHub Actions dort eine Ausnahme bekommen.
Troubleshooting
| Symptom | Hinweis |
|---|---|
Kein Release trotz feat:-Commit |
Präfix exakt Conventional-Commits-Syntax (feat: ..., nicht Feat: oder feature:); der Commit muss nach dem letzten Tag liegen |
| Workflow schlägt mit 403/permission-Fehler fehl | Der Aufrufer braucht contents: write, issues: write, pull-requests: write, packages: write; zusätzlich darf main den CHANGELOG-Commit annehmen |
| Mehrere Commits, aber nur ein Release | Erwartetes Verhalten: semantic-release fasst alle Commits seit dem letzten Tag zusammen |
| Fehler bei den Preset-Paketen | siehe Fehlersuche in github-workflows |
| Workflow-Lauf ansehen | GitHub-Repo → Actions → Release |