GitHub-Releases bieten Endbenutzern eine einfach zugängliche Methode zum Herunterladen versionierter Software-Binärdateien. Sie können sie manuell erstellen, aber es ist viel einfacher, GitHub Actions sie automatisch erstellen zu lassen, indem Sie in Ihrem Repository erstellte Release-Tags verwenden.
Mit Tagged Veröffentlichungen
Tags sind eine vorhandene Funktion in Git, mit erweiterter Unterstützung durch GitHub mit Releases, die einen Ort zum Hosten von Binärdateien mit zugehörigen Änderungsprotokollen bieten.
Sie können ein Tag erstellen, ähnlich wie Sie einen Zweig erstellen würden , außer dass es sich um einen festen Punkt handelt, der sich nicht bewegt und immer auf einen bestimmten Commit zeigt. Dies ist nützlich für die Erstellung versionierter Veröffentlichungen, und die meisten Benutzer erstellen Tags im semantischen Versionierungsformat (Major.Minor.Patch).
Tags können an GitHub übertragen werden, wo sie in anderen Automatisierungsworkflows verwendet werden können. In diesem Fall richten wir ein GitHub-Aktionsskript ein, das auf Commits mit getaggten Releases wartet und die Build-Artefakte automatisch in einem Release veröffentlicht.
Einrichten von GitHub-Aktionen
Zunächst möchten Sie sicherstellen, dass Sie über einen funktionierenden GitHub Actions-Build verfügen und dass Ihre Build-Skripte ordnungsgemäß funktionieren. Die genaue Einrichtung Ihres Arbeitsablaufs hängt davon ab, welche Art von Projekt Sie erstellen. Im Allgemeinen möchten Sie jedoch nicht zwei Probleme gleichzeitig debuggen. Daher sollten Sie die Release-Veröffentlichung hinzufügen, sobald Sie bereits mit der Arbeit begonnen haben Artefakte. Sie können unseren Leitfaden zum Einrichten eines GitHub Actions-Builds lesen, um mehr zu erfahren.
Als erstes müssen Sie das Feld „on“ bearbeiten. Abschnitt Ihres Aktionsskripts, der auch ausgeführt wird, wenn Tags erstellt werden. Standardmäßig verfügen Sie wahrscheinlich über die Option „Push“. Ereignis zum Verfolgen von Releases oder des Master-Zweigs. Sie müssen Tags hinzufügen und einen Filter festlegen. Für alle Tags verwenden Sie einfach einen Platzhalter:
Am Am Ende des Workflows erstellen wir, nachdem alles erstellt wurde, den Release-Eintrag. Dies ist ein zweiteiliger Schritt: Zuerst müssen wir ein neues Release-Objekt mit allen Metadaten erstellen und dann können wir die ausgegebene Veröffentlichungs-URL dafür verwenden, um die Artefakte hochzuladen. Sie können mehrere Upload-Schritte erstellen, wenn Sie über mehrere Artefakte verfügen.
In beiden Fällen möchten wir diese Schritte nur ausführen, wenn der Workflow aufgrund eines Tags ausgeführt wird. Wir können dies mit einer einfachen if-Prüfung tun und prüfen, ob das github.ref-Objekt ein Tag ist, das den Referenznamen des Zweigs oder Tags speichert, der den Workflow ausgelöst hat.
Der erste Schritt ist das Erstellen ein Release-Objekt, was mit dem folgenden Schritt erfolgen kann. Das GitHub-Token muss nicht manuell erstellt werden, es ist ein spezielles Token, auf das jederzeit von Aktionsskripten aus verwiesen werden kann.
– Name: Release erstellen, wenn: getsWith(github.ref, 'refs/tags/') verwendet: actions/create-release@v1 id: create_release mit: draft: false prerelease: false release_name: ${{ github.ref }} tag_name: ${{ github.ref }} body_path: CHANGELOG.md env: GITHUB_TOKEN: ${{ Secrets.GITHUB_TOKEN }}
Beachten Sie hier, dass das Änderungsprotokoll für die Version unter CHANGELOG.md gespeichert ist, das vorhanden sein muss, damit der Workflow ordnungsgemäß ausgeführt werden kann. Sie können dies mit jedem Tag bearbeiten, um den von GitHub auf der Release-Seite angezeigten Markdown zu ändern. Es gibt Tools, um dies automatisch mit Commit-Nachrichten zu generieren, aber die meisten Teams verfügen ohnehin über ihre eigene Methode, dies zu verwalten.
Als Nächstes können Sie mit dem Hochladen von Artefakten beginnen. Dabei wird die Upload-URL aus dem vorherigen Schritt verwendet. Sie müssen einen Pfad definieren, unter dem sie zusammen mit dem Anzeigenamen für das Asset gefunden werden kann.
– Name: Release hochladen, wenn: getsWith(github.ref, 'refs/tags/') verwendet: actions/upload-release-asset@v1 env: GITHUB_TOKEN: ${{ Secrets.GITHUB_TOKEN }} mit: upload_url: ${{ Schritte.create_release.outputs.upload_url }} Asset-Pfad: Oxide.Ext.Sanctuary/bin/Release/net48/Oxide.Ext.Sanctuary.dll Asset-Name: Oxide.Ext.Sanctuary.dll Asset-Inhaltstyp: Anwendung/Oktett-Stream
< img src="http://www.howtogeek.com/pagespeed_static/1.JiBnMqyl6S.gif" />
Beachten Sie hier, dass der Inhaltstyp auf Octet-Stream eingestellt ist, was typisch für Binärdaten wie ausführbare Dateien und DLLs ist. Wenn Sie eine ZIP-Datei oder eine andere Art von Datei veröffentlichen, möchten Sie dies möglicherweise ändern, obwohl sich dies nur auf die visuellen Elemente auf der Veröffentlichungsseite auswirkt.
Jetzt können Sie die Änderungen übernehmen Aktionsworkflow, erstellen Sie dann ein neues Tag und übertragen Sie es an GitHub. Sie sollten sehen, dass eine neue Workflow-Ausführung erstellt wird, mit dem Unterschied, dass sie nicht über den Master-Zweig ausgeführt wird, sondern aufgrund des Tags:
Sobald es fertig ist, sehen Sie die Veröffentlichung in der GitHub-Seitenleiste.
WEITER LESEN
- › So schalten Sie Anrufe von unbekannten Nummern auf WhatsApp stumm
- › Austauschbare Smartphone-Akkus könnten ein Comeback erleben
- › Mac Trackpad funktioniert nicht? 10 Tipps und Tricks zum Ausprobieren
- › Ist es sicher, günstige/kostenlose Windows 10-Schlüssel von Drittanbietern zu kaufen?
- › VMware bringt 3D-beschleunigtes Windows 11 auf Apple Silicon Macs
- › So verwenden und passen Sie die virtuelle Tastatur auf Ihrem Steam-Deck an