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.
You can also publish an action from a specific release in GitHub Marketplace. For more information, see "Publishing an action in the GitHub Marketplace."
You can choose whether Almacenamiento de archivos de gran tamaño Git (Git LFS) objects are included in the ZIP files and tarballs that GitHub creates for each release. For more information, see "Managing Git LFS objects in archives of your repository."
Creating a release
-
En GitHub.com, visita la página principal del repositorio.
-
A la derecha de la lista de archivos, haz clic en Lanzamientos.
-
Click Draft a new release.
-
Click Choose a tag, type a version number for your release, and press Enter. Alternatively, select an existing tag.
-
If you are creating a new tag, click Create new 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.
-
Optionally, to the top right of the description text box, select the Previous tag drop-down menu and click the tag that identifies the previous release.
-
Type a title and description for your release. If you @mention any GitHub users in the description, the published release will include a Contributors section with an avatar list of all the mentioned users. Alternatively, you can automatically generate your release notes by clicking Generate release notes.
-
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.
-
Optionally, if GitHub Discussions are enabled in the repository, select Create a discussion for this release, then select the Category drop-down menu and click a category for the release discussion.
-
If you're ready to publicize your release, click Publish release. To work on the release later, click Save draft.
You can then view your published or draft releases in the releases feed for your repository. For more information, see "Viewing your repository's releases and tags."
Para aprender más sobre el CLI de GitHub, consulta la sección "Acerca del CLI de GitHub".
-
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 CLI de GitHub 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
If you @mention any GitHub users in the notes, the published release on GitHub.com will include a Contributors section with an avatar list of all the mentioned users.
Editing a release
-
En GitHub.com, visita la página principal del repositorio.
-
A la derecha de la lista de archivos, haz clic en Lanzamientos.
-
On the right side of the page, next to the release you want to edit, click .
-
Edit the details for the release in the form, then click Update release. If you add or remove any @mentions of GitHub users in the description, those users will be added or removed from the avatar list in the Contributors section of the release.
Releases cannot currently be edited with CLI de GitHub.
Deleting a release
-
En GitHub.com, visita la página principal del repositorio.
-
A la derecha de la lista de archivos, haz clic en Lanzamientos.
-
On the right side of the page, next to the release you want to delete, click .
-
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