Zum Inhalt springen

Schnellstart

  1. Installiere semrel

    Terminal-Fenster
    go install github.com/SemRels/semrel/cmd/semrel@latest
  2. Erstelle eine minimale Konfiguration

    Füge eine .semrel.yaml im Wurzelverzeichnis deines Repositorys hinzu oder starte den interaktiven Assistenten:

    Terminal-Fenster
    semrel config init

    Oder erstelle sie manuell:

    schemaVersion: 1
    branches:
    - name: main
    rules:
    - type: feat
    bump: minor
    - type: fix
    bump: patch
    - type: perf
    bump: patch
  3. Schreibe Commits mit Conventional Commits

    Terminal-Fenster
    git commit -m "feat: add user authentication"
    git commit -m "fix: correct token expiry calculation"
  4. Führe einen Dry-Run aus, um das Release vorzuschauen

    Terminal-Fenster
    semrel release --dry-run

    semrel zeigt dir die berechnete nächste Version und den erzeugten Changelog an, ohne Änderungen vorzunehmen:

    semrel v0.1.0 – release pipeline (dry-run=true, config=.semrel.yaml)
    Next version: v1.1.0
    Changelog:
    ## [1.1.0] – 2026-05-23
    ### Features
    - add user authentication
    ### Bug Fixes
    - correct token expiry calculation
  5. Führe das echte Release aus

    Terminal-Fenster
    semrel release

    semrel erstellt den git-Tag, veröffentlicht ein GitHub-/GitLab-Release (über das konfigurierte Provider Plugin) und löst alle Benachrichtigungs-Hooks aus.