You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@streampipes.apache.org by ze...@apache.org on 2023/06/16 09:23:21 UTC

[streampipes-website] branch release/0.92.0 created (now 1bf1ec3d)

This is an automated email from the ASF dual-hosted git repository.

zehnder pushed a change to branch release/0.92.0
in repository https://gitbox.apache.org/repos/asf/streampipes-website.git


      at 1bf1ec3d [release] Update docusaurus version

This branch includes the following new commits:

     new de9a8ad9 [release] Update release version and add blog post
     new 1bf1ec3d [release] Update docusaurus version

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



[streampipes-website] 01/02: [release] Update release version and add blog post

Posted by ze...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

zehnder pushed a commit to branch release/0.92.0
in repository https://gitbox.apache.org/repos/asf/streampipes-website.git

commit de9a8ad925c9dd8517233c008ff39b5d0b3d5d86
Author: Philipp Zehnder <te...@users.noreply.github.com>
AuthorDate: Fri Jun 16 11:16:56 2023 +0200

    [release] Update release version and add blog post
---
 documentation/docs/01_try-installation.md          |  10 ++--
 .../website/blog/2023-06-16-release-092.md         |  54 +++++++++++++++++++++
 .../blog/assets/2023-06-16/file_stream_set.gif     | Bin 0 -> 922280 bytes
 .../assets/2023-06-16/swinging_door_trending.gif   | Bin 0 -> 1753679 bytes
 website/partials/_download_box.ejs                 |  10 ++--
 website/partials/_nav.ejs                          |   2 +-
 6 files changed, 65 insertions(+), 11 deletions(-)

diff --git a/documentation/docs/01_try-installation.md b/documentation/docs/01_try-installation.md
index 5c838539..b274b25f 100644
--- a/documentation/docs/01_try-installation.md
+++ b/documentation/docs/01_try-installation.md
@@ -62,13 +62,13 @@ best experience), Firefox or Edge.
                     <tbody>
                     <tr>
                         <td>
-                            <a href="https://www.apache.org/dyn/closer.lua?action=download&filename=streampipes/0.91.0/apache-streampipes-0.91.0-source-release.zip">apache-streampipes-0.91.0-source-release.zip</a>
+                            <a href="https://www.apache.org/dyn/closer.lua?action=download&filename=streampipes/0.92.0/apache-streampipes-0.92.0-source-release.zip">apache-streampipes-0.92.0-source-release.zip</a>
                         </td>
-                        <td>0.91.0</td>
-                        <td>2023-04-14</td>
+                        <td>0.92.0</td>
+                        <td>2023-06-16</td>
                         <td>
-                            <a href="https://downloads.apache.org/streampipes/0.91.0/apache-streampipes-0.91.0-source-release.zip.sha512">SHA</a>
-                            <a href="https://downloads.apache.org/streampipes/0.91.0/apache-streampipes-0.91.0-source-release.zip.asc">PGP</a>
+                            <a href="https://downloads.apache.org/streampipes/0.92.0/apache-streampipes-0.92.0-source-release.zip.sha512">SHA</a>
+                            <a href="https://downloads.apache.org/streampipes/0.92.0/apache-streampipes-0.92.0-source-release.zip.asc">PGP</a>
                         </td>
                     </tr>
                     </tbody>
