...
(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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
mvn clean package |
Start test system
Code Block | ||
---|---|---|
| ||
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)
...