Von semantic-release zu semrel migrieren — Drop-in-Replacement-Guide
Diese Anleitung richtet sich an Teams, die von semantic-release auf semrel migrieren.
Mapping auf einen Blick
Abschnitt betitelt „Mapping auf einen Blick“| semantic-release Bereich | semrel Entsprechung |
|---|---|
| Commit-Analyzer-Plugins | @semrel/analyzer-conventional oder @semrel/analyzer-default |
| Release-Notes-/Changelog-Plugins | @semrel/generator-release-notes, @semrel/generator-changelog-md, @semrel/generator-changelog-html |
@semantic-release/npm | @semrel/updater-npm (pre-tag) + @semrel/publisher-npm (release) |
@semantic-release/exec | @semrel/hook-exec (unterstützt verifyConditionsCmd, prepareCmd, publishCmd, successCmd) |
| Beliebige Versions-/Regex-Ersetzungen | @semrel/updater-replace (pre-tag) |
| Crates / PyPI / Docker / OCI Publishing | @semrel/publisher-crates, @semrel/publisher-pypi, @semrel/publisher-docker, @semrel/publisher-oci, @semrel/publisher-generic-http |
Empfohlenes Rollout
Abschnitt betitelt „Empfohlenes Rollout“- Branch- und Trigger-Policy zunächst unverändert lassen.
- semrel im Dry-Run ergänzen und Version + Notes mit semantic-release vergleichen.
- Changelog/Release Notes auf semrel-Generatoren umstellen.
- Publishing von semantic-release auf semrel-Publisher migrieren.
- semantic-release Tagging/Publishing nach einem stabilen Zyklus deaktivieren.
Typische semrel-Basis
Abschnitt betitelt „Typische semrel-Basis“plugins: - uses: @semrel/provider-github
- uses: @semrel/analyzer-conventional
- uses: @semrel/generator-release-notes
- uses: @semrel/generator-changelog-md args: file: CHANGELOG.mdBeispiele für Publishing-Ersatz
Abschnitt betitelt „Beispiele für Publishing-Ersatz“- npm-Paketfluss:
npm publishim CI beibehalten, nachdem semrel Version und Changelog bestimmt hat. - GitHub-Release-Assets: Upload über CI-Schritt oder plugin-basiertes Publishing.
- OCI-/generische Artefakte:
@semrel/publisher-ocioder@semrel/publisher-generic-httpverwenden.
Risiken und Checks
Abschnitt betitelt „Risiken und Checks“- Sicherstellen, dass nur ein System Tags erstellt.
- Mindestens 10 aktuelle Commits im Dry-Run vergleichen, um Versions-Parität zu prüfen.
- Credentials in
SEMREL_PLUGIN_*Umgebungsvariablen verschieben.