Chapter 1. Release notes
Release notes contain information about new features, deprecated features, breaking changes, and known issues. The following release notes apply to the most recent serverless logic releases on OpenShift Container Platform.
1.1. serverless logic 1.39
serverless logic 1.39 is generally available. New features that pertain to serverless logic on OpenShift Container Platform are included in the following notes:
1.1.1. New features
- Built-in MDC logging for workflow process and instance correlation
serverless logic includes built-in Mapped Diagnostic Context (MDC) logging that automatically adds process correlation fields, such as
processIdandinstanceId, to log lines during workflow execution. As a result, you can correlate and troubleshoot workflow logs more effectively.- Built-in sensitive data masking in workflow logging
serverless logic includes a configurable sensitive data masking filter for workflow logging. When enabled, the filter automatically masks sensitive data, such as Bearer tokens and Authorization headers, in log output. You can specify custom masking patterns using regular expressions in the application configuration. As a result, the filter helps reduce the risk of exposing sensitive data in workflow log output during development and troubleshooting.
- Custom pod labels for Data Index and Job Service
serverless logic supports configuring custom labels on Data Index and Job Service pods by setting the
podTemplate.metadata.labelsfield in theSonataFlowPlatformcustom resource (CR). As a result, you can attach custom metadata to these pods for purposes such as tracking, policy enforcement, or third-party tool integration.- Logical workflow versioning
serverless logic introduces a logical workflow versioning strategy that allows multiple versions of a workflow to share the same workflow identifier, linked through the
sonataflow.org/idannotation in theSonataFlowcustom resource (CR). This enables services such as Data Index to group different versions under a unified workflow lineage. As a result, you can deploy and manage multiple versions of a workflow while maintaining a consistent identity across the platform.
1.1.2. Removed features
- Dashbuilder is removed
The Dashbuilder component, which provided dashboard capabilities in the serverless logic Management Console, is removed and is no longer supported. You can monitor workflows by using Prometheus metrics with Grafana dashboards instead.
1.2. serverless logic 1.38
serverless logic 1.38 is now available. New features and fixed issues that pertain to serverless logic on OpenShift Container Platform are included in the following notes:
1.2.1. New features
- Workflows runtime configuration aligned with Quarkus 3.20.1 format
This release aligns the workflow runtime configuration with the Quarkus 3.20.1 format. This helps eliminate configuration format warnings from service logs at startup.
- Configurable leader lease parameters for the operator
serverless logic supports configuring leader lease parameters for the operator. This enhancement addresses operator pod restarts that can occur in busy clusters due to leader lease timeout issues. The operator includes improved default values and provides configuration options for fine-tuning in specific environments. As a result, the operator helps maintain more stable operation in high-load cluster conditions.
- Horizontal Pod Autoscaling support for workflows and Data Index deployments
serverless logic supports configuring Horizontal Pod Autoscaling (HPA) for both SonataFlow workflows and Data Index service deployments. This enhancement enables automatic scaling of these services based on resource utilization. As a result, workflows and Data Index services can scale automatically in response to workload demands.
- Pod Disruption Budget support for workflows and Data Index deployments
serverless logic supports configuring Pod Disruption Budgets (PDB) for both SonataFlow workflows and Data Index service deployments. This enhancement protects services from unintended disruptions during voluntary cluster operations such as node reboots or upgrades. As a result, workflows and Data Index services can help maintain availability during planned cluster maintenance activities.
- Updated OpenJDK base container images
This release updates all serverless logic container images to use
ubi9/openjdkversion1.24as the parent base image. This update addresses identified Common Vulnerabilities and Exposures (CVEs) in the previous version. As a result, container images include the latest security fixes.
1.2.2. Fixed issues
- Retrying jobs no longer cancel during periodic job loading
Before this update, periodic job loading cancelled jobs in a retrying state. As a consequence, retrying jobs could terminate unexpectedly. With this release, the Jobs Service no longer cancels retrying jobs during periodic loading. As a result, retrying jobs can complete successfully.
- Large schemas with multi-byte characters no longer fail compilation
Before this update, large schemas containing multi-byte characters exceeded Java compilation byte-size limits. As a consequence, workflows using large schemas with special characters, such as emojis, failed to compile. With this release, the build process splits large schema strings into smaller chunks. As a result, large schemas with multi-byte characters compile successfully.
- Subflows no longer remain active after parent workflow cancellation
Before this update, cancelling a parent workflow did not cancel its active subflows. As a consequence, subflows continued to run after the parent workflow was aborted. With this release, cancelling a parent workflow cancels all associated subflows. As a result, aborting a parent workflow terminates all subflow instances.
1.3. serverless logic 1.37.2
serverless logic 1.37.2 is now available. This release addresses identified Common Vulnerabilities and Exposures (CVEs) to enhance security and reliability. The following notes describe fixed issues that affect serverless logic on OpenShift Container Platform.
1.3.1. Fixed issues
- Support for JSON schema files larger than 65 KB in
SonataFlowworkflows Before this update, serverless logic loaded JSON schema input validation files as strings during the build process. The system assumed that schema files would not exceed 65 KB. As a consequence, workflows failed to process schema files larger than 65 KB. With this release, the workflow build process supports larger JSON schema files. As a result, workflows can use JSON schema files that exceed the earlier 65 KB limitation.
1.4. serverless logic 1.37.1
serverless logic 1.37.1 is now available. This release of serverless logic addresses identified Common Vulnerabilities and Exposures (CVEs) to enhance security and reliability. Fixed issues and known issues that pertain to serverless logic on OpenShift Container Platform are included in the following notes:
1.4.1. New features
- OpenTelemetry support for workflow observability in serverless logic
- serverless logic now includes OpenTelemetry support to provide observability for workflow executions. This enhancement enables users to collect and export telemetry data for improved monitoring and tracing of workflows.
1.4.2. Fixed issues
- Removal of unused webhook server initialization in serverless logic Operator
Before this update, the serverless logic Operator initialized webhook server code that the Operator did not use. As a consequence, the Operator included unnecessary initialization logic in its startup sequence. With this release, the serverless logic Operator removes the unused webhook server initialization code. As a result, the Operator startup process no longer includes unused webhook server components.
- Incorrect hibernate schema initialization option in Data Index PostgreSQL deployments
Before this update, the serverless logic Operator configured Data Index PostgreSQL deployments with the
QUARKUS_HIBERNATE_ORM_DATABASE_GENERATION=updateenvironment variable, resulting in an unintended database schema generation strategy. With this release, the Operator no longer sets this environment variable for Operator-managed Data Index deployments. As a result, Data Index now uses the correct schema initialization configuration.- Variables and metadata queries restored in serverless logic GraphQL
Before this update, serverless logic 1.37 did not support variables and metadata queries in GraphQL because JSON query capability was missing. As a consequence, GraphQL queries that relied on variables and metadata failed. With this release, serverless logic introduces JSON query capability for GraphQL. As a result, variables and metadata queries now function as expected.
1.5. serverless logic 1.37
serverless logic 1.37 is now available. New features, updates, fixed issues, and known issues that pertain to serverless logic on OpenShift Container Platform are included in the following notes:
1.5.1. New features
serverless logic introduces a new data index mutation named
ExecuteAfter, which enables you to create and execute a new workflow instance that can reuse the output of a previously completed workflow as its input.The
ExecuteAftermutation accepts the following arguments:-
processId: Specifies the process ID of the workflow definition to execute. -
processVersion: Specifies the process version of the workflow definition to execute. -
completedInstanceId(optional): Specifies the ID of a previously completed workflow whose output serves as input for the new workflow instance. -
input(optional): Specifies the additional input data, which the system merges with the output of thecompletedInstanceId, if you provide it. -
excludeProperties(optional): Specifies the list of properties that the system does not copy from thecompletedInstanceIdoutput into the new workflow instance input.
-
- serverless logic container images now use the RHEL UBI 9 parent image, aligning the serverless logic components with the RHEL 9 runtime environment.
-
serverless logic Operator now uses a simplified
ClusterServiceVersion(CSV) naming schema that removes therhel9suffix. For example, the CSV name is nowlogic-operator.v1.37.0. - serverless logic now provides a landing web application for the Jobs Service and Data Index services, offering users a centralized entry point to access and explore these services.
- serverless logic now supports dynamic URLs and security configurations for OpenAPI function calls in workflows, enabling workflows to adapt securely to different environments and endpoints.
- serverless logic now includes a new guide that explains how to configure Maven mirrors in builder and devmode images.
-
serverless logic now supports token exchange by introducing JSON Web Token (JWT) token parsing for SonataFlow workflows. This feature adds a new Quarkus add-on,
sonataflow-addons-quarkus-jwt-parser, which enables workflows to parse JWT tokens and extract user claims to generate personalized responses.
1.5.2. Fixed issues
- Before this update, the Sleep state removed tokens from the workflow context when used within a sub-flow. This issue is now fixed, ensuring that tokens remain available throughout the workflow execution.
- Before this update, converting a project to a Quarkus project using the Kn workflow plugin generated incorrect Maven repositories. This issue is now fixed, and the conversion process generates the correct Maven repositories.
-
Before this update, the serverless logic Builder image downloaded
plexus-utilsversion 1.1. This issue is now fixed, and the Builder image no longer downloads this dependency.
1.5.3. Known issues
-
In disconnected cluster environments, the
logic-swf-builder-rhel9image attempts to download theplexus-utils-1.1.jardependency during the build process. As external network access is restricted in disconnected setups, this behavior can result in build failures or timeouts. -
If you apply a
SonataFlowcustom resource (CR) to an OpenShift cluster and the firstSonataFlowBuildfails for any reason, the Operator does not create the workflow deployment even after the build issue is resolved. As a result, the workflow remains undeployed until you manually reapply or rebuild it.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}