You can try out Syndesis very easily locally, too. All you need is a Minishift installation which is available for all the major operating systems (Linux, OS X and Windows). The following examples assume that you have Minishift installed and can be called with minishift
from the command line. So, minishift
is supposed to be available in your search path, i.e. located in a directory contained in your $PATH
environment variable (Linux, macOS) or in a directory from your system path (Windows).
Rocket launch
Follow the instructions on our QuickStart project https://github.com/syndesisio/syndesis-quickstarts/blob/master/README.md#syndesis-quickstarts
This will take some time until all images are downloaded and installed but eventually your browser should open with the landing page for Syndesis.
=====================================================================
SYNDESIS QUICKSTART
Hybrid integration on OpenShift made easy
=====================================================================
This install will reset your current MiniShift. OK to continue? y
--2019-03-20 08:42:12-- https://github.com/syndesisio/syndesis/archive/master.zip
Resolving github.com (github.com)... 192.30.253.113, 192.30.253.112
....
....
Sleeping 10s ...
syndesis-ui-1-kz5qx 0/1 Running 0 34s
syndesis-ui-1-kz5qx 1/1 Running 0 40s
syndesis-ui-1-deploy 0/1 Completed 0 46s
---------------------------------------------------------------------
Opening http://syndesis.192.168.64.56.nip.io
Here you will be first asked twice to add a security exception for Minishift’s self-signed certificate. Please allow this exception:
Then you reach the OpenShift login mask asked to login. Just use “developer” / “developer” as credentials
Finally you are asked to grant OpenShift permissions to this account which you should accept
Et voilĂ , welcome in Syndesisland !
Using “syndesis” CLI tool
An alternative to the standard installation, you can also use syndesis. This tool, which is also used for building Syndesis itself, provides many more options to tune the installation. As it’s a bash script it it mostly targeted to Unix users (Linux, macOS)
In order to use it, you have to check out the Sydnesis source code from GitHub and set your path to include syndesis
# Clone the Syndesis repository
$ git clone https://github.com/syndesisio/syndesis.git
# Set path to include Syndesis' tool directory
$ export PATH=${PATH}:$(pwd)/syndesis/tools/bin
# Alternatively, set a symbolic link to "syndesis"
$ ln -s $(pwd)/syndesis/tools/bin/syndesis /usr/local/bin
Now you have now two different ways available to install Syndesis:
- syndesis minishift for setting up a Minishift Syndesis installation like described above
- syndesis install for installing Syndesis to any OpenShift cluster.
Please refer to the Syndesis Developer Handbook (SDH) for all the details and possible options. You can always use syndesis --help
for get an online help or syndesis --man
to open the corresponding chapter in the SDH.
Vanilla Minishift
Unfortunately, our scripts are currently not adapted for the Windows operating system. Nevertheless Syndesis also runs on Windows Minishift instances.
You’re going to need a working Minishift installation, which is really easy. If you haven’t got Minishift already installed, please follow the Minishift installation documentation.
Fire up Minishift if it’s not already running. You need to add some memory, 4192 or more is recommended, and allocate a couple of CPUs:
$ minishift start --memory 4192 --cpus 2
Tip: If you want to switch the OpenShift config permanently use:
$ minishift config set memory 8384
$ minishift config set cpus 2
Deploying Syndesis is made easy thanks to OpenShift templates. The template to use in the installation instructions depend on your use case:
User : In case you only want to have the latest version of Syndesis on your local Minishift installation, use the template
syndesis
which uses image stream referring to the published Docker Hub images. Minishift will update its images and trigger a redeployment when the images at Docker Hub changes. Therefore, it checks every 15 minutes for a changed image. You do not have to do anything to get your application updated, except for waiting on Minishift to pick up new images.Developer : Use the template
syndesis-dev
which directly references Docker images without image streams. Then before building the images e.g. withmvn fabric8:build
set yourDOCKER_HOST
environment variable to use the Minishift Docker daemon viaeval $(minishift docker-env)
. When new images are built you only need to delete the appropriate pod so that the new pod spinning up will use the freshly built image.
Depending on your role please use the appropriate template in the instructions below.
Install the OpenShift template syndesis-dev.yml
or syndesis.yml
as discussed above):
$ oc create -f https://raw.githubusercontent.com/syndesisio/syndesis/master/install/syndesis.yml
In order to make it easy to run Syndesis on a cluster without requiring admin rights, Syndesis takes advantage of OpenShift’s ability to use a Service Account as an OAuth client. Before we create the app, we’ll need to create this Service Account:
$ oc create -f https://raw.githubusercontent.com/syndesisio/syndesis/master/install/support/serviceaccount-as-oauthclient-restricted.yml
Deploy Syndesis using the following command, replacing “syndesis-dev” with “syndesis” depending on the template you have just installed:
$ oc new-app syndesis \
-p ROUTE_HOSTNAME=syndesis.$(minishift ip).nip.io \
-p OPENSHIFT_MASTER=$(oc whoami --show-server) \
-p OPENSHIFT_PROJECT=$(oc project -q) \
-p OPENSHIFT_OAUTH_CLIENT_SECRET=$(oc sa get-token syndesis-oauth-client) \
-p SAR_PROJECT=$(oc project -q)
Wait until all pods are running. You can either use OpenShift’s intrinsic watch feature for a line-by-line update
$ oc get pods -w
or use watch
for a more curses like full screen user interface:
$ watch oc get pods
You should now be able to open https://syndesis.$(minishift ip).nip.io
in your browser.
Let’s run some QuickStarts!
You are now ready to run your first integration. We’ve prepared a bunch of QuickStarts to get you going. You can either import or build them from scratch with the accompanying instructions. Here is a link to the QuickStart repositories
https://github.com/syndesisio/syndesis-quickstarts/blob/master/README.md#lets-run-some-quickstarts