diff --git a/documentation/website/blog/2023-06-16-release-092.md b/documentation/website/blog/2023-06-16-release-092.md
new file mode 100644
index 00000000..af4fb75a
--- /dev/null
+++ b/documentation/website/blog/2023-06-16-release-092.md
@@ -0,0 +1,54 @@
+---
+title: Apache StreamPipes release 0.92.0
+author: Philipp Zehnder
+authorURL: https://github.com/tenthe
+authorImageURL: /docs/img/zehnder.png
+---
+**<div style="float: left; padding-right: 40px;">8 minutes to read</div>**
+<br>
+
+We are excited to announce the release of StreamPipes 0.92.0!
+This release is packed with bug fixes, improvements, and new features, all aimed at enhancing your experience with StreamPipes.
+Let's dive into the highlights of this release:
+
+<!--truncate-->
+
+The current release can be downloaded <a href="https://streampipes.apache.org/download.html">here</a>.
+
+## Improved Python Support:
+Based on valuable user feedback, we have made significant enhancements to the Python support in StreamPipes.
+Now, you can effortlessly integrate Python-based scripts, libraries, and modules into your functions, allowing you to leverage the power of machine learning and advanced analytics algorithms on your IIoT data sources.
+Check out our [python documentation](https://streampipes.apache.org/docs/docs/python/latest/).
+
+## New Processing Elements: Introducing the Swinging Door Trending (SDT) Filter Processor:
+To expand the functionality of StreamPipes, we have introduced several new processing elements.
+Among them is the **Swinging Door Trending (SDT) Filter Processor**.
+This algorithm enables you to perform sophisticated data processing tasks and enhance your data analytics pipelines.
+
+<img src="/docs/blog/assets/2023-06-16/swinging_door_trending.gif" alt="demonstration how to use the swinging door trending processor">
+
+## Bug Fixes and Improvements:
+We have addressed various bugs and issues reported by our users, resulting in a more stable and reliable StreamPipes experience.
+We have also made several performance and usability improvements to enhance overall system efficiency.
+
+## Deprecation of Set Adapters
+In our ongoing efforts to streamline the StreamPipes ecosystem, we have deprecated the Set Adapters functionality.
+Our focus now lies solely on streaming event sources. However, we understand the importance of working with files of sensor data especially during development.
+That's why we have extended the **File Stream Adapter** to accommodate this need. It now offers two functionalities:
+1. Create a live simulation of sensor data based on the file
+2. Only replay the data in the file once, e.g. to store it in the **Data Lake**.
+
+**IMPORTAN: The set adapters will be removed in the next release.**
+
+From this release onwards, we encourage you to utilize the **File Stream Adapter** instead of the **File Set Adapter**. 
+To simulate a file set using the **File Stream Adapter**, simply set the configuration to `Replay Once: Yes` and `Replay Speed: Fastest (Ignore original time)`. 
+Take a look at the example below:
+
+<img src="/docs/blog/assets/2023-06-16/file_stream_set.gif" alt="demonstration how to use file sets with the file stream adapter">
+
+## Final Remarks
+We highly recommend updating to StreamPipes 0.92.0 to take advantage of these new features and improvements.
+For more detailed information, please refer to our [release notes](https://github.com/apache/incubator-streampipes/blob/release/0.92.0/RELEASE_NOTES.md#0920).
+
+Thank you for your support and valuable feedback.
+StreamPipes is constantly evolving, and we remain committed to providing you with a powerful and reliable platform for your IIoT streaming data needs.
diff --git a/documentation/website/blog/assets/2023-06-16/file_stream_set.gif b/documentation/website/blog/assets/2023-06-16/file_stream_set.gif
new file mode 100644
index 00000000..84a4cc92
Binary files /dev/null and b/documentation/website/blog/assets/2023-06-16/file_stream_set.gif differ
diff --git a/documentation/website/blog/assets/2023-06-16/swinging_door_trending.gif b/documentation/website/blog/assets/2023-06-16/swinging_door_trending.gif
new file mode 100644
index 00000000..4728d7b2
Binary files /dev/null and b/documentation/website/blog/assets/2023-06-16/swinging_door_trending.gif differ
diff --git a/website/partials/_download_box.ejs b/website/partials/_download_box.ejs
index c9ecebea..61b1b04d 100644
--- a/website/partials/_download_box.ejs
+++ b/website/partials/_download_box.ejs
@@ -20,12 +20,12 @@
                     </thead>
                     <tbody>
                     <tr>
-                        <td><a href="https://www.apache.org/dyn/closer.lua?action=download&filename=streampipes/0.91.0/apache-streampipes-0.91.0-source-release.zip">apache-streampipes-0.91.0-source-release.zip</a></td>
-                        <td>0.91.0</td>
-                        <td>2023-04-14</td>
+                        <td><a href="https://www.apache.org/dyn/closer.lua?action=download&filename=streampipes/0.92.0/apache-streampipes-0.92.0-source-release.zip">apache-streampipes-0.92.0-source-release.zip</a></td>
+                        <td>0.92.0</td>
+                        <td>2023-06-16</td>
                         <td>
-                            <a href="https://downloads.apache.org/streampipes/0.91.0/apache-streampipes-0.91.0-source-release.zip.sha512">SHA</a>
-                            <a href="https://downloads.apache.org/streampipes/0.91.0/apache-streampipes-0.91.0-source-release.zip.asc">PGP</a>
+                            <a href="https://downloads.apache.org/streampipes/0.92.0/apache-streampipes-0.92.0-source-release.zip.sha512">SHA</a>
+                            <a href="https://downloads.apache.org/streampipes/0.92.0/apache-streampipes-0.92.0-source-release.zip.asc">PGP</a>
                         </td>
                     </tr>
                     </tbody>
diff --git a/website/partials/_nav.ejs b/website/partials/_nav.ejs
index 50b43607..1cdc6510 100644
--- a/website/partials/_nav.ejs
+++ b/website/partials/_nav.ejs
@@ -1,6 +1,6 @@
 <div class="header-banner">
     <div class="header-banner-news">
-        <b>The Apache StreamPipes community is pleased to announce release 0.91.0! Download the latest version <a class="banner-link" href="/download.html">here</a>.</b>
+        <b>The Apache StreamPipes community is pleased to announce release 0.92.0! Download the latest version <a class="banner-link" href="/download.html">here</a>.</b>
     </div>
     <div style="display: flex; align-items: center;justify-content: flex-end;padding-right:20px;height:40px;">
         <span flex></span>


[streampipes-website] 02/02: [release] Update docusaurus version

Posted by ze...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

zehnder pushed a commit to branch release/0.92.0
in repository https://gitbox.apache.org/repos/asf/streampipes-website.git

commit 1bf1ec3d1a4a1970964b946c35662f424446a25b
Author: Philipp Zehnder <te...@users.noreply.github.com>
AuthorDate: Fri Jun 16 11:22:26 2023 +0200

    [release] Update docusaurus version
---
 documentation/docs/01_try-installation.md          |  7 ---
 documentation/website/i18n/en.json                 |  8 ++++
 .../version-0.91.0/01_try-installation.md          |  7 ---
 .../version-0.92.0}/01_try-installation.md         | 10 +----
 .../version-0.92.0/06_extend-setup.md              | 51 ++++++++++++++++++++++
 documentation/website/versions.json                |  1 +
 6 files changed, 62 insertions(+), 22 deletions(-)

diff --git a/documentation/docs/01_try-installation.md b/documentation/docs/01_try-installation.md
index b274b25f..35a18f4a 100644
--- a/documentation/docs/01_try-installation.md
+++ b/documentation/docs/01_try-installation.md
@@ -32,13 +32,6 @@ best experience), Firefox or Edge.
 
 ## Install StreamPipes
 
