Administrar lanzamientos en un repositorio

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

¿Quién puede utilizar esta característica?

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

Tool navigation

En este artículo

Acerca de la administración de lanzamientos

Puede crear nuevos lanzamientos con notas de lanzamiento, @mentions de colaboradores y enlaces a archivos binarios, así como editar o eliminar lanzamientos existentes. También puedes crear, modificar y eliminar versiones mediante Releases API. Para más información, consulta Puntos de conexión de la API de REST para lanzamientos en la documentación de la API REST.

También puede publicar una acción de una versión específica en GitHub Marketplace. Para más información, consulta 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 tarballs que cree GitHub para cada lanzamiento. Para más información, consulta Administrar los objetos de LFS de Git en los archivos de tu repositorio.

Crear un lanzamiento

  1. En el campo "Describir esta versión", escriba una descripción para tu 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, puede generar las notas de la versión automáticamente si hace clic en Generar notas de la versión.
  2. 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.
  3. 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.
  4. 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.
  5. 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 haz clic en una categoría para la discusión de la versión.
  6. Si está listo para publicar la versión, haga clic en Publish release (Publicar versión). Para trabajar en el lanzamiento más tarde, haga clic en Guardar borrador. Si ha habilitado lanzamientos inmutables para el repositorio, primero crear un borrador le permite adjuntar todos los activos antes de que el lanzamiento se vuelva inmutable. Después, puedes ver las versiones publicadas o los borradores en la fuente de versiones del repositorio. Para más información, consulta Visualizar los lanzamientos y etiquetas de tu repositorio.

Nota:

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

  1. Para crear una versión, use el subcomando gh release create. Reemplazar tag por la etiqueta que se desee 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 versión preliminar pública release" --prerelease

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

Editar un lanzamiento

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. 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.

  3. Junto a la versión que deseas editar, haz clic en .

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

  4. Edite los detalles de la versión en el formulario y, a continuación, haga clic en Actualizar versión. Si agrega o quita a cualquier usuario de GitHub en la descripción, esos usuarios se agregarán o quitarán de la lista de avatares en la sección Colaboradores de la versión.

  1. Para modificar una versión, utilice el subcomando gh release edit. Reemplace TAG con la etiqueta que representa la versión que desea modificar. Por ejemplo, para modificar el título de una versión, utilice el código siguiente, reemplazando NEW-TITLE con el título actualizado:

    gh release edit TAG -t "NEW-TITLE"

    Para más información sobre los posibles argumentos, vea el manual de GitHub CLI.

Eliminar un lanzamiento

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. 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.

  3. En el lado derecho de la página, junto a la versión que quieras borrar, haz clic en .

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

  4. 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