User Tools

Site Tools


beewm:devel:compiling_and_making_releases

This is an old revision of the document!


Compiling BeeWM

BeeWM uses gradle to compile and test. It is recommended to use Oracle JDK 7 with BeeWM. To set up JDK 7, assign the JAVA_HOME variable, for example:

export JAVA_HOME="/opt/bda/java-7-sun"

To compile from the command line, use:

# clean the last build for a full rebuild:
./gradlew clean

# full compile with tests:
./gradlew build

# compile excluding the integration tests (that require a cluster queue setup):
./gradlew build -x storageIntegrationTest -x clusterIntegrationTest

# sparse compile excluding all tests:
./gradlew build -x test -x storageIntegrationTest -x clusterIntegrationTest

Making BeeWM Releases

Tagging the current Release

To compile a release, tag the GIT repository for the release (for example 0.3.2):

# find the last commit of the 0.3.2 series, to set the tag there:
git log|less

# tag the commit with its checksum (or part of it):
git tag 0.3.2 4a391b3236770dd70390029af4846d18a4554444

Compiling the Current Release for Deployment

# full recompiled release with testing
./gradlew clean build distTar

# full recompiled release without integration testing
./gradlew clean build distTar -x storageIntegrationTest -x clusterIntegrationTest

# find the release files for BeeWM and the Webclient in the directories (here given with pre-release file name as an example) :
bee-webclient/build/distributions/bee-webclient-0.4.0-SNAPSHOT-33-g0cf3e1a.tar.gz
bee-workflowmanager/build/distributions/bee-workflowmanager-0.4.0-SNAPSHOT-33-g0cf3e1a.tar.gz

Tagging for the next Release Series

After a version is finished and released, enter the release date in Jira, and tag the GIT repository for the next release series. Assuming the current release was 0.3.2, tag for the next release 0.4.0:

# find the first commit of the 0.4.0 series, to set the tag there:
git log|less

# tag the commit with its checksum (or part of it):
git tag 0.4.0-SNAPSHOT 70004f4e725840d7835f0ebe3a835e22e8d4e8ac

# push the new tags to the server:
git push origin --tags

Integrating gradle with Eclipse

To set up a the development environment to develop bee first download the enterprise java version of the Eclipse IDE. After installing Eclipse one should install the Gradle IDE plugin for Eclipse.

NOTE: When this guide was written Gradle IDE was not working with the latest Gradle version which is used by default. To be able to use it one should download Gradle 1.12 from gradle.org install it and and change the preferences of Gradle IDE to use this version.

After installing Gradle IDE the source can be imported via the import as Gradle Project. The root folder in the import wizard should be set to the root directory of the repository then Build Model should be executed. After building the model the subproject can be selected an imported.

beewm/devel/compiling_and_making_releases.1465392719.txt.gz ยท Last modified: 2016/06/08 15:31 by admin