GitHub Action
Version Increment
- name: Checkout code
uses: actions/checkout@v2
- name: Get next version
uses: reecetech/version-increment@2023.9.3
id: version
with:
scheme: semver
increment: patch
- name: Build image
uses: docker/build-push-action@v2
with:
push: false
tags: "example/application:${{ steps.version.outputs.version }}"
context: .
This action will detect the current latest normal semantic version (semver) from the tags in a git repository. It will increment the version as directed (by default: +1 to the patch digit). Both the current latest and the incremented version are reported back as outputs.
Normal semantic versions are made up of a major, minor and patch digit. Normal versions do not include pre-release versions, or versions with build meta-data.
e.g. 1.2.7
See: https://semver.org/spec/v2.0.0.html
Optionally, this action can provide semver compliant calendar versions (calver). In this calver scheme, the semver major, minor and patch digits map to year, month and release digits.
Note: to be semver compliant, digits must not have leading zeros.
e.g. 2021.6.2
semver | calver | example | note |
---|---|---|---|
major | year | 2021 |
|
minor | month | 6 |
|
patch | release | 2 |
The nth release for the month |
If the current latest normal version is not the current year and month, then the year and month digits will be set to the current year and month, and the release digit will be reset to 1.
Default branch
The action will return a normal version if it is detected that the current commit
is on the default branch (usually main
).
Examples:
1.2.7
2021.6.2
Any other branch
The action will return a pre-release version if any other branch is detected
(e.g. new-feature
, bugfix/foo
, etc). The pre-release portion of the version number
will be the literal string pre.
followed by the git commit ID short reference SHA
(trimmed of any leading zeros).
Examples:
1.2.7-pre.41218aa78
2021.6.2-pre.32fd19841
name | description | required | default |
---|---|---|---|
scheme | The versioning scheme in-use, either semver or calver |
No | semver |
pep440 | Set to true for PEP440 compatibility of pre-release versions by making use of the build metadata segment of semver, which maps to local version identifier in PEP440 |
No | false |
increment | The digit to increment, either major , minor or patch , ignored if scheme == calver |
No | patch |
release_branch | Specify a non-default branch to use for the release tag (the one without -pre) | No |
name | description |
---|---|
current-version | The current latest version detected from the git repositories tags |
current-v-version | The current latest version detected from the git repositories tags, prefixed with a v character |
version | The incremented version number (e.g. the next version) |
v-version | The incremented version number (e.g. the next version), prefixed with a v character |
major-version | Major number of the incremented version |
minor-version | Minor number of the incremented version |
patch-version | Patch number of the incremented version |
pre-release-label | Pre-release label of the incremented version |
major-v-version | Major number of the incremented version, prefixed with a v character |
minor-v-version | Minor number of the incremented version, prefixed with a v character |
patch-v-version | Patch number of the incremented version, prefixed with a v character |
Please raise a pull request, but note the testing tools below
BATS is used to test the logic of the shell scripts.
See: https://github.com/bats-core/bats-core
Shellcheck is used to lint our shell scripts.
Please use local ignores if you'd like to skip any particular checks.