Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

(sorry, the validation script is not yet available and will hopefully be ready after the first ASF release)

Manual validation

Prerequisites

For fully testing a release candidate, you should have the following installed on your system:

  • JDK (tested with JDK 8+)
  • Maven (tested with 3.6)
  • NodeJS + NPM (tested with v12+/ v6+)
  • Docker + Docker-Compose

Download

Download all staged artifacts under the url specified in the release vote email into a directory we’ll now call download-dir.

...

Have a look at the source code to check there are no unexpected binaries, e.g., in the ui folder there shouldn't be any node_modules folder or dist folder.

Build backend & UI

incubator-streampipes-extensions

incubator-streampipes-installer

Verify

gpg --verify zip.asc

if not found

...

From the parent folder of the core, do the following to build the Java-based core:

Code Block
titleBuild Maven
mvn clean install

# we use install here as these dependencies will be later required by streampipes-extensions (with the core modules not yet being available on Maven Central at release validation time)

This build should be successful.

The next step is to build the UI, switch to the ui directory and do the following:

Code Block
titleBuild UI
npm run build-rc

Start test system 

If you want to test the system, there is a convenience docker-compose file that will help you starting the release candidate for testing.

Go back to the main directory (where the docker-compose.yml file is located and do the following:

Code Block
titleBuild Docker images and start
docker-compose up -d

# Use docker-compose up to run it in foreground
# Docker images will be locally built

Once you're done with that, proceed to the next step. Before we test the whole system, we'll build and run the extensions.

incubator-streampipes-extensions

Open the extensions folder (extensions/{version}/{rc}.

Repeat the following steps for the extensions project, similar as explained above:

Verify signature

Verify checksum

Unzip

Verify legal information and required files

Run RAT

Search for SNAPSHOT dependencies


Build extensions

Build the extensions project as follows:

Code Block
titleBuild with Maven
mvn clean package

Start test system

Code Block
titleBuild Docker images and start
docker-compose up -d

# Use docker-compose up to run it in foreground
# Docker images will be locally built

incubator-streampipes-installer




Test


Validation Template

See also the Incubator Release Checklist (which is not official policy, but may help)

...