About release management
You can create new releases with release notes, @mentions of contributors, and links to binary files, as well as edit or delete existing releases.
Creating a release
-
On your GitHub Enterprise Server instance, navigate to the main page of the repository.
-
To the right of the list of files, click Releases.
-
Click Draft a new release.
-
Type a version number for your release. Alternatively, select an existing tag.
-
If you have created a new tag, use the drop-down menu to select the branch that contains the project you want to release.
-
Type a title and description for your release.
-
Optionally, to include binary files such as compiled programs in your release, drag and drop or manually select files in the binaries box.
-
To notify users that the release is not ready for production and may be unstable, select This is a pre-release.
-
If you're ready to publicize your release, click Publish release. To work on the release later, click Save draft.
To learn more about GitHub CLI, see "About GitHub CLI."
-
To create a release, use the
gh release create
subcommand. Replacetag
with the desired tag for the release.gh release create TAG
-
Follow the interactive prompts. Alternatively, you can specify arguments to skip these prompts. For more information about possible arguments, see the GitHub CLI manual. For example, this command creates a prerelease with the specified title and notes.
gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a beta release" --prerelease
Editing a release
-
On your GitHub Enterprise Server instance, navigate to the main page of the repository.
-
To the right of the list of files, click Releases.
-
On the right side of the page, next to the release you want to edit, click Edit release.
-
Edit the details for the release in the form, then click Update release.
Releases cannot currently be edited with GitHub CLI.
Deleting a release
-
On your GitHub Enterprise Server instance, navigate to the main page of the repository.
-
To the right of the list of files, click Releases.
-
Click the name of the release you wish to delete.
-
In the upper-right corner of the page, click Delete.
-
Click Delete this release.
-
To delete a release, use the
gh release delete
subcommand. Replacetag
with the tag of the release to delete. Use the-y
flag to skip confirmation.gh release delete TAG -y