Chapter 2. Fuse Online
Fuse Online provides a web browser interface that lets a business expert integrate two or more different applications or services without writing code. It also provides features that allow the addition of code if it is needed for complex use cases.
Fuse Online runs an integration on OpenShift as a Spring Boot application that uses Apache Camel. As a Technology Preview feature, Camel K is available as an additional runtime.
2.1. About Fuse Online distributions
Fuse Online is Red Hat’s web-based integration platform. Syndesis is the open source project for Fuse Online. Fuse Online runs in these OpenShift environments:
Red Hat installs and provisions Fuse Online on Red Hat infrastructure.
OpenShift Container Platform
Customer installs and manages.
2.2. New features in Fuse Online 7.6
Fuse Online 7.6 provides the following new features:
The following connectors, which were Technology Preview features in the previous release, are now supported:
- Amazon DynamoDB lets you retrieve data from an Amazon DynamoDB table, add data to a DynamoDB table, or remove data from a DynamoDB table.
- Box lets you connect to a Box server to download or upload a file.
- MongoDB lets you obtain content from a MongoDB database or update content in a MongoDB database.
- Fuse Online now provides enhanced activity tracking (based on Jaeger). Enhanced activity tracking is now enabled by default, when you install Fuse Online on OCP from the command line.
- OpenAPI 3.0 as well as OpenAPI 2.0 is now supported for creating REST API client connectors and API provider integrations.
2.3. Changes in Fuse Online 7.6
Fuse Online 7.6 changes Fuse Online 7.5 features as follows:
Changes to the data mapper:
Mapping from or to a field in a nested collection is now supported. When a source field is nested in a number of collections you can map it to a target field that meets one of these conditions:
- The target field is nested in the same number of collections as the source field.
- The target field is nested in only one collection.
While a conditional expression in a data mapping continues to be a Technology Preview feature, a conditional expression can now:
- Refer to a field that is in a collection.
- Specify any transformation supported by the data mapper.
LT()(less than) function to obtain the smaller of two numbers or the
TOLOWER()function to convert a string to lowercase.
Changes for Fuse Online environments that run on OpenShift Container Platform on-site:
The Fuse Online installation download package now provides a default custom resource file,
default-cr.yml, which you can edit before you install Fuse Online. Edits can enable add-on features and/or change default configuration values. You can install a default Fuse Online environment by running the installation script without editing
default-cr.yml. For details, see Installation of Fuse Online on OCP.
- You can now enable automatic discovery of Kafka brokers (AMQ Streams instances), which makes configuring a Kafka connection easier because the UI can display the broker URL details. See Enabling auto-discovery of Kafka brokers/AMQ Streams.
- Procedures for backing up and restoring Fuse Online environments are now documented. See Managing Fuse Online on OCP.
- The Fuse Online installation download package now provides a default custom resource file,
2.4. Upgrading Fuse Online integrations
The Fuse Online upgrade process depends on whether Fuse Online is installed on Red Hat OpenShift Online or on OpenShift Container Platform (OCP).
- OpenShift Online - When Fuse 7.6 is released, the Fuse Online infrastructure on OpenShift Online is automatically upgraded. You must republish any running integrations as described in Upgrading Fuse Online integrations that are running on OpenShift Online.
- OCP - To upgrade a Fuse Online environment that is running on OpenShift Container Platform on-site, you must download the latest Fuse Online release, run the update script, and then republish any running integrations as described in Upgrading Fuse Online on OCP.
2.5. Important notes for Fuse Online
Important notes for the Fuse 7.6 release of the Fuse Online distribution:
The following limitations apply when the Camel K runtime is installed with Fuse Online:
- Fuse Online extensions are not supported by the Camel K runtime.
Extensions are not displayed in the Fuse Online user interface under Customizations.
Note that Camel K runtime is a Technology Preview feature.
- Enhanced activity tracking is not available, if you install Fuse Online from OperatorHub (see the Fuse Online section of Known Issues). To take advantage of enhanced activity tracking in this release, we recommend that you install Fuse Online using the command-line script instead. See Installing Fuse Online on OCP for details.
- In this release, connections to Kafka do not support SSL. It is expected that this will change in a future release.
- When Fuse Online is installed and provisioned on Red Hat infrastructure, the account is limited to a specific number of integrations that can be running at one time. For details, see the pricing plan. If you are using a Fuse Online evaluation account, then only one integration at a time can be running.
- An OpenAPI schema that you upload to Fuse Online might not define input/output types. When Fuse Online creates a custom API client from an OpenAPI schema that does not specify input/output types then it is not possible to create an integration that maps integration data to fields that the API client can process or from fields that the API client processed. If an integration requires data mapping to or from a custom API, then when you upload the OpenAPI schema, click Review/Edit to open API Designer, which is an API editing tool, and add input/output type specifications.
- An OpenAPI document that you use for a custom API client connector or for an API provider integration cannot have cyclic schema references. For example, a JSON schema that specifies a request or response body cannot reference itself as a whole nor reference any part of itself through any number of intermediate schemas.
2.6. Obtaining technical support for Fuse Online
To obtain technical support, in the Fuse Online console, in the left navigation panel, click Support. Use the Support page to download diagnostic information for all integrations or for one or more integrations that you choose. The page also provides a link for opening a support ticket and providing the diagnostic information that you downloaded.
2.7. Technology Preview features in Fuse Online
This release includes the Technology Preview features that are listed below.
Technology Preview features are not supported with Red Hat production service level agreements (SLAs), might not be functionally complete, and Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. For more information, see Red Hat Technology Preview features support scope.
For Fuse Online environments that run on OpenShift Container Platform on-site, data virtualization is a container-native service. It integrates data from multiple heterogeneous sources, including relational databases, files, web services, and SaaS repositories. In Fuse Online, developers can create a virtual database image that defines a custom, logical view of their source data. They can then deploy that image on OpenShift. Applications connect to the virtual database over a standard OData, REST, or JDBC interface, and can run SQL queries across all of the data sources, even those that do not support SQL.
To enable data virtualization, see Installation of Fuse Online on OCP.
- The Knative connector lets you connect to a Knative channel to obtain or send messages, expose the integration as a Knative service, or call a Knative service.
In the data mapper, you can specify a conditional expression and apply it to one data mapping. For example, a conditional expression can specify evaluation of a source field and how to populate the target field if the source field is empty. The limited set of expressions that you can specify are similar to Microsoft Excel expressions.
Camel K is available as an additional runtime.
To enable Camel K, see Installation of Fuse Online on OCP.
For a REST API client that uses OAuth, when you create an API client connector, you can change the default OAuth2 behavior of connections that you create from that connector. Fuse Online vendor extensions to the OpenAPI specification support the following:
- Providing client credentials as parameters.
- Obtaining a new access token based on HTTP response status codes.