Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.
All products
Repositorios

Administrar lanzamientos en un repositorio

En este artículo

Puedes crear lanzamientos que desees poner en conjunto y entregar iteraciones de un proyecto a los usuarios.

Quién puede usar esta característica

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

Acerca de la administración de lanzamientos

Puede crear versiones con notas de la versión, @mentions de colaboradores y vínculos a archivos binarios, así como editar o borrar las versiones existentes. También puedes crear, modificar y eliminar versiones mediante Releases API. Para más información, consulta "Versiones" en la documentación de REST API.

También puede publicar una acción para una versión específica en GitHub Marketplace. Para obtener más información, vea «Publicar acciones en GitHub Marketplace».

Puedes elegir si los objetos de Almacenamiento de archivos de gran tamaño de Git (Git LFS) se incluirán en los archivos ZIP y .tar que cree GitHub para cada lanzamiento. Para obtener más información, vea «Administrar los objetos de LFS de Git en los archivos de tu repositorio».

Crear un lanzamiento

  1. En GitHub.com, navega a la página principal del repositorio. 1. A la derecha de la lista de archivos, haga clic en Releases.

    Captura de pantalla de la página principal de un repositorio. Un vínculo con la etiqueta "Versiones" aparece resaltado con un contorno naranja. 1. At the top of the page, click Draft a new release.

  2. To chose a tag for the release, select the Choose a tag dropdown menu.

    • To use an existing tag, click the tag.
    • To create a new tag, type a version number for your release, then click Create new tag.

  3. If you created a new tag, select the Target dropdown menu, then click the branch that contains the project you want to release.

  4. Si quieres, encima del campo de descripción, selecciona el menú desplegable Etiqueta anterior y haz clic en la etiqueta que identifica la versión anterior.

    Captura de pantalla del formulario "Nueva versión". Un menú desplegable con la etiqueta "Etiqueta anterior: automática" aparece resaltado con un contorno naranja.

  5. En el campo "Título de versión", escribe un título para la versión.

  6. En el campo "Describir esta versión", escriba una descripción para la versión. Si usas @mention para mencionar a algún usuario en la descripción, la versión publicada incluirá una sección Colaboradores con una lista de avatares de todos los usuarios mencionados. Como alternativa, puedes generar automáticamente las notas de la versión si haces clic en Generar notas de la versión. 1. Opcionalmente, para incluir los archivos binarios tales como programas compilados en tu lanzamiento, arrastra y suelta o selecciona manualmente los archivos en la caja de binarios.

  7. De manera opcional, para notificar a los usuarios de que la versión no está lista para producción y puede ser inestable, selecciona Esta es una versión preliminar.

  8. Si lo deseas, selecciona Establecer como la versión más reciente. Si no seleccionas esta opción, la etiqueta de versión más reciente se asignará automáticamente en función del Versionamiento Semántico.

  9. De manera opcional, si se habilitó GitHub Discussions para el repositorio, crea un debate para la versión.

    • Selecciona Crear un debate para esta versión.
    • Selecciona el menú desplegable Categoría y, luego, haz clic en una categoría para el debate de la versión.

  10. Si está listo para publicar la versión, haga clic en Publish release (Publicar versión). Para trabajar después en la versión, haga clic en Save draft (Guardar borrador). Después, puedes ver las versiones publicadas o los borradores en la fuente de versiones del repositorio. Para obtener más información, vea «Visualizar los lanzamientos y etiquetas de tu repositorio».

Para más información sobre GitHub CLI, consulta "Acerca del CLI de GitHub".

  1. Para crear una versión, use el subcomando gh release create. Reemplace tag con la etiqueta que quiera para la versión.

    gh release create TAG

  2. Sigue los mensajes interactivos. Como alternativa, puedes especificar los argumentos para omitir estos mensajes. Para más información sobre los posibles argumentos, vea el manual de GitHub CLI. Por ejemplo, este comando crea un pre-lanzamiento con el título y notas especificados.

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

Si usas @mention para mencionar a algún usuario de GitHub en las notas, la versión publicada en GitHub.com incluirá una sección Colaboradores con una lista de avatares de todos los usuarios mencionados.

Editar un lanzamiento

  1. En GitHub.com, navega a la página principal del repositorio. 1. A la derecha de la lista de archivos, haga clic en Releases.

    Captura de pantalla de la página principal de un repositorio. Un vínculo con la etiqueta "Versiones" aparece resaltado con un contorno naranja.

  2. Next to the release you want to edit, click .

    Screenshot of a release in the releases list. A pencil icon is highlighted with an orange outline.

  3. Edite los detalles de la versión en el formulario y, a continuación, haga clic en Actualizar versión. Si agrega o elimina algún @mentions de los usuarios de GitHub en la descripción, dichos usuarios se agregarán o eliminarán de la lista de avatares en la sección Contribuidores de la publicación.

Los lanzamientos no pueden editarse con GitHub CLI actualmente.

Eliminar un lanzamiento

  1. En GitHub.com, navega a la página principal del repositorio. 1. A la derecha de la lista de archivos, haga clic en Releases.

    Captura de pantalla de la página principal de un repositorio. Un vínculo con la etiqueta "Versiones" aparece resaltado con un contorno naranja.

  2. De lado derecho de la página, junto al lanzamiento que quieras borrar, haz clic en .

    Captura de pantalla de una versión en la lista de versiones. Un icono de papelera está resaltado con un contorno naranja.

  3. Haga clic en Eliminar esta versión.

  1. Para eliminar una versión, use el subcomando gh release delete. Reemplace tag con la etiqueta de la versión que se va a eliminar. Use la marca -y para omitir la confirmación.

    gh release delete TAG -y