Releasing a new CKAN client - brookmire/CKAN GitHub Wiki

How to make releases using the new build system

While not super-automated like the last system was, we do now have a relatively nice way to make new releases using the ckan-release-promoter.py tool. Here is a step-by-step guide on how to do that.

1. Pick a release from CKAN-nighly that you want to promote to an official release and copy its Jenkins build URL from the release description. For example, if I choose jenkins-CKAN-152 I will need "http://ci.ksp-ckan.org:8080/job/CKAN/152/"

2. Git clone https://github.com/KSP-CKAN/CKAN.git and navigate to CKAN/bin. If this is the first time you're running the CKAN build tools you should run pip install -r requirements.txt to install all dependencies.

3. Run python ckan-release-promoter.py <args>, where the necessary arguments are described below:

--user USER - Your GitHub username

--token TOKEN - Your GitHub password (or app. token)

--repository REPOSITORY - Target repository, you want this set to KSP-CKAN/CKAN for now

--jenkins-build URL - The build URL from step 1

--release-version VERSION - The CKAN version to stamp the .exe with, should be in the format vX.Y.Z e.g. v1.5.1

--name NAME - The name of the release e.g. "Galactic Center"

--draft - Optional, post the release as a draft, defaults to false

--prerelease - Optional, post the release as a pre-release, defaults to false

Here is a working example (GitHub token masked out):

python ckan-release-promoter.py --user AlexanderDzhoganov --token *** --repository KSP-CKAN/CKAN --jenkins-build http://ci.ksp-ckan.org:8080/job/CKAN/151/ --release-version v1.5.2 --name "Galactic Center"

4. If everything was successful you should see the new release in the GitHub releases page. At this point you should edit the body text and whatever else you want.