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
-
En GitHub, visita la página principal del repositorio.
-
A la derecha de la lista de archivos, da clic en Releases o Latest release.
-
Haz clic en Borrador de un nuevo lanzamiento.
-
Haz clic en Elige una etiqueta y teclea un número de versión para tu lanzamiento. Como alternativa, selecciona una etiqueta existente.
-
Si estás creando una etiqueta nueva, haz clic en Crear etiqueta nueva.
-
Si creaste una etiqueta nueva, utiliza el menú desplegable para seleccionar la rama que contiene el proyecto que quieres lanzar.
-
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.
-
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.
-
Para notificar a los usuarios que el lanzamiento no está listo para producción y puede ser inestable, selecciona Esto es un pre-lanzamiento.
-
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.
-
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.
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".
Para aprender más sobre el CLI de GitHub, consulta la sección "Acerca del CLI de GitHub".
-
Para crear un lanzamiento, utiliza el subcomando
gh release create. Reemplazatagcon la etiqueta deseada para el lanzamiento.gh release create tag -
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
- En GitHub, visita la página principal del repositorio.
- A la derecha de la lista de archivos, da clic en Releases o Latest release.
- En la parte derecha de la página, junto al lanzamiento que quieres editar, da clic en Editar lanzamiento.
- 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.
Los lanzamientos no pueden editarse con CLI de GitHub actualmente.
Eliminar un lanzamiento
- En GitHub, visita la página principal del repositorio.
- A la derecha de la lista de archivos, da clic en Releases o Latest release.
- Da clic en el nombre del lanzamiento que quieres eliminar.
- En la esquina superior derecha de la página, haz clic en Eliminar.
- Da clic en Eliminar este lanzamiento.
-
Para borrar un lanzamiento, utiliza el subcomando
gh release delete. Reemplazatagcon la etiqueta del lanzamiento que se debe borrar. Utiliza el marcador-ypara omitir la confirmación.gh release delete tag -y