Skip to main content

GitHub Action: major-release-tagger

GitHub Action that automatically generates or updates v<major-release> tags every time a new release is published.

Introduction

This GitHub Action automatically generates or updates v<major-release> tags every time a new release is published, making it effortless to keep track of your project's major versions.

Imagine your Git repository has the following tags:

1.0.0
1.1.0
2.0.0
2.0.1
2.1.0
3.0.0

By simply incorporating Major Release Tagger, your repo will be enriched with the corresponding v-tags:

1.0.0
1.1.0 v1
2.0.0
2.0.1 v2
2.1.0
3.0.0 v3

When you create a new release tagged 3.1.0, the v3 tag will automatically point to it:

1.0.0
1.1.0 v1
2.0.0
2.0.1 v2
2.1.0
3.0.0
3.1.0 v3

Stay organized and efficient with Major Release Tagger - the ultimate GitHub Action to streamline your versioning process.

Usage

  name: Major Release Tagger

on:
release:
types:
- published

jobs:
publish:
runs-on: ubuntu-latest
steps:
- uses: cloudposse/github-action-major-release-tagger@v1

Inputs

NameDescriptionDefaultRequired
dry-runRun action without pushing changes to upstreamfalsefalse
git-user-emailGit user email that will be used for git config[email protected]false
git-user-nameGit user name that will be used for git configactions-botfalse
log-levelLog level for this action. Available options: ['off', 'error', 'warn', 'info', 'debug']. Default 'info'infofalse
tokenStandard GitHub token (e.g., secrets.GITHUB_TOKEN)${{ github.token }}false

Outputs

NameDescription
responseResponse in json format for example: {"succeeded":true,"reason":"MAPPED_TAGS","message":"Successfully created/update v-tags.","data":{"v1": {"state":"updated", "oldSHA": "d9b3a3034766ac20294fd1c36cacc017ae4a3898", "newSHA":"e5c6309b473934cfe3e556013781b8757c1e0422"}, "v2": {"state":"created", "oldSHA": "bbf9f924752c61dcef084757bcf4440e23f2e16b", "newSHA":"5ae37ee514b73cf8146fe389ad839469e7f3a6d2"}}}