Chapter 5. Camel K quick start developer tutorials
Chapter 5. Camel K quick start developer tutorials Red Hat Integration - Camel K provides quick start developer tutorials based on integration use cases available from https://github.com/openshift-integration . This chapter provides details on how to set up and deploy the following tutorials: Section 5.1, "Deploying a basic Camel K Java integration" Section 5.2, "Deploying a Camel K Serverless integration with Knative" Section 5.3, "Deploying a Camel K transformations integration" Section 5.4, "Deploying a Camel K Serverless event streaming integration" Section 5.5, "Deploying a Camel K Serverless API-based integration" Section 5.6, "Deploying a Camel K SaaS integration" Section 5.7, "Deploying a Camel K JDBC integration" Section 5.8, "Deploying a Camel K JMS integration" Section 5.9, "Deploying a Camel K Kafka integration" 5.1. Deploying a basic Camel K Java integration This tutorial demonstrates how to run a simple Java integration in the cloud on OpenShift, apply configuration and routing to an integration, and run an integration as a Kubernetes CronJob. Prerequisites See the tutorial readme in GitHub . You must have installed the Camel K operator and the kamel CLI. See Installing Camel K . Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository. USD git clone git@github.com:openshift-integration/camel-k-example-basic.git In VS Code, select File Open Folder camel-k-example-basic . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions. Alternatively, if you do not have VS Code installed, you can manually enter the commands from deploying basic Camel K Java integration . Additional resources Developing Camel K integrations in Java 5.2. Deploying a Camel K Serverless integration with Knative This tutorial demonstrates how to deploy Camel K integrations with OpenShift Serverless in an event-driven architecture. This tutorial uses a Knative Eventing broker to communicate using an event publish-subscribe pattern in a Bitcoin trading demonstration. This tutorial also shows how to use Camel K integrations to connect to a Knative event mesh with multiple external systems. The Camel K integrations also use Knative Serving to automatically scale up and down to zero as needed. Prerequisites See the tutorial readme in GitHub . You must have cluster administrator access to an OpenShift cluster to install Camel K and OpenShift Serverless: Installing Camel K Installing OpenShift Serverless from the OperatorHub Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository: USD git clone git@github.com:openshift-integration/camel-k-example-knative.git In VS Code, select File Open Folder camel-k-example-knative . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions. If you do not have VS Code installed, you can manually enter the commands from deploying Camel K Knative integration . Additional resources About Knative Eventing About Knative Serving 5.3. Deploying a Camel K transformations integration This tutorial demonstrates how to run a Camel K Java integration on OpenShift that transforms data such as XML to JSON, and stores it in a database such as PostgreSQL. The tutorial example uses a CSV file to query an XML API and uses the data collected to build a valid GeoJSON file, which is stored in a PostgreSQL database. Prerequisites See the tutorial readme in GitHub . You must have cluster administrator access to an OpenShift cluster to install Camel K. See Installing Camel K . You must follow the instructions in the tutorial readme to install Crunchy Postgres for Kubernetes, which is required on your OpenShift cluster. Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository: USD git clone git@github.com:openshift-integration/camel-k-example-transformations.git In VS Code, select File Open Folder camel-k-example-transformations . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions. If you do not have VS Code installed, you can manually enter the commands from deploying Camel K transformations integration . Additional resources https://operatorhub.io/operator/postgresql https://geojson.org/ 5.4. Deploying a Camel K Serverless event streaming integration This tutorial demonstrates using Camel K and OpenShift Serverless with Knative Eventing for an event-driven architecture. The tutorial shows how to install Camel K and Serverless with Knative in an AMQ Streams cluster with an AMQ Broker cluster, and how to deploy an event streaming project to run a global hazard alert demonstration application. Prerequisites See the tutorial readme in GitHub . You must have cluster administrator access to an OpenShift cluster to install Camel K and OpenShift Serverless: Installing Camel K Installing OpenShift Serverless from the OperatorHub You must follow the instructions in the tutorial readme to install the additional required Operators on your OpenShift cluster: AMQ Streams Operator AMQ Broker Operator Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository. USD git clone git@github.com:openshift-integration/camel-k-example-event-streaming.git In VS Code, select File Open Folder camel-k-example-event-streaming . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions. Alternatively, if you do not have VS Code installed, you can manually enter the commands from deploying Camel K event stream integration . Additional resources Red Hat AMQ documentation OpenShift Serverless documentation 5.5. Deploying a Camel K Serverless API-based integration This tutorial demonstrates using Camel K and OpenShift Serverless with Knative Serving for an API-based integration, and managing an API with 3scale API Management on OpenShift. The tutorial shows how to configure Amazon S3-based storage, design an OpenAPI definition, and run an integration that calls the demonstration API endpoints. Prerequisites See the tutorial readme in GitHub . You must have cluster administrator access to an OpenShift cluster to install Camel K and OpenShift Serverless: Installing Camel K Installing OpenShift Serverless from the OperatorHub You can also install the optional Red Hat Integration - 3scale Operator on your OpenShift system to manage the API. See Deploying 3scale using the Operator . Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository. USD git clone git@github.com:openshift-integration/camel-k-example-api.git In VS Code, select File Open Folder camel-k-example-api . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions. Alternatively, if you do not have VS Code installed, you can manually enter the commands from deploying Camel K API integration . Additional resources Red Hat 3scale API Management documentation OpenShift Serverless documentation 5.6. Deploying a Camel K SaaS integration This tutorial demonstrates how to run a Camel K Java integration on OpenShift that connects two widely-used Software as a Service (SaaS) providers. The tutorial example shows how to integrate the Salesforce and ServiceNow SaaS providers using REST-based Camel components. In this simple example, each new Salesforce Case is copied to a corresponding ServiceNow Incident that includes the Salesforce Case Number. Prerequisites See the tutorial readme in GitHub . You must have cluster administrator access to an OpenShift cluster to install Camel K. See Installing Camel K . You must have Salesforce login credentials and ServiceNow login credentials. Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository: USD git clone git@github.com:openshift-integration/camel-k-example-saas.git In VS Code, select File Open Folder camel-k-example-saas . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions . If you do not have VS Code installed, you can manually enter the commands from deploying Camel K SaaS integration . Additional resources https://www.salesforce.com/ https://www.servicenow.com/ 5.7. Deploying a Camel K JDBC integration This tutorial demonstrates how to get started with Camel K and an SQL database via JDBC drivers. This tutorial shows how to set up an integration producing data into a Postgres database (you can use any relational database of your choice) and also how to read data from the same database. Prerequisites See the tutorial readme in GitHub . You must have cluster administrator access to an OpenShift cluster to install Camel K. Installing Camel K You must follow the instructions in the tutorial readme to install Crunchy Postgres for Kubernetes, which is required on your OpenShift cluster. Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository. USD git clone git@github.com:openshift-integration/camel-k-example-jdbc.git In VS Code, select File Open Folder camel-k-example-jdbc . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions. Alternatively, if you do not have VS Code installed, you can manually enter the commands from deploying Camel K JDBC integration . 5.8. Deploying a Camel K JMS integration This tutorial demonstrates how to use JMS to connect to a message broker in order to consume and produce messages. There are two examples: JMS Sink: this tutorial demonstrates how to produce a message to a JMS broker. JMS Source: this tutorial demonstrates how to consume a message from a JMS broker. Prerequisites See the tutorial readme in GitHub . You must have cluster administrator access to an OpenShift cluster to install Camel K. Installing Camel K Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository: USD git clone git@github.com:openshift-integration/camel-k-example-jms.git In VS Code, select File Open Folder camel-k-example-jms . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions. If you do not have VS Code installed, you can manually enter the commands from deploying Camel K JMS integration . Additional resources JMS Sink JMS Source 5.9. Deploying a Camel K Kafka integration This tutorial demonstrates how to use Camel K with Apache Kafka. This tutorial demonstrates how to set up a Kafka Topic via Red Hat OpenShift Streams for Apache Kafka and to use it in conjunction with Camel K. Prerequisites See the tutorial readme in GitHub . You must have cluster administrator access to an OpenShift cluster to install Camel K. Installing Camel K Visual Studio (VS) Code is optional but recommended for the best developer experience. See Setting up your Camel K development environment . Procedure Clone the tutorial Git repository: USD git clone git@github.com:openshift-integration/camel-k-example-kafka.git In VS Code, select File Open Folder camel-k-example-kafka . In the VS Code navigation tree, click the readme.md file. This opens a new tab in VS Code to display the tutorial instructions. Follow the tutorial instructions. If you do not have VS Code installed, you can manually enter the commands from deploying Camel K Kafka integration .
git clone git@github.com:openshift-integration/camel-k-example-basic.git git clone git@github.com:openshift-integration/camel-k-example-knative.git git clone git@github.com:openshift-integration/camel-k-example-transformations.git git clone git@github.com:openshift-integration/camel-k-example-event-streaming.git git clone git@github.com:openshift-integration/camel-k-example-api.git git clone git@github.com:openshift-integration/camel-k-example-saas.git git clone git@github.com:openshift-integration/camel-k-example-jdbc.git git clone git@github.com:openshift-integration/camel-k-example-jms.git git clone git@github.com:openshift-integration/camel-k-example-kafka.git