PKR-Lab

Releases

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/releases.md

Releases

Releases entstehen automatisch aus den Commit-Nachrichten. Der Prozess ist in allen Repos von pkr-lab gleich und läuft über die wiederverwendbaren Workflows im Repo pkr-lab/.github, beschrieben unter github-workflows.

Ablauf

  1. Änderungen kommen per Pull Request nach main. Der Check commitlint prüft, dass alle Commits des Pull Requests dem Format Conventional Commits folgen.
  2. Jeder Push auf main startet .github/workflows/release.yml. Der Workflow ruft den zentralen Release-Workflow auf (semantic-release).
  3. semantic-release bestimmt aus den Commits seit dem letzten Tag die nächste Version nach SemVer, schreibt CHANGELOG.md fort (Commit chore(release): X.Y.Z [skip ci]), setzt den Git-Tag vX.Y.Z und veröffentlicht ein GitHub-Release mit Release Notes.
Commit Wirkung
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)
docs:, chore:, refactor:, test:, ci:, build:, perf:, style: kein Release

Format: <typ>(<scope>): <beschreibung>, Der Typ und der Scope sind kleingeschrieben, die Beschreibung endet ohne Punkt, die Kopfzeile ist höchstens 120 Zeichen lang. Lokal prüft der Hook .githooks/commit-msg dasselbe; aktivieren mit git config core.hooksPath .githooks (oder make hooks).

Versionen

Die Versionierung beginnt bei v1.0.0. Die Tags v3.x stammen aus capulus-core und wurden nicht übernommen.

Artefakte

Pro Release hängt ein Tarball (capulus-ansible-vX.Y.Z.tar.gz, erzeugt mit git archive durch .github/release/build.sh) mit Playbooks, Rollen, Inventory und files/ am GitHub-Release. Vault-Werte sind darin verschlüsselt.

Änderungsprotokoll

CHANGELOG.md im Repo und die GitHub Releases.