___ _ _ __
/ __\ |__ __ _ _ __ (_) ___ / / ___ __ _
/ / | '_ \ / _' | '_ \ | |/ _ \/ / / _ \ / _' |
/ /___| | | | (_| | | | || | __/ /__| (_) | (_| |
\____/|_| |_|\__,_|_| |_|/ |\___\____/\___/ \__, |
|__/ |___/
v: $version - https://github.con/sayjeyhi/chanjelog
flag | description
-----------------------------------------------------
-h | show help
-r | *{string} git repo url e.g: git.com/project.git
-f | {string} a file path to set version init with -s search format e.g: 'docker-compose.yml'
-s | {string} search pattern in version file e.g: '- DEPLOY_VERSION=[0-9]*\.[0-9]*\.[0-9]*'
-p | {string} search replace pattern in version file e.g: '- DEPLOY_VERSION='
-u | {string} jira tasks prefix to automaticly convery #[0-9]* to jira links in commit messages e.g: 'https:\/\/jira.site.com\/browse\/SP-'
-g | {boolean} to control adding tag on git or not e.g: [1|0]
-v | {string} to control version increase type e.g: ['patch'|'minor'|'major'|'prere'|'build']
-c | {boolean} to control update changeslog.md file e.g: [1|0]
You should have CI_USER and CI_ACCESS_TOKEN variables to allow ci to update your git.
---
An open source hack by @sayjeyhi - https://sayjeyhi.com with SemVer2.0.0
Just download index.sh
file and put it in your files, then you can run it in your CI flow
easily with pure bash, it will do all of semver
managing and changeslog
generating jobs
for you without any extra config!
As you can figure out from abow section and also in chanjeslog -h
, we have:
- auto version detect
- auto connect to git repo
- auto commit messages combine between versions with author name and date of change
- semver support
- update a custom file, like
.env
ordocker.compose.yml
files to have version in app runtime - task manager link update in commit messages
- good configurable params
- ..
Example configuration for gitlab CI, create a file named .gitlab-ci.yml
in your project, then register an runner to
run you CI, then put a content like this in your git-lab-ci.yml
file:
stages:
- changeVersion
prod:changeVersion:
variables:
GIT_STRATEGY: fetch
GIT_FETCH_EXTRA_FLAGS: --tags
only:
- master
tags:
- staging
when: always
stage: changeVersion
before_script:
- git config --global user.email "[email protected]"
- git config --global user.name "githuser"
script:
- bash ./scripts/changeLog/index.sh -r 'gitsite.com/project.git'
Actually it is easy to do with github too, get the index.sh
and put is some where is your project, like where I did mostly in
./scripts/changeLog/index.sh
then just create a file: .github/workflows/chanjelog.yml
and put a content like this in it:
name: Release
on:
push:
branches:
- develop
jobs:
release:
name: Release
runs-on: ubuntu-latest
steps:
- name: Checkout Repo
uses: actions/checkout@master
with:
# This makes Actions fetch all Git history so that Changesets can generate changelogs with the correct commits
fetch-depth: 0
- name: Generate changeslog
run: bash ./scripts/changeLog/index.sh -r 'github.com/someUser/repo.git'