Veröffentlichungen in einem Repository verwalten

Du kennst Releases erstellen, um Iterationen eines Projektes zu bündeln und für Benutzer*innen bereitzustellen.

Wer kann dieses Feature verwenden?

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

Tool navigation

In diesem Artikel

Informationen zur Releaseverwaltung

Du kannst neue Releases mit Versionshinweisen, @mentions von Mitwirkenden und Links zu Binärdateien erstellen sowie vorhandene Releases bearbeiten oder löschen. Mit der API für Releases kannst du außerdem Releases erstellen, ändern und löschen. Weitere Informationen findest du in der Dokumentation zur REST-API unter REST-API-Endpunkte für Releases.

Du kannst eine Aktion aus einem bestimmten Release in GitHub Marketplace veröffentlichen. Weitere Informationen finden Sie unter Aktionen auf dem GitHub-Marktplatz veröffentlichen.

Du kannst auswählen, ob Git Large File Storage-Objekte (Git LFS) in den ZIP-Dateien und Tarballs enthalten sein sollen, die GitHub für jedes Release erstellt. Weitere Informationen finden Sie unter Verwalten von Git LFS-Objekten in Archiven deines Repositorys.

Einen Release erstellen

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke rechts neben der Liste der Dateien auf Releases.

    Screenshot der Hauptseite eines Repositorys. Der Link mit der Bezeichnung „Releases“ ist orange umrandet.

  3. Klicke auf oben auf der Seite auf Neues Release entwerfen.

  4. Wähle im Dropdownmenü Tag auswählen ein Tag für das Release aus.

    • Um ein vorhandenes Tag zu verwenden, klicke auf das Tag.
    • Gib zum Erstellen eines neuen Tags eine Versionsnummer für dein Release ein, und klicke dann auf Neues Tag erstellen.

  5. Wenn du ein neues Tag erstellt hast, verwende das Dropdownmenü Ziel, und klicke dann auf den Branch, der das zu veröffentlichende Projekt enthält.

  6. Optional kannst du über dem Beschreibungsfeld das Dropdownmenü Vorheriges Tag auswählen und dann auf das Tag klicken, das die vorherige Version kennzeichnet.

    Screenshot des Formulars „Neues Release“. Das Dropdownmenü mit der Bezeichnung „Vorheriges Tag: auto“ ist orange umrandet.

  7. Gib im Feld „Releasetitel“ einen Titel für dein Release ein.

  8. Gib im Feld „Releasebeschreibung“ eine Beschreibung für dein Release ein. Wenn du über @mention jemanden in der Beschreibung erwähnst, enthält die veröffentlichte Version den Abschnitt Mitwirkende mit einer Avatarliste aller erwähnten Benutzer*innen. Alternativ können Sie Versionshinweise automatisch generieren, indem Sie auf Versionshinweise generieren klicken.

  9. Um optional binäre Dateien wie kompilierte Programme in deinen Release einzubinden, ziehe die Dateien mit Drag-and-Drop herüber oder wähle die Dateien manuell im Feld für Binärdateien.

  10. Um Benutzer*innen darüber zu informieren, dass das Release nicht produktionsbereit und möglicherweise instabil ist, wähle optional Dies ist eine Vorabversion aus.

  11. Wähle optional Als neueste Version festlegen aus. Wenn du diese Option nicht auswählst, wird die neueste Versionsbezeichnung automatisch auf Basis der semantischen Versionierung zugewiesen.

  12. Wenn GitHub Discussions für das Repository aktiviert ist, erstelle optional eine Diskussion für das Release.

    • Wähle Diskussion für dieses Release erstellen aus.
    • Wähle das Dropdownmenü Kategorie und dann eine Kategorie für die Releasediskussion aus.

  13. Wenn du dein Release veröffentlichen möchtest, klicke auf Release veröffentlichen. Wenn du später an dem Release arbeiten möchtest, klicke auf Entwurf speichern. Du kannst die veröffentlichten Releases oder die Entwürfe anschließend im Releasefeed deines Repositorys anzeigen. Weitere Informationen finden Sie unter Releases und Tags Deines Repository anzeigen.

Note

Weitere Informationen zur GitHub CLI findest du unter Informationen zur GitHub CLI.

  1. Verwende den Unterbefehl gh release create, um ein Release zu erstellen. Ersetze tag durch das gewünschte Tag für das Release.

    gh release create TAG

  2. Befolge die interaktiven Eingabeaufforderungen. Du kannst Argumente angeben, um diese Eingabeaufforderungen zu überspringen. Weitere Informationen zu möglichen Argumenten findest du im GitHub CLI-Handbuch. Mit diesem Befehl wird beispielsweise ein Vorabrelease mit dem angegebenen Titel und den entsprechenden Hinweisen erstellt.

    gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a public preview release" --prerelease

Wenn du irgendwelche GitHub benutzende Personen mit @mention in den Anmerkungen erwähnst, enthält das veröffentlichte Release den Abschnitt Contributors mit einer Avatarliste aller erwähnten Benutzenden.

Einen Release bearbeiten

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke rechts neben der Liste der Dateien auf Releases.

    Screenshot der Hauptseite eines Repositorys. Der Link mit der Bezeichnung „Releases“ ist orange umrandet.

  3. Wählen neben dem Release, das du bearbeiten möchtest, aus.

    Screenshot: Release in der Releaseliste. Das Stiftsymbol ist mit einem orangefarbenen Rahmen hervorgehoben.

  4. Bearbeite über das Formular die Details für das Release, und klicke dann auf Release aktualisieren. Wenn du eine Erwähnung (@mentions) von GitHub-Benutzerinnen aus der Beschreibung entfernst oder hinzufügst, werden diese Benutzerinnen aus der Avatarliste im Abschnitt Mitwirkende des Releases entfernt oder ihr hinzugefügt.

  1. Um eine Version zu bearbeiten, verwenden Sie den Unterbefehl gh release edit. Ersetzen Sie TAG Tag durch den Tag, der die Version darstellt, die Sie bearbeiten möchten. Wenn Sie beispielsweise den Titel für eine Version bearbeiten möchten, verwenden Sie den folgenden Code, und ersetzen Sie dabei NEW-TITLE durch den aktualisierten Titel:

    gh release edit TAG -t "NEW-TITLE"

    Weitere Informationen zu möglichen Argumenten findest du im GitHub CLI-Handbuch.

Einen Release löschen

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke rechts neben der Liste der Dateien auf Releases.

    Screenshot der Hauptseite eines Repositorys. Der Link mit der Bezeichnung „Releases“ ist orange umrandet.

  3. Klicke im rechten Abschnitt der Seite neben dem Release, das du löschen möchtest, auf .

    Screenshot: Release in der Releaseliste. Das Papierkorbsymbol ist mit einem orangefarbenen Rahmen hervorgehoben.

  4. Klicke auf Dieses Release löschen.

  1. Verwende den Unterbefehl gh release delete, um ein Release zu löschen. Ersetze tag durch das Tag des Releases, das gelöscht werden soll. Verwende das Flag -y, um das Bestätigen zu überspringen.

    gh release delete TAG -y