Repolode
softprops

softprops/action-gh-release

Una GitHub Action que crea GitHub Releases y sube artefactos de compilación desde runners de Linux, Windows y macOS.

Estrellas
5,794
Forks
645
Issues abiertos
123
Último commit
hace 20 horas

¿Qué es?

action-gh-release es una GitHub Action que crea un GitHub Release para un tag y sube artefactos de compilación. Normalmente se añade como paso de un workflow que se ejecuta después de la compilación, para adjuntar automáticamente al release los binarios, archivos comprimidos o checksums generados por el pipeline.

La acción acepta patrones glob separados por saltos de línea mediante la entrada files y puede obtener las notas del release de un archivo con body_path o usar las notas generadas integradas de GitHub. Admite las opciones draft y prerelease, reutilizar un release existente para el mismo tag, añadir contenido al cuerpo existente, crear una discusión vinculada y fijar la base de comparación para las notas generadas. Entre sus outputs se incluyen la URL del release, el ID, la URL de subida y una lista JSON de los assets subidos.

La acción se ejecuta en runners de Linux, Windows y macOS. Su versión v3 está basada en Node 24 y requiere el permiso contents: write para el token del workflow.

Funciones clave

  • 01Crea un GitHub Release para un tag o actualiza el release existente para ese tag.
  • 02Sube archivos que coinciden con patrones glob, con compatibilidad opcional para especificar el directorio de trabajo.
  • 03Lee las notas del release de un archivo o usa las notas generadas por GitHub.
  • 04Admite las opciones draft, prerelease y make_latest.
  • 05Se ejecuta en runners de Linux, Windows y macOS.
  • 06Devuelve la URL del release, el ID, la URL de subida y los detalles de los assets subidos.

Casos de uso

  • Publicar binarios compilados desde una compilación de CI en un GitHub Release cuando se envía un tag de versión.
  • Adjuntar automáticamente checksums o archivos comprimidos a cada release.
  • Generar notas del release a partir de un archivo de changelog o de las notas autogeneradas de GitHub durante una compilación asociada a un tag.

Inicio rápido

  1. 1

    Añade el paso de publicación a tu archivo de workflow

    uses: softprops/action-gh-release@v3
  2. 2

    Configura el paso de publicación para que se ejecute solo al enviar etiquetas y enumera tus archivos en files

Antes de usarlo

  • Solo se ejecuta dentro de workflows de GitHub Actions; no funciona como herramienta independiente.
  • Para crear publicaciones en otros repositorios, necesitas un token de acceso personal con los permisos adecuados.

En colecciones

Temas

Preguntas frecuentes

¿Qué es action-gh-release?
Una GitHub Action que crea GitHub Releases y sube artefactos de compilación desde runners de Linux, Windows y macOS. action-gh-release es una GitHub Action que crea un GitHub Release para un tag y sube artefactos de compilación. Normalmente se añade como paso de un workflow que se ejecuta después de la compilación, para adjuntar automáticamente al release los binarios, archivos comprimidos o checksums generados por el pipeline.
¿action-gh-release es gratuito? ¿Qué licencia tiene?
action-gh-release es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿action-gh-release sigue mantenido?
Mantenimiento activo. El último commit de action-gh-release fue el 5 nov 2026.
¿Para qué puedo usar action-gh-release?
Publicar binarios compilados desde una compilación de CI en un GitHub Release cuando se envía un tag de versión. Adjuntar automáticamente checksums o archivos comprimidos a cada release. Generar notas del release a partir de un archivo de changelog o de las notas autogeneradas de GitHub durante una compilación asociada a un tag.
¿Cómo se instala action-gh-release?
Añade el paso de publicación a tu archivo de workflow: uses: softprops/action-gh-release@v3 Configura el paso de publicación para que se ejecute solo al enviar etiquetas y enumera tus archivos en files
¿Dónde consigo action-gh-release?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/softprops/action-gh-release

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados