User Manual

Overview

Kaoto stands out as an intuitive visual platform for Apache Camel integrations, specifically designed to streamline the development process. It offers an accessible entry point for junior integration engineers through its low-code/no-code capabilities, making the initial steps of integration development straightforward. Moreover, Kaoto supports a seamless transition to more sophisticated features, allowing expert Camel developers to develop and fine-tune complex integration routes effectively.

The audience for this guide is Apache Camel developers. This guide assumes familiarity with Apache Camel and the processing requirements for your organization.

Kaoto is an acronym for Kamel Orchestration Tool. It is a low code and no code integration designer to create and edit integrations based on Apache Camel. Kaoto is extendable, flexible, and adaptable to different use cases. For more information about the history of Kaoto, see Statistics and History of Kaoto.

Kaoto offers a rich catalog of building blocks for use in graphical design. By default, Kaoto loads the official upstream Camel Catalog and Kamelet Catalog.

Benefits of using Kaoto can be listed as follows:

• Enhanced Visual Development Experience

  By leveraging Kaoto’s visual designing capabilities, users can intuitively create, view, and edit Camel integrations through the user interface. This low-code/no-code approach significantly reduces the learning curve for new users and accelerates the development process for seasoned developers.

• Comprehensive Component Catalog Accessibility

  Kaoto provides immediate access to a rich catalog of Camel components, enterprise integration patterns (EIPs), and Kamelets. This extensive Catalog enables developers to easily find and implement the necessary components for their integration solutions. By having these resources readily available, developers can focus more on solving business problems rather than spending time searching for and learning about different components.

• Streamlined Integration Development Process

  The platform is designed with an efficient user experience in mind, optimizing the steps required to create comprehensive integrations. This efficiency is achieved through features like auto-completion, configuration forms, and interactive feedback mechanisms. As a result, developers can quickly assemble and configure integrations, reducing the overall development time. This streamlined process encourages experimentation and innovation by making it easier to prototype and test different approaches.

Installation

Requirements

Microsoft Visual Studio Code

Kaoto ships as a Microsoft Visual Studio Code extension. If you haven’t installed VS Code on your manchine yet, please do that now.

Visit the download page and follow the installation instructions that apply best for you.

Camel CLI

To give you the best user experience we recommend to install the Camel CLI, which offers various functionalities for Camel developers.

Please follow the below steps to install it.

• Install JBang following these instructions
• Verify that JBang is working by executing the following from a command shell. This should output the version of installed JBang.

jbang version

• Run the following command from a command shell to install the Camel CLI:

jbang app install camel@apache/camel

• Check if the Camel CLI is working by executing the following from a command shell. This should output the version of the installed Camel CLI.

camel version

Citrus Testing

If you want to work with the Citrus testing framework, we strongly recommend to install the Citrus JBang plugin.

Please follow the below steps to install it.

• Install JBang following these instructions
• Verify that JBang is working by executing the following from a command shell. This should output the version of installed JBang.

jbang version

• Run the following command from a command shell to install the Citrus JBang plugin:

jbang app install citrus@citrusframework/citrus

• Check if the Citrus JBang plugin is working by executing the following from a command shell. This should output the version of the installed Citrus JBang plugin.

citrus --version

Install Kaoto

• Open VS Code
• Open the Extensions view on the left side panel (or press CTRL+SHIFT+X)
• Type Extension Pack for Apache Camel in the search field
• Click the Install button

Getting Started

This section describes how to

• setup a workspace in VS Code
• access the important commands to create your integration
• create your first Camel Route
• run your Camel Route locally
• get access to the source code of the Camel Route

Preparing the Workspace

Visual Studio Code requires you to create a workspace for your project to access the full functionality of the environment. If you haven’t done so yet, please open your Visual Studio Code instance. You can do that by finding the right launcher on your computer or by opening a command shell and executing code. This should leave you with a window like the one below.

Next we need to select our workspace folder which will store our project files. Go to the File menu and select the entry Open Folder. In the following screen browse to the folder you would like to use and select it.

VS Code Commands

To access the VS Code command palette you have to press either F1 or CTRL+SHIFT+P. This will open up an entry field which you can use to filter for the commands you are interested in.

In our case we are interested in the Camel related commands, so lets type Camel into the field and check the filtered results.

Create your first Camel Route

If you followed the steps from the section you should still see the filtered Camel commands. Please select now the command called Camel: Create a Camel Route using YAML DSL and hit Enter. Next you are asked to provide a name for the file to be created. Feel free to pick a name without stating a file extension (example: simpleTest) and hit Enter again.

If all worked correctly you should now see your new file with the extension .camel.yaml and the Kaoto Visual Designer should open up.

You should now see a similar screen like the one below.

Launch your Camel Route

The Camel Route we created in the previous chapter can already be launched. Let’s try to start the Route by clicking the Run Camel Application with JBang button in the top right of the Kaoto Visual Editor.

A terminal should open up and it will show you the output of your launched Camel Route.

You can terminate the execution of your Camel Route at any time by selecting the terminal window and pressing CTRL+C.

Accessing the Source Code

You might wonder how the source of your new Camel Route looks like. While Kaoto tries relief users from the burden of working with the source code, we still allow access to it via the default Visual Studio Code Text Editor.

To access your source code you can either right click the tab labeled with the filename and then select Reopen Editor with and then choosing Text Editor.

Another way of doing that is to right-click the file in the Explorer view on the left side of the window and then similarly selecting the menu item Open With and then choosing Text Editor.

If you want to revert back to the Kaoto Editor you can follow the same steps as above but instead of Text Editor you should then select Kaoto Editor.

The Visual Designer

Overview

The following picture shows the different parts of the Kaoto Visual Editor.

1. The Explorer View with the opened file selected
2. The currently displayed Integration
3. The configuration panel where you can adjust and customize settings for the selected step
4. Drop down showing the currently selected integration type, here Camel Route
5. Drop down showing the currently selected Camel Route. This is handy if you have more than one Camel Route defined in your file. You can rename, delete, select and switch the visibility for each Camel Route here
6. Drop down enabling you to add more Routes or other global elements to your integration. Only visible for Camel Routes!
7. Copies the full source code of your integration to the Clipboard
8. Exports the currently visible Integration as a PNG image
9. Drop down showing the available Camel versions. Different runtimes are available, like Camel Main, Springboot and Quarkus.
10. This button bar provides you with functionalities like Zoom In / Out, Reset the View, Switching the layout direction between horizontal and vertical and grants you access to the comprehensive Camel Catalog, containing all the available Components/Connectors, Enterprise Integration Patterns and Kamelets
11. A step in your Integration with an Error-Marker to indicate a problem with the configuration of the step.
12. The toolbar of the selected step. It provides available actions for the current selection.

Working with Camel Routes

In Apache Camel, a route is a set of processing steps that are applied to a message as it travels from a source to a destination. A route typically consists of a series of processing steps that are connected in a linear sequence.

A Camel Route is where the integration flow is defined. For example, you can write a Camel Route to specify how two systems can be integrated. You can also specify how the data can be manipulated, routed, or mediated between the systems.

Creating a new Camel Route

We already covered how to create a new Camel Route YAML file in the chapter Create your first Camel Route.

Let’s use another way of creating a new Camel Route. If you have your route from the other chapter still open, click on the Route selection drop down and then delete all the routes using the trashbin icon.

Once you confirmed the deletion of all your routes you should see a blank screen like below.

You can now create a new Camel Route by either clicking the + New button in the center of the canvas or by using the same button in the upper menu bar of the Canvas, next to the Route selection drop down, which will both put a template route in place which uses a Timer component to send every second a message to the Log component.

Adding a step

Now lets add a new step between the Timer and the Log component to modify the message body. There are two ways of adding a step to the route. You can either Right-Click on the step you want to insert before or after. This will bring up a context menu with the available actions to choose from. An easier alternative would be to hover over the connection between the two steps you want to insert between and then click on the + button that appears.

Hover over the connection between the Timer and the Log steps now and click the + button to execute the Add step action.

This will open up the Camel Catalog where you can search the step you want to add.

As already mentioned we would like to modify the message body before sending it along to the Log component. To achieve that we need to add a Processor called setBody. Let’s enter this name into the filter text field on top of the Catalog.

You can now select the setBody tile to add it to your route. Select the new added step now on the canvas to open the configuration form to the right.

Let’s change the Expression text field to Hello from Kaoto!.

Now the Log component will receive a Hello from Kaoto! message every second and logs it to the console.

Replacing a step

You can replace any step on the canvas by hovering over or by selecting the step. This will spawn a toolbar which contains a button for the Replace action.

Alternatively you can do that also by invoking the context menu on a step and selecting the item Replace. Both ways it will open up the Camel Catalog and you can choose the replacement from there.

Deleting a step

You can delete any step on the canvas by hovering over or by selecting the step. This will spawn a toolbar which contains a button for the Delete action.

Alternatively you can do that also by invoking the context menu on a step and selecting the item Delete. This will remove the step from your integration.

Enable / Disable a step

You can enable or disable any step on the canvas by hovering over or by selecting the step. This will spawn a toolbar which contains a button for the Enable / Disable action.

Alternatively you can enable / disable any step in your route by invoking the context menu on a step and selecting the item Enable / Disable.

In the picture above the Log component has been disabled. The icon is grayed out and there is a marker icon at the top right of the step to indicate it is disabled.