Skip to main content

Using immutable releases and tags to manage your action's releases

Learn how you can use a combination of immutable releases on GitHub and Git tags to manage your action's releases.

참고 항목

Immutable releases are currently in 공개 미리 보기 and subject to change.

If you enable immutable releases on your action's repository, you can manage your action's releases as follows:

  1. To start the release cycle, develop and validate a potential release for your action on a release branch.

  2. Determine how you want to share your changes:

    • If you are ready to share an unchangeable version of your action, create a release on GitHub with a release-specific tag (for example, v1.0.0). See 리포지토리에서 릴리스 관리.
    • If you want to be able to update the Git tag of a release later, do not create a release on GitHub. Instead, create a tag as follows:
      • If your release contains breaking changes for existing workflows, create a major version tag (for example, v1).
      • If your release contains new backwards-compatible functionality, create a minor version tag (for example, v1.1).
      • If your release contains backwards-compatible bug fixes, create a patch version tag (for example, v1.1.1).
  3. For Git tags that are not tied to a release on GitHub, ensure users have access to the latest compatible version of your action by updating them as follows:

    • For a major version, update the tag to point to the Git ref of the latest related minor version or patch version.
    • For a minor version, update the tag to point to the Git ref of the latest related patch version.

    To move an existing Git tag to the most recent commit, force push the tag with the following commands:

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