Skip to content

Commit

Permalink
improve release blogpost
Browse files Browse the repository at this point in the history
  • Loading branch information
bossenti committed Nov 28, 2023
1 parent a4614c8 commit c885ad3
Show file tree
Hide file tree
Showing 5 changed files with 69 additions and 18 deletions.
5 changes: 4 additions & 1 deletion .htaccess
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,7 @@

RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

RewriteRule ^docs\/*$ docs/user-guide-introduction/ [L] # forward base path of docs to introduction page
RewriteRule "/docs/0.92.0/concepts-overview/06_extend-tutorial-adapters.md/" "docs/0.92.0/extend-tutorial-data-sources/" # forward wrong link definition to correct target
82 changes: 65 additions & 17 deletions website-v2/blog/2023-11-28-release-093.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,11 @@ authorURL: "https://github.com/bossenti"
authorImageURL: "/img/bossenmaier.png"
---

**<div style={{float: 'left', paddingRight: '40px'}}>7 minutes to read</div>**
**<div style={{float: 'left', paddingRight: '40px'}}>9 minutes to read</div>**

We're excited to share the release of StreamPipes 0.93.0, bringing with it a range of bug fixes, performance
enhancements, and new features. This release places a strong emphasis on refining the technical foundations of
StreamPipes, featuring significant changes that set the stage for our upcoming 1.0 release.
Nevertheless, we have also worked on several improvements that are directly visible to the end user.
We're excited to share the release of StreamPipes 0.93.0, bringing with it a range of bug fixes and new features.
This release places a strong emphasis on refining the technical foundations of
StreamPipes, featuring significant changes that set the stage for our major 1.0 release.
Nevertheless, we haven't overlooked the end-user experience and have implemented several enhancements.
Let's delve into the key updates introduced in this release.

Expand All @@ -20,32 +19,58 @@ The current release can be downloaded <a href="https://streampipes.apache.org/do

## Adapters & Pipeline Elements

### Editing existing adapters

StreamPipes has streamlined the process of modifying existing adapter instances, eliminating the inconvenience users
previously faced. In prior versions, altering an adapter required a cumbersome sequence of stopping, deleting, and then
recreating the adapter. However, with the introduction of StreamPipes 0.93.0, this arduous process is now a thing of the
past.

Users can now seamlessly edit running adapters, and the changes will be applied automatically, obviating the need for
the aforementioned manual steps. To guide you through this newfound capability, refer to the below animation,
which demonstrates how to modify an existing adapter.

<img src="/img/blog/2023-11-28/edit-adapter-success.gif" alt="animation of editing a running adapter"/>

<br/><br/>

While the automatic migration seamlessly handles the majority of cases, there are instances where it may not be
feasible. One such scenario arises when an event property, used by a pipeline element, is removed. In such cases,
StreamPipes proactively alerts users before initiating the adapter update. Following the alert, the system takes
precautionary measures by halting the adapter and marking the associated pipeline for review.

<img src="/img/blog/2023-11-28/edit-adapter-fail.gif" alt="animation of editing running adapter where migration cannot be performed"/>

### OPC-UA allows detailed & asynchronous browsing

We have fully reworked the browsing interface of our OPC-UA adapter.

<img src="/img/blog/2023-11-28/opc-ua-demo.gif" alt="demonstration of the new OPC UA capabilities described below"/>

<br/><br/>

Now, all you need to do is specify the URL where the OPC UA server is accessible, eliminating the need to concern
yourself with namespaces or node ids. Once the URL is provided, the adapter effortlessly presents all top-level nodes
within the user interface. You can then navigate through the node tree interactively by clicking on the desired node.

For every data node, accessing node information is a breeze – simply click on the eye icon. If you wish to subscribe to
a particular node, a straightforward click on the plus icon is all it takes.

All the nodes you select become integral to the event structure of this adapter, accessible by clicking on 'Next'. The
All the nodes you select become integral to the event structure of this adapter, accessible by clicking on `Next`. The
ensuing view not only displays the OPC UA status for each node but also allows for the removal of a node with ease,
especially if its status is not 'Good'.
especially if its status is not `Good`.

<img src="/img/blog/2023-11-28/opc-ua-status.png" alt="Screenshot of the OPC UA event view that shows the status codes"/>

### Adapter for S7 PLCs supports array-based data

Until now, our S7 PLC adapter lacked the capability to read values structured in arrays. We're pleased to announce that
this limitation has been addressed through the introduction of an 'Advanced' register input mode.
this limitation has been addressed through the introduction of an `Advanced` register input mode.

<img src="/img/blog/2023-11-28/s7-advanced-mode.png" alt="Screenshot of new advanced register input mode for S7 PLC adapter"/>

<br/><br/>

This new mode empowers you to configure the registers to be queried in a manner specific to the requirements of our
underlying dependency, [PLC4X](https://plc4x.apache.org). For detailed insights and guidance on the configuration
process, refer to the [PLC4X S7 documentation](https://plc4x.apache.org/users/protocols/s7.html).
Expand All @@ -61,18 +86,20 @@ temperature=%DB3.DB0.0[BOOL]

The [IO-Link Master (AL1350)](https://www.ifm.com/de/en/product/AL1350) from ifm comes equipped with an IoT interface
designed for transmitting sensor data via MQTT. With the introduction of this adapter, users gain the capability to
effortlessly incorporate IO-Link sensor data into StreamPipes.

By leveraging this adapter, users can achieve seamless integration, creating a unified and consistent event schema
within StreamPipes. This integration empowers users to effortlessly connect to data from any ifm sensor linked to the
IO-Link Master using StreamPipes.
effortlessly incorporate IO-Link sensor data into StreamPipes. This experimental integration empowers users to
effortlessly connect to data from the ifm sensor VVB001.

For more details refer to
the [adapter documentation](https://streampipes.apache.org/docs/next/pe/org.apache.streampipes.connect.iiot.adapters.iolink/).

For the integration of additional sensors we are thinking about supporting [IODD](https://en.wikipedia.org/wiki/IODD).
Your feedback on these considerations is invaluable to us. If you find the integration of IODD
for supporting more sensors within StreamPipes appealing or have insights to share, we welcome your input. Please let us
know your thoughts on this potential feature enhancement.

### New Processor: Numeric Rounding

Introducing our latest data processor, `Numeric Rounding`, designed to perform rounding operations on numeric values
Introducing our latest data processor, *Numeric Rounding* , designed to perform rounding operations on numeric values
within an event stream. This processor enables users to select one or more numeric values from their event data,
specifying the desired rounding precision and the rounding mode.

Expand All @@ -94,6 +121,14 @@ since startup. This enhancement provides a quick and efficient means to evaluate

<img src="/img/blog/2023-11-28/adapter-information.png" alt="Screenshot that shows the extended information for existing adapters"/>

#### Interactive tutorial is back

Upon initiating a new StreamPipes instance, a dialog prompts users to embark on an interactive tutorial showcasing the
platform's key features. We're pleased to announce that this tutorial is now operational again. Enjoy exploring and
discovering the most important functionalities in StreamPipes. Happy learning!

<img src="/img/blog/2023-11-28/interactive-tutorial.png" alt="Screenshot of the interactive tutorial"/>

## Deployment

### Kubernetes Deployment
Expand Down Expand Up @@ -129,7 +164,6 @@ step-by-step guide on configuring Prometheus and Grafana to monitor StreamPipes

### New Deployment mode for first time users

ChatGPT
To simplify onboarding with Apache StreamPipes and demonstrate its capabilities, we've added a quickstart deployment
option. This docker-compose variant provides users with a pre-configured StreamPipes instance and rich examples. Explore
it in our [user guide]("https://streampipes.apache.org/docs/user-guide-for-quickstart/").
Expand All @@ -156,9 +190,14 @@ greater customization options for notifications.
In this release, we've eliminated legacy resources that were initially employed for demonstration purposes. As these
resources are no longer actively supported, we have decided to completely remove them. The affected components include
the vehicle simulator and watertank simulator.

This removal has led to the discontinuation of the StreamPipes package `streampipes-sources`.

Furthermore, we are pleased to announce the forthcoming removal of Consul as an additional dependency required to run
StreamPipes in the upcoming release. Within this release, we have already implemented the fundamental steps to eliminate
the need for Consul. This marks a significant stride towards making StreamPipes a more lightweight platform. It's
crucial to highlight that this modification is purely a technical enhancement and will have no impact on the end user
experience.

## Enable migrations for pipeline elements

We have established a crucial technical foundation to simplify the update process for upcoming versions of StreamPipes.
Expand All @@ -168,9 +207,18 @@ our [documentation](https://streampipes.apache.org/docs/extend-sdk-migration/).

## New Homepage

We've undergone a comprehensive redesign of our website, [streampipes.apache.org](https://streampipes.apache.org). Take a moment to explore the new look,
We've undergone a comprehensive redesign of our website, [streampipes.apache.org](https://streampipes.apache.org). Take
a moment to explore the new look,
and we welcome your feedback on your experience. Let us know what you think!

## Security

We've addressed a vulnerability in the default password generation for new users during the self-registration process.
Previously, a cryptographically weak pseudo-random number generator (PRNG) was utilized, but we've now rectified this by
implementing Apache Commons RNG. We extend our sincere thanks to Alessandro Albani from the Digital Security Division
Var
Group for bringing this to our attention.

## Final Remarks

We highly recommend updating to StreamPipes 0.93.0 to take advantage of these new features, bug fixes, and improvements.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit c885ad3

Please sign in to comment.