Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
git-merge

GitHub Action

Github Any Branch Tag Bump

v1.0

Github Any Branch Tag Bump

git-merge

Github Any Branch Tag Bump

A Github Action to update chosen branch with MAJOR.MINOR.PATCH tag on merge

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Github Any Branch Tag Bump

uses: kimgault/[email protected]

Learn more about this action in kimgault/github-tag-action

Choose a version

github-tag-action

A Github Action to automatically bump and tag any release branch on merge, and update latest tag to point to the latest commit.

Usage

name: Bump version
on:
  push:
    branches:
      - master
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - name: Bump version and push tag
      uses: wiktorj/github-tag-action@master
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        BRANCH: master

Options

Environment Variables

  • GITHUB_TOKEN (required) - Required for permission to tag the repo.
  • BRANCH (required) - Branch name.
  • WITH_V (optional) - Tag version with v character.

Outputs

  • new_tag - The value of the newly created tag.

Note: This action creates a annotated tag.

Bumping

With every commit to master latest tag is updated to the latest commit in the master branch.

Any commit message that includes #major, #minor, or #patch will trigger the respective version bump. If two or more are present, the highest-ranking one will take precedence.

Note: This action will not bump the tag if the HEAD commit has already been tagged.

Workflow

  • Add this action to your repo
  • Commit some changes
  • Decide what branch you want to compare, example is master.
  • Either push to master or open a PR
  • On push (or merge) to master, the action will:
    • Get latest tag (different than latest)
    • Bump the tag if commit message contains one of the: #major, #minor or #patch
    • Updates latest tag to point to the latest commit on the master branch
    • Pushes tags updates to github

Credits

Forked from: WiktorJ/github-tag-action