Skip to main content

Administrar lanzamientos en un repositorio

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

Who can use this feature

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 obtener más información, consulta "Versiones" en la documentación de la API REST.

También puede publicar una acción para una versión específica en GitHub Marketplace. Para más información, vea "Publicación de una acción 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 Enterprise Cloud para cada lanzamiento. Para más información, vea "Administración de objetos Git LFS en archivos del 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. Sección Releases en la barra lateral del lado derecho

  2. Haga clic en Borrador de una nueva versión.

    Botón Borrador de lanzamientos

  3. Haz clic en Elegir una etiqueta, escribe un número de versión y presiona ENTRAR. Como alternativa, selecciona una etiqueta existente.

    Ingresa una etiqueta

  4. Si va a crear una etiqueta, haga clic en Crear etiqueta.

    Captura de pantalla de la confirmación de que quieres crear una etiqueta.

  5. Si creaste una etiqueta nueva, utiliza el menú desplegable para seleccionar la rama que contiene el proyecto que quieres lanzar.

    Captura de pantalla de la lista desplegable para elegir una rama.

  6. Opcionalmente, en la parte superior derecha del cuadro de texto de descripción, selecciona el menú desplegable de Etiqueta anterior y haz clic en la etiqueta que identifica la versión anterior. Captura de pantalla en la que se muestra cómo seleccionar una etiqueta para identificar la versión anterior

  7. Escribe un título y una descripción para tu lanzamiento. 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.

    Captura de pantalla de la descripción de las versiones.

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

    GIF animado en el que se muestra cómo se proporciona un DMG con la versión.

  9. Para notificar a los usuarios que la versión no está lista para producción y puede ser inestable, seleccione Es una versión preliminar.

    Captura de pantalla de la casilla para marcar una versión como versión preliminar.

  10. Opcionalmente, puedes seleccionar Establecer como 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.

    Captura de pantalla de la casilla para marcar una versión como versión más reciente.

  11. Opcionalmente, si se han habilitado los GitHub Discussions en el repositorio, seleccione Crear un debate para esta versión, después el menú desplegable Categoría y haga clic en una categoría para el debate de la versión.

    Captura de pantalla de la casilla para crear un debate de versión y del menú desplegable para elegir una categoría.

  12. 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). Botones Publicar versión y 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, consulta "Captura de pantalla de las versiones y etiquetas del repositorio".

    Versión publicada con colaboradores @mentioned

Para obtener más información sobre GitHub CLI, vea "Acerca de GitHub CLI".

  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 Enterprise Cloud 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. Sección Releases en la barra lateral del lado derecho
  2. De lado derecho de la página, junto al lanzamiento que quieras editar, haz clic en . Edición de una versión
  3. Edita los detalles de la versión en el formulario y, después, haz clic en Actualizar versión. Si agregas o eliminas @mentions de los usuarios de GitHub en la descripción, estos se agregarán o eliminarán de la lista de avatares en la sección Colaboradores de la versión. Actualización de una versió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. Sección Releases en la barra lateral del lado derecho
  2. De lado derecho de la página, junto al lanzamiento que quieras borrar, haz clic en . Eliminación de una versión
  3. Haga clic en Eliminar esta versión. Confirmación de la eliminación de la 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