lanzamientos automáticos de acción

Lanzamientos automáticos de GitHub

Esta acción simplifica el proceso de lanzamiento de GitHub al cargar activos automáticamente, generar registros de cambios, manejar lanzamientos previos, etc.

Contenido

1. Ejemplos de uso
2. Parámetros admitidos
3. Activadores de eventos
4. Versionado
5. Cómo obtener ayuda
6. Licencia

NOTA : El repositorio marvinpinto/action-automatic-releases es un espejo generado automáticamente del monorepo marvinpinto/actions que contiene esta y otras acciones. Presente los problemas y retire las solicitudes allí.

Ejemplos de uso

Generar automáticamente una versión preliminar cuando los cambios lleguen al maestro

Este flujo de trabajo de ejemplo se activará tan pronto como los cambios lleguen a master . Después de ejecutar los pasos para construir y probar su proyecto:

1. Creará (o reemplazará) una etiqueta git llamada latest .
2. Genere un registro de cambios a partir de todas las confirmaciones entre esta y la latest etiqueta anterior.
3. Genere una nueva versión asociada con la latest etiqueta (eliminando cualquier versión asociada anterior).
4. Actualice esta nueva versión con el título especificado (por ejemplo, Development Build ).
5. Cargue LICENSE.txt y cualquier archivo jar como recurso de lanzamiento.
6. Marque esta versión como pre-release .

Puede ver un ejemplo práctico de este flujo de trabajo en marvinpinto/actions.

---
name : " pre-release "

on :
  push :
    branches :
      - " master "

jobs :
  pre-release :
    name : " Pre Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          automatic_release_tag : " latest "
          prerelease : true
          title : " Development Build "
          files : |
            LICENSE.txt
            *.jar

Crear una nueva versión de GitHub cuando las etiquetas se envíen al repositorio

Al igual que en el ejemplo anterior, este flujo de trabajo se activará tan pronto como se envíen nuevas etiquetas a GitHub. Después de construir y probar su proyecto:

1. Genere un registro de cambios a partir de todas las confirmaciones entre esta y la etiqueta anterior de aspecto semver.
2. Genere una nueva versión y asóciela con esta etiqueta.
3. Cargue LICENSE.txt y cualquier archivo jar como recurso de lanzamiento.

Una vez más, hay un ejemplo de esto en marvinpinto/actions.

---
name : " tagged-release "

on :
  push :
    tags :
      - " v* "

jobs :
  tagged-release :
    name : " Tagged Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          prerelease : false
          files : |
            LICENSE.txt
            *.jar 

Parámetros admitidos

Parámetro	Descripción	Por defecto
repo_token **	Token de acción de GitHub, por ejemplo, "${{ secrets.GITHUB_TOKEN }}" .	null
draft	¿Marcar este comunicado como borrador?	false
prerelease	¿Marcar este lanzamiento como prelanzamiento?	true
automatic_release_tag	Nombre de etiqueta que se utilizará en lanzamientos automáticos, por ejemplo, latest .	null
title	Título del lanzamiento; El valor predeterminado es el nombre de la etiqueta si no se especifica ninguno.	Nombre de etiqueta
files	Archivos para cargar como parte de los activos de lanzamiento.	null

Salidas

Se puede acceder a los siguientes valores de salida a través de ${{ steps..outputs. }} :

Nombre	Descripción	Tipo
automatic_releases_tag	La etiqueta de lanzamiento que esta acción acaba de procesar.	cadena
upload_url	La URL para cargar recursos adicionales al lanzamiento.	cadena

Notas:

• Los parámetros indicados con ** son obligatorios.
• El parámetro files admite patrones globales de varias líneas; consulte los ejemplos del repositorio.

Activadores de eventos

El marco de GitHub Actions te permite activar esta (y otras) acciones en muchas combinaciones de eventos. Por ejemplo, puede crear lanzamientos previos específicos para etiquetas candidatas a lanzamiento (por ejemplo, *-rc* ), generar lanzamientos a medida que los cambios lleguen al maestro (ejemplo anterior), lanzamientos nocturnos y mucho más. Lea la sintaxis del flujo de trabajo para GitHub Actions para obtener ideas y ejemplos avanzados.

Versionado

Cada confirmación que llega a master para este proyecto desencadena una compilación automática, así como una versión etiquetada llamada latest . Si no desea vivir a la vanguardia, puede utilizar una versión estable. Consulte los lanzamientos para conocer las versiones disponibles.

"">

- uses : " marvinpinto/action-automatic-releases@ " 

Cómo obtener ayuda

El archivo README principal de este proyecto tiene mucha información relacionada con problemas de depuración y envío. Si todavía estás atascado, intenta comunicarte conmigo en Keybase y haré todo lo posible para ayudarte.

Licencia

El código fuente de este proyecto se publica bajo la licencia MIT. Este proyecto no está asociado con GitHub.