Skip to main content

Uso de versiones y etiquetas inmutables para administrar las versiones de la acción

Obtén información sobre cómo puedes usar una combinación de versiones inmutables en GitHub y etiquetas de Git para administrar las versiones de la acción.

Nota:

Immutable releases are currently in versión preliminar pública and subject to change.

Si habilitas versiones inmutables en el repositorio de la acción, puedes administrar las versiones de la acción de la siguiente manera:

  1. Para iniciar el ciclo de lanzamiento, desarrolla y valida una versión potencial para tu acción en una rama de versión.

  2. Determina cómo deseas compartir los cambios:

    • Si estás listo para compartir una versión que no se puede cambiar de la acción, crea una versión en GitHub con una etiqueta específica de la versión (por ejemplo, v1.0.0). Consulta Administrar lanzamientos en un repositorio.
    • Si deseas poder actualizar la etiqueta Git de una versión más adelante, no crees una versión en GitHub. En su lugar, crea una etiqueta como se indica a continuación:
      • Si la versión contiene cambios importantes para los flujos de trabajo existentes, crea una etiqueta de versión principal (por ejemplo, v1).
      • Si la versión contiene una nueva funcionalidad compatible con versiones anteriores, crea una etiqueta de versión secundaria (por ejemplo, v1.1).
      • Si la versión contiene correcciones de errores compatibles con versiones anteriores, crea una etiqueta de versión de revisión (por ejemplo, v1.1.1).
  3. Para las etiquetas de Git que no están asociadas a una versión en GitHub, asegúrate de que los usuarios tienen acceso a la versión compatible más reciente de la acción actualizándolas de la siguiente manera:

    • Para una versión principal, actualiza la etiqueta para que apunte a la referencia de Git de la versión secundaria o de revisión relacionada más reciente.
    • Para una versión secundaria, actualiza la etiqueta para que apunte a la referencia de Git de la versión de revisión relacionada más reciente.

    Para mover una etiqueta de Git existente a la confirmación más reciente, fuerza la inserción de la etiqueta con los siguientes comandos:

    Bash
    git tag -f TAG-NAME
    git push -f --tags