-<div class="admonition info">
-    <div class="admonition-title">Migration from 0.90.0 to 0.91.0</div>
-    <p>When upgrading an existing installation from 0.90.0 to 0.91.0, set the environment variable 
-<b>SP_INFLUX_INIT_MODE</b> to <b>upgrade</b> instead of <b>setup</b> due to an upgrade of the underlying time-series storage. </p>
-<p>Depending on the installation type, this needs to be set in the <b>.env</b> or the <b>values.yml</b> file.</p>
-</div>
-
 <ul style="padding-left:0">
     <li class="installation-step" style="margin-top:20px;">
         <div class="wrapper-container" style="">
diff --git a/documentation/website/i18n/en.json b/documentation/website/i18n/en.json
index d5ba9198..56a7897e 100644
--- a/documentation/website/i18n/en.json
+++ b/documentation/website/i18n/en.json
@@ -2619,6 +2619,14 @@
       "version-0.91.0/version-0.91.0-user-guide-introduction": {
         "title": "Apache StreamPipes Documentation",
         "sidebar_label": "Overview"
+      },
+      "version-0.92.0/version-0.92.0-try-installation": {
+        "title": "Installation",
+        "sidebar_label": "Installation"
+      },
+      "version-0.92.0/version-0.92.0-extend-setup": {
+        "title": "Development Setup",
+        "sidebar_label": "Development Setup"
       }
     },
     "links": {
diff --git a/documentation/website/versioned_docs/version-0.91.0/01_try-installation.md b/documentation/website/versioned_docs/version-0.91.0/01_try-installation.md
index 265908d2..75198893 100644
--- a/documentation/website/versioned_docs/version-0.91.0/01_try-installation.md
+++ b/documentation/website/versioned_docs/version-0.91.0/01_try-installation.md
@@ -33,13 +33,6 @@ best experience), Firefox or Edge.
 
 ## Install StreamPipes
 
-<div class="admonition info">
-    <div class="admonition-title">Migration from 0.90.0 to 0.91.0</div>
-    <p>When upgrading an existing installation from 0.90.0 to 0.91.0, set the environment variable 
-<b>SP_INFLUX_INIT_MODE</b> to <b>upgrade</b> instead of <b>setup</b> due to an upgrade of the underlying time-series storage. </p>
-<p>Depending on the installation type, this needs to be set in the <b>.env</b> or the <b>values.yml</b> file.</p>
-</div>
-
 <ul style="padding-left:0">
     <li class="installation-step" style="margin-top:20px;">
         <div class="wrapper-container" style="">
