...
For fully testing a release candidate, you should have the following installed on your system:
- JDK (tested with required: JDK 1117+)
- Maven (tested with 3.6)
- NodeJS + NPM (tested with v16+/ v8+)
- Docker + Docker-Compose
...
| Code Block |
|---|
| language | bash |
|---|
| title | Download release artifacts |
|---|
|
# download all release artifacts (core, extensions, installer)
wget --recursive --no-host-directories -e robots=off --cut-dirs=5 --no-parent --reject "index.html*" https://dist.apache.org/repos/dist/dev/streampipes/ |
...
| Code Block |
|---|
| language | bash |
|---|
| title | Verify signature |
|---|
|
gpg --verify apache-streampipes-{current-full-version}-source-release.zip.asc apache-streampipes-{current-full-version}-source-release.zip
# example
gpg --verify apache-streampipes-0.9092.0-source-release.zip.asc apache-streampipes-0.9092.0-source-release.zip |
Verify the checksum
| Code Block |
|---|
|
sha512sum -c apache-streampipes-{current-full-version}-source-release.zip.sha512
# example:
sha512sum -c apache-streampipes-0.9092.0-source-release.zip.sha512
# alternative (if you get an error such as no properly formatted SHA512 checksum lines found)
# print the checksum
cat apache-streampipes-0.9092.0-source-release.zip.sha512
# print the checksum of the zip file
sha512sum apache-streampipes-0.9092.0-source-release.zip
# compare both checksums |
...
| Code Block |
|---|
|
unzip apache-streampipes-{current-full-version}-source-release.zip
cd apache-streampipes-{current-full-version}/
# example:
unzip apache-streampipes-0.9092.0-source-release.zip
cd apache-streampipes-0.9092.0/ |
Verify legal information and required files
...
| Code Block |
|---|
|
# cd ui
npm install --legacy-peer-deps
# legacy-peer-deps flag needed to ignore dependencies created during the build process
npm run build |
Start test system
...
| Code Block |
|---|
| title | Set proper line encoding in docker entrypoint |
|---|
|
# in most cases, this mightstep beis optional - seems to only occur in rare cases on Windows systems
# Set the correct EOL encoding for the UI entrypoint file (docker-entrypoint.sh) file to LF:
awk 'BEGIN{RS="^$";ORS="";getline;gsub("\r","");print>ARGV[1]}' ui/docker-entrypoint.sh
# Alternative: Open the file ui/docker-entrypoint.sh, change the eol encoding to "LF" (e.g., in Notepad++ by clicking on "Windows CRLF" in the bottom status bar). |
...
| Code Block |
|---|
| title | Build Docker images and start |
|---|
|
# from root directory
docker-compose up --build -d
# Use docker-compose up to run it in foreground
# Docker images will be locally built |
...