Administrar lanzamientos en un repositorio

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

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

Acerca de la administración de lanzamientos

Puedes crear lanzamientos nuevos con notas de lanzamiento, @menciones de contribuyentes y enlaces a archivos binarios, así como editar o borrar los lanzamientos existentes.

También puedes publicar una acción desde un lanzamiento específico en GitHub Marketplace. Para obtener más información, consulta la sección "Publicar una acción en GitHub Marketplace".

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

Crear un lanzamiento

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

  2. A la derecha de la lista de archivos, da clic en Releases o Latest release. Sección de lanzamientos en la barra lateral de lado derecho

  3. Haz clic en Borrador de un nuevo lanzamiento. Botón Borrador de lanzamientos

  4. Haz clic en Elige una etiqueta y teclea un número de versión para tu lanzamiento. Como alternativa, selecciona una etiqueta existente.

    Ingresa una etiqueta

  5. Si estás creando una etiqueta nueva, haz clic en Crear etiqueta nueva. Confirma si quieres crear una etiqueta nueva

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

  7. Escribe un título y una descripción para tu lanzamiento. Si @mencionas a cualquier usuario de GitHub en la descripción, el lanzamiento publicado incluirá una sección de Contribuyentes con una lista de avatares de los usuarios mencionados. Como alternativa, puedes generar tus notas de lanzamiento automáticamente dando clic en Generar notas de lanzamiento automáticamente.

    Descripción de lanzamientos

  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. Proporcionar un DMG con el lanzamiento

  9. Para notificar a los usuarios que el lanzamiento no está listo para producción y puede ser inestable, selecciona Esto es un pre-lanzamiento. Casilla de verificación para marcar un lanzamiento como prelanzamiento

  10. Opcionalmente, selecciona Crear un debate para este lanzamiento y luego, selecciona el menú desplegable de Categoría y haz clic en aquella que describa el debate de dicho lanzamiento. Casilla de verificación para crear un debate de lanzamiento y menú desplegable para elegir una categoría

  11. Si estás listo para publicitar tu lanzamiento, haz clic en Publicar lanzamiento. Para seguir trabajando luego en el lanzamiento, haz clic en Guardar borrador. Botones Publicar lanzamiento y Borrador de lanzamiento Entonces podrás ver tus lanzamientos publicados o en borrador dentro de las noticias de lanzamientos de tu repositorio. Para obtener más información, consulta la sección "Ver las etiquetas y lanzamientos de tu repositorio".

    Lanzamiento publicado con contribuyentes @mencionados

Para aprender más sobre el CLI de GitHub, consulta la sección "Acerca del CLI de GitHub".

  1. Para crear un lanzamiento, utiliza el subcomando gh release create. Reemplaza tag con la etiqueta deseada para el lanzamiento.

    gh release create tag
  2. Sigue los mensajes interactivos. Como alternativa, puedes especificar los argumentos para omitir estos mensajes. Para obtener más información sobre los argumentos posibles, consulta el manual de CLI de GitHub. 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 @mencionas a cualquier usuario de GitHub en las notas, el lanzamiento publicado en el GitHub.com incluirá una sección de Contribuyentes con una lista de avatares de todos los usuarios mencionados.

Editar un lanzamiento

  1. En GitHub, visita la página principal del repositorio.
  2. A la derecha de la lista de archivos, da clic en Releases o Latest release. Sección de lanzamientos en la barra lateral de lado derecho
  3. En la parte derecha de la página, junto al lanzamiento que quieres editar, da clic en Editar lanzamiento. Editar un lanzamiento
  4. Edita los detalles del lanzamiento en el formato, luego haz clic en Actualizar lanzamiento. Si agregas o eliminas cualquier @mención 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 de Contribuyentes del lanzamiento. Actualizar un lanzamiento

Los lanzamientos no pueden editarse con CLI de GitHub actualmente.

Eliminar un lanzamiento

  1. En GitHub, visita la página principal del repositorio.
  2. A la derecha de la lista de archivos, da clic en Releases o Latest release. Sección de lanzamientos en la barra lateral de lado derecho
  3. Da clic en el nombre del lanzamiento que quieres eliminar. Enlace para ver el lanzamiento
  4. En la esquina superior derecha de la página, haz clic en Eliminar. Botón para eliminar lanzamiento
  5. Da clic en Eliminar este lanzamiento. Confirmar la eliminación del lanzamiento
  1. Para borrar un lanzamiento, utiliza el subcomando gh release delete. Reemplaza tag con la etiqueta del lanzamiento que se debe borrar. Utiliza el marcador -y para omitir la confirmación.

    gh release delete tag -y

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.