Release Management

Intermediate10 min

Create, manage, and publish GitHub releases with auto-generated changelogs and asset attachments.

Prerequisites

-GitHub CLI (gh) installed and authenticated

Steps

List existing releases

View all releases for the repository.

$ gh release list --limit 10

Create a release with auto-generated notes

Create a new release with automatically generated changelog from merged PRs.

$ gh release create v1.2.0 --generate-notes --title 'v1.2.0'

The --generate-notes flag creates release notes from PR titles and labels since the last release.

Create a pre-release

Mark a release as a pre-release for beta or release candidate versions.

$ gh release create v2.0.0-rc.1 --prerelease --generate-notes --title 'v2.0.0 Release Candidate 1'

Upload assets to a release

Attach binary files, archives, or other assets to an existing release.

$ gh release upload v1.2.0 ./dist/app-linux-amd64.tar.gz ./dist/app-darwin-arm64.tar.gz

Download release assets

Download all assets from a specific release.

$ gh release download v1.2.0 --dir ./downloads

Full Script

full-script.sh

#!/bin/bash
# Release Management
set -euo pipefail

VERSION=${1:?"Usage: $0 <version> [--prerelease]"}
PRERELEASE=${2:-""}

echo "=== Current Releases ==="
gh release list --limit 5

echo ""
echo "=== Creating Release $VERSION ==="
if [ "$PRERELEASE" = "--prerelease" ]; then
  gh release create "$VERSION" --prerelease --generate-notes --title "$VERSION"
else
  gh release create "$VERSION" --generate-notes --title "$VERSION"
fi

echo ""
echo "=== Release Commands ==="
echo "View:     gh release view $VERSION"
echo "Upload:   gh release upload $VERSION ./file.tar.gz"
echo "Edit:     gh release edit $VERSION --notes 'Updated notes'"
echo "Delete:   gh release delete $VERSION"
echo "Download: gh release download $VERSION --dir ./downloads"

FAQ

Discussion

Loading comments...

#!/bin/bash # Release Management set -euo pipefail VERSION=${1:?"Usage: $0 <version> [--prerelease]"} PRERELEASE=${2:-""} echo "=== Current Releases ===" gh release list --limit 5 echo "" echo "=== Creating Release $VERSION ===" if [ "$PRERELEASE" = "--prerelease" ]; then gh release create "$VERSION" --prerelease --generate-notes --title "$VERSION" else gh release create "$VERSION" --generate-notes --title "$VERSION" fi echo "" echo "=== Release Commands ===" echo "View: gh release view $VERSION" echo "Upload: gh release upload $VERSION ./file.tar.gz" echo "Edit: gh release edit $VERSION --notes 'Updated notes'" echo "Delete: gh release delete $VERSION" echo "Download: gh release download $VERSION --dir ./downloads"