# Make a new release
# Update documents
README.md
inbuild/distribution
. This file will be uploaded to SourceForge and Github ReleasesREADME.html
inclient/protege
. This file will be displayed in the Protégé Plugin Update window.update.properties
file inclient/protege
. This is the configuration file for Protégé plugin Auto Update
# Create a git branch for release
$ git checkout develop
$ git checkout -b releasing/v-number
# Update the version numbers
Update pom.xml files by Maven plugin to a SNAPSHOT version:
$ ./mvnw versions:set -DnewVersion=4.0.0-SNAPSHOT
# Build Maven packages
$ ./mvnw release:clean
# Preparing the release will create the new tag in git and automatically push to github
# When 100% sure, you can skip the test by `-Darguments="-DskipTests"`
$ ./mvnw -DperformRelease=true release:prepare
# stage the release
$ ./mvnw release:perform
# Or stage from a Git tag
# ./mvnw release:perform -DconnectionUrl=scm:git:git@github.com:ontop/ontop.git -Dtag=ontop-3.0.0
# Stage the Maven artifacts
- URL: https://oss.sonatype.org (opens new window)
- Navigate to "Staging Repositories" from the left panel
- Close the repository by clicking the
Close
button - Release the artifacts by clicking the
Release
button
# Build and distribute Ontop bundles
# we can start from the `checkout` directory generated during the Maven release
$ cd target/checkout
$ ./build-release.sh
Further info: Build Instruction
Make a release in Github Releases (opens new window)
Deploy the packages to SourceForge (opens new window) by manual upload or sftp.
$ sftp user,ontop4obda@frs.sourceforge.net
$ cd /home/pfs/project/o/on/ontop4obda
# sftp://ghxiao,ontop4obda@frs.sourceforge.net/home/pfs/project/o/on/ontop4obda
# Update Docker Hub
- Build the docker image using the script
# log in to Docker Hub
# docker login
$ cd ontop/client/docker/
# `-C`: multi-stage build. slow, but safe
# `-x`: push to Docker hub
$ ./build-image.sh -C -x
- Push a new image of ontop/ontop (opens new window) to Docker Hub
# Update the Ontop Website
- Update the guide homepage
- Update the release notes
# Update the API example repository
- Update the Ontop version in https://github.com/ontop/ontop-api-examples (opens new window)
# Update branches for next development iteration
- Merge the tag for the release to master and the release branch to develop
$ git checkout develop
$ git merge release/v-number #branch
# this step is also for triggering the AutoUpdate of Protege plugin
$ git checkout master
$ git merge v-number # tag
# Time for celebration!
- Send release emails to several mail lists and social media