Code Monkey home page Code Monkey logo

syndesis-quickstarts's Introduction

Syndesis Quickstarts

Syndesis makes Camel super easy to use. It packages Camel components as Connectors with a described dataInput and dataOutput shape. This is makes building an integration as easy as clicking Duplos together. Each of our QuickStarts have a little video to see help you build your own integration, plus there is an export file you can use to import to load up the entire scenario. Note that you might have to update things like credentials.

Have fun playing!

1. Introduction to Syndesis

Syndesis is a cloud native application targeted at systems integration. It leverages Apache Camel, and adds a UI layer that helps developers, and more importantly the more technically business analysist, to create integrations without writing any code. Integrations are deployed as Spring Boot applications inside a container onto OpenShift.

The easiest way to try Syndesis is to use a trial of the product called Fuse Online. You can sign up at 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

2. 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 and can be installed on different operating systems:

If you are on MacOS and you want to use Hyperkit, and are ok with homebrew then you can follow the following instructions

brew install hyperkit
brew install docker-machine-driver-hyperkit
sudo chown root:wheel /usr/local/bin/docker-machine-driver-hyperkit
sudo chmod u+s /usr/local/bin/docker-machine-driver-hyperkit

To install minishift itself use

brew cask install minishift
minishift config set vm-driver hyperkit

or simply download the minishift binary from github. Hop onto Gitter to chat with us if you need help with any of this!

3. 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://syndesis.io/start) --vm-driver hyperkit

Note that on Windows you will need something like Cygwin or KornShell for this to work. The installation process itself can take a few minutes depending on your download speed, but this is all there is to it. At the end of the installation it will open your default browser to the syndesis address. By default you can log in using any username/pw combination. For more details see syndesis.io.

4. Let's run some QuickStarts

Syndesis lets you build application without writing any code. Perhaps the easiest way to learn about Syndesis is to simply run to quickstarts. The quickstarts are zero code, so instead we offer Syndesis integration exports from scenarios we built for you. You can try them out by importing an export as an integration into Syndesis. After the import you sometimes may need to re-enter some connection information like passwords. The accompanying README should detail this. We have ordered the Quickstarts loosely ordered by simplicity, so it is recommended to start from the top of this list.

4.1 Prerequisite

Some of the Quickstarts below use a sample database. If you don't see this DB or the sampleDB connection, then edit the syndesis application:

oc edit syndesis

and add demoData: true. Then restart (delete) the db and server pods.

4.2 Integrations

  • Hello World - log 'Hello World!'
  • DB 2 DB - read from a database table, insert in another database table
  • FHIR 2 FHIR - breath 'fire' from a FHIR REST service and update the same record
  • DB 2 API Connector - create a Custom RESTful Connector to the Todo REST API
  • DynamoDB - connect to an AWS DynamoDB database
  • Twitter 2 DB - search twitter and push matches to a database
  • Twitter 2 GMail - search twitter and send out matches in the body of an email
  • Kafka 2 DB - setup a Kafka Broker, then listen to a Kafka Topic and write to a database
  • Jira 2 Twitter - retrieve Jira comments and send them as Twitter direct messages
  • DB 2 GoogleSheets - read from a database, insert into googlesheet.
  • MongoDB - read and write to a MongoDB NoSQL database. You may want to do API Provider before doing this one.

4.3 Flow Manipulation

4.3 API

  • WebHook - create and expose a webhook to invoke an integration with some data
  • API Provider - create and expose a REST interface to (remotely) interact with integration flows
  • API Provider FTP - create and expose a REST interface to interact with FTP server
  • Syndesis API - Syndesis has a public API you can use to integrate Syndesis with your systems

Integration Quickstarts

4.4 Acquire OAuth Credentials for the Syndesis Setting Section

4.5 Advanced Configuration

5. Interesting 3rd Party Projects/Use Cases using Syndesis

Here is a list of projects using Syndesis/FuseOnline:

(if you want a link to your project added, just open a PR)

6. 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. Did I mention we love hearing your experiences? Please log any issues you find or even better contribute a patch back for it. Good luck, and please give us feedback! We love you!

@Syndesisio

syndesis-quickstarts's People

Contributors

balejos avatar claudio4j avatar delawen avatar dhirajsb avatar h0x91b-wix avatar kahboom avatar melissaflinn avatar mkralik3 avatar oscerd avatar squakez avatar zregvart avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

syndesis-quickstarts's Issues

Twitter search doesn't run

I have installed Syndesis on Minishift on my Windows 10 Pro laptop and it runs fine. I did a few quickstarts and these also run fine. I am now following the Twitter to Database quickstart and the integration builds, deploys and starts normally, but then nothing happens. I have validated my Twitter connection and it was successful. I expect the integration to connect to Twitter every 5 seconds, but the integration shows no activity at all. Also the logfile doesn't show any issues. Any suggestions on how to make this work?

What's the default tag that start script is using?

It's great that we can start the syndesis from the minishift with the start script. But it takes me few hours to figure out with version of syndesis can work as the default version doesn't point to the latest stable release.

Is there any tag strategy that we can use in the start script, such as LATEST, STABLE?

I think it could save lots of time for the newbee to try out this great project.

All flows return 501 not implemented in the export .zip

I suspect maybe they should be set to 200 OK?

To do this click on the return path icon at the end of the flow and change the return code, click "Done" and then click "Save as draft" or if you're on the latest Syndesis master clicking on the "Go to operations list" super sekretly saves the integration for you, then I guess it's just a matter of re-exporting.

DB-2-DB quickstart needs update

SELECT * FROM contact returns collection of data. Because of that, the DB-2-DB quickstart needs to add 'split' step to the integration.

In my POV, the video should be updated. Because when the user goes only through video, they can overlook that first step returns collection. After deploying, they can see valid error:

io.atlasmap.api.AtlasException: Errors: [It's not yet supported to have a collection field as a part of multiple source fields in a same mapping: docId='-LYkO4Do5RqQylyKtUqR', path='/<>/first_name'],

Exported integration should be updated too because it is not imported correctly to the actual version of Syndesis. Aggregate step shouldn't be there.
image

IRC channel not open

The readme invites to join the #syndesis IRC channel in case of questions, but the channel doesn't allow to join.

Reason: IRC error on #syndesis: err_needreggednick

unable to find any valid release urls

when i run bash <(curl -sL https://syndesis.io/start) --vm-driver hyperkit on macOS, i receive this error:

[2022-01-06T15:08:06-0500]: Downloading the latest stable release

[2022-01-06T15:08:07-0500]: Running: syndesis minishift --install --full-reset --nodev --open --vm-driver hyperkit
operator binary not found under /Users/jbs/.syndesis/bin/syndesis-operator, attempting to download...
/var/folders/31/jdl6wt7170j1v4ck7_pglm2m0000gn/T/tmp.82cGvtwR/commands/util/operator_funcs: line 94: jq: command not found
unable to find any valid release urls
unable to download the operator binary, exit
ERROR: Last command exited with 1

thanks.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.