Dokku is released in intervals at most three weeks apart, though may be released much quicker.
To propose a release, the following tasks need to be performed:
export PACKAGECLOUD_API_TOKEN=SOME_TOKEN # supports major/minor/patch/betafish contrib/release
If you are a maintainer and need the PACKAGECLOUD_API_TOKEN in order to make a release, please contact @josegonzalez to get this information.
As well, the ArchLinux package description must be updated via
vagrant up build-arch (needs to be done after the tag is pushed to GitHub, because it is based on that)
Dokku follows semver standards. As we are not yet at a stable release, breaking changes will require only a minor release, while all other changes only require a patch release. Once we hit stable, breaking changes will require a major release.
At the moment, tags need not be signed, though that may change in the future.
ArchLinux packages are not really build, because all that is needed for an Arch User Repo (AUR) package is the description of how to build the package. To make this process as easy as possible there is a vagrant box called
build-arch that updates the version of this build description (a file called
PKGBUILD), then runs some helper scripts to fill all additional information and does test if the package could be build. Then only those changes need to be pushed to the AUR repo and an updated version of the package is ready for usage for our ArchLinux users. For detailed information see the section below.
The workflow looks like this:
# having dokku-arch in ../dokku-arch vagrant up build-arch # wait for "==> build-arch: ==> Finished making: dokku 0.12.12-2 (Mon Feb 22 23:20:37 CET 2016)" cd ../dokku-arch git add PKGBUILD .SRCINFO git commit -m 'Update to dokku 0.9.9' git push aur master
If you are a maintainer and need access to the AUR repositories in order to make a release, please contact @morrisjobke or @josegonzalez to get this co-maintainership.
All of the information to build the ArchLinux package is in the AUR git repository (see dokku AUR page). The release of a AUR package only consists of pushing the package information into the AUR git repo. Then users could use that information to build the package on their machines.
To update the package clone the repository and adjust the files in the repository. Then a helper script -
updpkgsums - to update the SHA sum could be called (check against the original SHA sum). Another helper script -
mksrcinfo - needs to be called to update the meta information of the package in a file called
.SRCINFO. The next step builds the package locally for verification -
makepkg. As last step commit your changes and push the commit.
PKGBUILDcould be found in the ArchLinux wiki
That is the usual workflow:
updpkgsums # update sha sums - compare them with the original ones mksrcinfo # update package metadata for AUR makepkg # test package builds git add PKGBUILD .SRCINFO git commit -m 'Update to dokku 0.9.9' git push
If there is something unclear simply ask @morrisjobke for help.