diff --git a/documentation/docs/01_try-installation.md b/documentation/website/versioned_docs/version-0.92.0/01_try-installation.md
similarity index 93%
copy from documentation/docs/01_try-installation.md
copy to documentation/website/versioned_docs/version-0.92.0/01_try-installation.md
index b274b25f..b3df6edb 100644
--- a/documentation/docs/01_try-installation.md
+++ b/documentation/website/versioned_docs/version-0.92.0/01_try-installation.md
@@ -1,7 +1,8 @@
 ---
-id: try-installation
+id: version-0.92.0-try-installation
 title: Installation
 sidebar_label: Installation
+original_id: try-installation
 ---
 
 The easiest way to install StreamPipes is our Docker-based installation. For production-grade deployments, we also
@@ -32,13 +33,6 @@ best experience), Firefox or Edge.
 
 ## Install StreamPipes
 
-<div class="admonition info">
-    <div class="admonition-title">Migration from 0.90.0 to 0.91.0</div>
-    <p>When upgrading an existing installation from 0.90.0 to 0.91.0, set the environment variable 
-<b>SP_INFLUX_INIT_MODE</b> to <b>upgrade</b> instead of <b>setup</b> due to an upgrade of the underlying time-series storage. </p>
-<p>Depending on the installation type, this needs to be set in the <b>.env</b> or the <b>values.yml</b> file.</p>
-</div>
-
 <ul style="padding-left:0">
     <li class="installation-step" style="margin-top:20px;">
         <div class="wrapper-container" style="">
diff --git a/documentation/website/versioned_docs/version-0.92.0/06_extend-setup.md b/documentation/website/versioned_docs/version-0.92.0/06_extend-setup.md
new file mode 100644
index 00000000..acd733e4
--- /dev/null
+++ b/documentation/website/versioned_docs/version-0.92.0/06_extend-setup.md
@@ -0,0 +1,51 @@
+---
+id: version-0.92.0-extend-setup
+title: Development Setup
+sidebar_label: Development Setup
+original_id: extend-setup
+---
+
+Pipeline elements in StreamPipes are provided as standalone microservices. New pipeline elements can be easily developed using the provided Maven archetypes and can be installed in StreamPipes at runtime.
+
+In this section, we describe our recommended minimum setup for locally setting up a development instance of StreamPipes needed to develop, run and test new pipeline elements.
+
+## IDE & required dev tools
+StreamPipes does not have specific requirements on the IDE - so feel free to choose the IDE of your choice.
+The only requirements in terms of development tools are that you have Java 17 and Maven installed.
+
+## StreamPipes CLI: Docker-based local StreamPipes instance
+In order to quickly test developed pipeline elements without needing to install all services required by StreamPipes, we provide a CLI tool that allows you to selectively start StreamPipes components.
+The CLI tool allows to switch to several templates (based on docker-compose) depending on the role. 
+
+The documentation on the usage of the CLI tool is available [here](06_extend-cli.md).
+
+## Override the SP_HOST variable
+
+By default, the backend/core of StreamPipes registers itself within StreamPipes' service discovery mechanism using an auto-discovered hostname.
+Usually, this will be an IP address from the Docker network, which is not resolvable from outside. Therefore, for local development you need to override the hostname with an IP address which is accessible from your local host where you develop extensions.
+When using the CLI, open the CLI folder ``installer/cli``, navigate to ``deploy/standalone/backend``, open the ``docker-compose.dev.yml`` file and add the SP_HOST env variable, e.g.
+
+```
+version: "3.4"
+services:
+  backend:
+    ports:
+      - "8030:8030"
+    environment:
+      - SP_HOST=host.docker.internal
+```
+
+Note that host.docker.internal will work as an alias under Docker for Desktop on Windows and Mac, but not on Linux or M1. In this case, provide a resolvable hostname or IP address manually.
+
+## Starter projects
+
+Now, once you've started the development instance, you are ready to develop your very first pipeline element.
+Instead of starting from scratch, we recommend using our provided maven archetypes:
+
+### Maven archetypes
+
+Create the Maven archetype as described in the [Maven Archetypes](06_extend-archetypes.md) guide.
+
+### Examples
+
+We provide several examples that explain the usage of some concepts in this [Github repo](https://github.com/apache/streampipes-examples). 
diff --git a/documentation/website/versions.json b/documentation/website/versions.json
index 2abba580..15c29ee4 100644
--- a/documentation/website/versions.json
+++ b/documentation/website/versions.json
@@ -1,4 +1,5 @@
 [
+  "0.92.0",
   "0.91.0",
   "0.90.0",
   "0.70.0",