Building a release

The XP Framework is built and released by this build system

Before...

...you do anything, verify the build is passing:

Creating a release candidate

Ensure you have an up-to-date checkout (git pull!). Then create a tag and push it:

$ git tag -a r5.9.XRCY -m "- Release 5.9.XRCY"
$ git push origin r5.9.XRCY

Creating a release

To create a release, the following steps need to be done:

1. Ensure you have an up-to-date checkout (git pull!)

2. Edit the Changelog. Fill in the placeholders for version, release date and commit SHA. Add a placeholder above. Commit and push that. See an example commit

3. Create tag and push it

$ git tag -a r5.9.X -m "- Release 5.9.X"
$ git push origin r5.9.X

4. Verify it worked, then write the blog announcement

$ mkdir tmp && cd tmp
$ wget 'http://xp-framework.net/setup/5.9.X' -O - | php -- -d .

Then go to http://blog.xp-framework.net/entries? and create the blog entry in Releases, Announcement, 5.9

5. Bump the version Edit the core/src/main/php/VERSION file and bump the version number inside.

6. Close the release issue (see here for an example) and create a new one with the new version number.

Debugging build system

If anything should go wrong, you can look into the build system's logfiles as follows:

$ ssh [email protected] 'supervisorctl tail xpbuild:xpbuild.fetch'
$ ssh [email protected] 'supervisorctl tail xpbuild:xpbuild.xarrelease'