Hello World Syndesis!

Syndesis is an open Source Integration Platform As A Service (IPaaS), on premise or in the cloud, with no coding required. A business analyst can set up their own Twitter to Salesforce campaign and deploy the integration in a container on OpenShift.

The easiest way to try Syndesis is to use a trial of the product called Fuse Online. You can sign up at https://www.redhat.com/en/technologies/jboss-middleware/fuse-online, and skip right to the QuickStart section.

However if you’re like me and you want to be able try things out by running it locally, you probably want to run the Syndesis project bits. This is where this blog is about. I will take you through to the few straightforward steps to

  • Install a mini cloud ‘MiniShift’ on your laptop
  • Install Syndesis on Minishift
  • Run some QuickStarts

1. Install a local mini cloud called MiniShift

In order to have a small cloud running on your laptop you need to install MiniShift. MiniShift is a one node version installation of OpenShift OKD running in a virtual machine. MiniShift supports a few virtualization technogies such as KVM, xHyve, Hyper-V and VirtualBox. To use xHyve on OSX use

brew install docker-machine-driver-xhyve
sudo chown root:wheel $(brew — prefix)/opt/docker-machine-driver-xhyve/bin/docker-machine-driver-xhyve
sudo chmod u+s $(brew — prefix)/opt/docker-machine-driver-xhyve/bin/docker-machine-driver-xhyve

For more details on the commands above, use a different virtualization technology, or if you’re on a different platform see Setting Up the Virtualization Environment. To install minishift itself use

brew cask install minishift

or simply download the minishift binary from github.

2. Install Syndesis

We will now download the docker images from our official dockerhub repository and start them on your minishift installation using

bash <(curl -sL https://syndes.is/start)

This will take a few minutes depending on your download speed, but this is all there is to it. For more details see syndesis.io.

3. Let’s run some QuickStarts!

The QuickStarts can be found in their own github repository, so let’s clone this repo locally either directly or by forking it first. To clone it directly navigate to a preferred location on your local filesystem and use

git clone https://github.com/syndesisio/syndesis-quickstarts.git

To try out the QuickStarts you can simply follow the instructions in each QS example and import the prebuild integration by importing the example’s zip file. Each example also contains a link to a quick demo. Here is the one for Hello World! It periodically send a message to the Log Connector.

A good second quickstart would be the db-2-db scenario as it will become a bit more useful and it involves mapping data shapes between the Start and Finish connector

Besides the Log and Database Connectors, there are are many out of the box connectors such as AMQ, Database, Twitter, Salesforce, etc, etc. Basically there will be a connector for each of the Apache Camel Components.

Please run some more QS to see more of these Connectors in action to get a real feel for the power of Syndesis.

Become part of the Syndesis community!

We are an Open Source, Apache 2 Licensed project. You are free to use our project but to ensure the health of our project we need your feedback. Become a part of our community. We love hearing your experiences, please log any issues you find or even better contribute a patch back for it. Please stay tuned for more information on how to build your own Syndesis extensions. Extensions can both run both on Syndesis as on Fuse Online.