Release Procedures
Get newest source from Github
Prerequisites
You have a github account and are registered as a developer in the Statsbiblioteket account. You have registered you ssh key at Github.
If you don't already have a checkout of the sources
Find them at
https://github.com/statsbiblioteket
Then do
git clone git@github.com:statsbiblioteket/PROJECT-NAME-HERE
Your sources will now be in a folder with the same name as the project.
If you already have a checkout of the sources
Do a
git status
Make sure you have no uncommitted or unpushed changes. Then do
git pull
to get newest sources from Github. Handle any merges that might be needed.
Check out the correct branch
Make sure you are in the root directory of your source checkout.
Releasing from master
In most cases we release from the master branch:
git checkout master
Creating a maintenance release branch
However, if we do maintenance releases for an older release, we will do it for a branch for that release.
To create this branch, do
git tag
This will list all tags for the project.
And find the tag you want to branch from. Then do
git checkout YOUR_TAGNAME_HERE -b YOUR_TAGNAME_HERE
This will create a branch from that tag, with the same name as the tag.
Immediately edit the pom.xml file, e.g.
vi pom.xml
Add .1-SNAPSHOT to the end of the version string. E.g. if the version was:
<version>1.3</version>
replace it with
<version>1.3.1-SNAPSHOT</version>
Add, commit and push the changes.
You can now merge in commits from the master branch
Using an existing maintenance branch
If the maintenance branch already exists, just do
git checkout YOUR_TAGNAME_HERE
You can now merge in commits from the master branch
Update changelog
git log
vi CHANGELOG.md