This document illustrates at high level the core components of Syndesis and how they communicate together to serve integrations.
Syndesis is composed by several components that are deployed automatically by the operator component. To install Syndesis, you just have to deploy an instance of the operator which will take care of deploying the rest of the components and make sure there is always one healthy instance up. The operator version will be determining the version of Syndesis you are deploying.
Figure 1. Overview of the architecture
Let’s recap the list of main components involved in Syndesis:
- UI: component dedicated to serve the user interface
- Server: orchestrates the interaction between components and provides an API to the UI
- DataBase: stores configuration regarding configuration, connections and integrations
- Meta: reports specific information of each connector
- S2I: creates runtimes where the integrations will run
Here is a bottom up view of how an integration is created on Syndesis.
Creating an Integration
The user will interact to the system through the UI that will use the REST API of the Server to create the integration. All the data regarding that integration is stored on a PostgreSQL Database. Any possible special feature needed by some connector is bridged by the Meta component that is queried by the Server, again, through another REST API.
Figure 2. Backend architecture
There is a Project Generator, built by the S2I component, whose output is a Dockerized Integration Runtime used by all our integrations. This runtime contains all the dependencies that the integration will be needing. It bundles together a docker image that will be used as extension point by the final defined integration.
In our case the integration generated is a Spring Boot application that will be kicked off in a container: everything completely transparent to the final user!
By default, Syndesis uses Apache Camel as a runtime target, though it would be possible to extend the project and use any other similar integration platform. Both Camel and Camel-k are supported.
When you need a new type of connection, you generally start by defining how this connection will interact with the Integration Runtime (Apache Camel by default). In Syndesis this is mediated by the ComponentProxy whose goal is to decouple the Syndesis specific model from the integration platform.
Through the development of a Connector you will be able to bring your integration platform functionality in Syndesis. For example, you will be able to port any Camel component into Syndesis by developing a wrapper that acts as Connector inside Syndesis.
You can find more information about Connectors and how to implement them on the Connectors section.
The whole list of connectors will be your list of available sources/destination that you will be able to use in your Syndesis integration.