Red Hat Summit이 콘텐츠는 선택한 언어로 제공되지 않습니다.
Chapter 4. Sample applications
4.1. Spring Boot Examples
The Spring Boot examples repository contains a number of examples on how to integrate with Camel for a variety of use cases. They provide best practice advice and describe common patterns that we see in integration and messaging problems.
The examples can be run using Maven. When using the mvn command, Maven will attempt to download the required dependencies from a central repository to your local repository.
4.2. Examples repository
There are 61 examples:
| Example | Category | Description | Deploy with devfile |
|---|---|---|---|
| ActiveMQ (activemq) | Messaging | An example showing how to work with Camel, ActiveMQ openwire and Spring Boot | No |
| Actuator HTTP Metrics (actuator-http-metrics) | Management and Monitoring | Example on how to use Spring Boot’s Actuator endpoints to gather info like mappings or metrics | No |
| Amqp (amqp) | Messaging | An example showing how to work with Camel, ActiveMQ Amqp and Spring Boot | No |
| AMQP Salesforce (amqp-salesforce) | Messaging | AMQP message sending is created as contacts in Salesforce | No |
| ArangoDB (arangodb) | Database | An example showing the Camel ArangoDb component with Spring Boot | No |
| artemis (artemis) | Messaging | An example showing how to work with Camel, ActiveMQ Artemis and Spring Boot | No |
| AWS2 S3 (aws2-s3) | Cloud | An example showing the Camel AWS2 S3 component with Spring Boot | No |
| Azure Event Hubs (azure-eventhubs) | Cloud | An example showing how to work with Camel, Azure Event Hubs and Spring Boot | No |
| Azure Service Bus (azure-servicebus) | Cloud | An example showing how to work with Camel, Azure Service Bus and Spring Boot | No |
| Endpoint DSL (camel-example-endpointdsl) | Beginner | Using type-safe Endpoint DSL | No |
| FHIR (fhir) | Health Care | An example showing how to work with Camel, FHIR and Spring Boot | No |
| Transaction (fhir-auth-tx) | Health Care | An example showing how to work with Camel, FHIR Authorization, FHIR Transaction and Spring Boot | Yes |
| Health Checks (health-checks) | Health Care | An example on how to work with health checks ib a simple Apache Camel application using Spring Boot. | Yes |
| HTTP SSL (http-ssl) | Rest | An example showing the Camel HTTP component with Spring Boot and SSL | No |
| Infinispan (infinispan) | Cloud | An example showing the Camel Infinispan component with Spring Boot | No |
| Jira (jira) | Beginner | An example that uses Jira Camel API | No |
| Jolokia (jolokia) | Management and Monitoring | An example that uses Jolokia to monitor and to manage Camel Routes | No |
| Avro (kafka-avro) | Messaging | An example for Kafka avro | No |
| offsetrepository (kafka-offsetrepository) | Messaging | An example for Kafka offsetrepository | No |
| Kamelet Chuck Norris (kamelet-chucknorris) | Beginner | How easy it is to create your own Kamelets | Yes |
| Custom Type Converter (load-balancer-eip) | Beginner | An example showing Load Balancer EIP with Camel and Spring Boot | Yes |
| Microsoft Exchange Oauth2 Authentication (mail-exchange-oauth2) | | An example showing how to use Camel on Spring Boot to connect with IMAP protocol and access email data for Office 365 users using OAuth2 authentication | No |
| Master (master) | Clustering | An example showing how to work with Camel’s Master component and Spring Boot | No |
| Metrics (metrics) | Management and Monitoring | An example showing how to work with Camel and Spring Boot and report metrics to Graphite | Yes |
| Monitoring (monitoring) | Management and Monitoring | Example on how to use Spring Boot’s Actuator endpoints to gather info like mappings or metrics | No |
| Multiple pooled datasources with two-phase commit (muti-datasources-2pc) | Database | An example showing how to work with Camel and Spring Boot using multiple pooled datasources with two-phase commit | No |
| Observation (observation) | Management and Monitoring | An example showing how to trace incoming and outgoing messages from Camel with Micrometer Observation | No |
| OpenAPI Contract First (openapi-contract-first) | Rest | Contract First OpenAPI example | No |
| OpenTelemetry (opentelemetry) | Management and Monitoring | An example showing how to use Camel with OpenTelemetry | No |
| Paho MQTT5 Shared Subscriptions (paho-mqtt5-shared-subscriptions) | Messaging | An example showing how to set up multiple mqtt5 consumers that use shared subscription feature of MQTT5 | Yes |
| REST DSL and Platform HTTP (platform-http) | Rest | An example showing Camel REST DSL with platform HTTP | No |
| POJO Routing (pojo) | Beginner | An example showing how to work with Camel POJO routing with Spring Boot | Yes |
| Quartz (quartz) | Beginner | An example showing how to work with Camel Quartz and Camel Log with Spring Boot | Yes |
| RabbitMQ (rabbitmq) | Messaging | An example showing how to work with Camel and RabbitMQ | No |
| Reactive Streams (reactive-streams) | Reactive | An example that shows how Camel can exchange data using reactive streams with Spring Boot reactor | Yes |
| Resilience4j (resilience4j) | EIP | An example showing how to use Resilience4j EIP as circuit breaker in Camel routes | No |
| REST using CXF and OpenTelemetry (rest-cxf-opentelemetry) | CXF | An example showing Camel REST using CXF and OpenTelemetry with Spring Boot | No |
| REST DSL and OpenApi (rest-openapi) | Rest | An example showing Camel REST DSL and OpenApi with Spring Boot | Yes |
| OpenApi Simple (rest-openapi-simple) | Beginner | This example shows how to call a Rest service defined using OpenApi specification | No |
| REST DSL and OpenApi (rest-openapi-springdoc) | Rest | An example showing Camel REST DSL and OpenApi with a Springdoc UI in a Spring Boot application | Yes |
| REST DSL and Spring Security (rest-spring-security) | Rest | An example showing Camel REST DSL secured with Spring Security and JWT token in a Spring Boot application | Yes |
| Route Reload (route-reload) | Beginner | Live reload of routes if file is updated and saved | Yes |
| Routes Configuration (routes-configuration) | Beginner | Example with global routes configuration for error handling | No |
| Route Template (routetemplate) | Beginner | How to use route templates (parameterized routes) | Yes |
| XML (routetemplate-xml) | Beginner | How to use route templates (parameterized routes) in XML | No |
| Saga (saga) | EIP | This example shows how to work with a simple Apache Camel application using Spring Boot and Narayana LRA Coordinator to manage distributed actions implementing SAGA pattern | No |
| ServiceCall (servicecall) | Cloud | An example showing how to work with Camel ServiceCall EIP and Spring Boot | No |
| SOAP CXF (soap-cxf) | CXF | An example showing the Camel SOAP CXF | No |
| Camel Splitter EIP (splitter-eip) | Beginner | An example showing Splitter EIP with Camel and Spring Boot | Yes |
| Spring Boot (camel-example-spring-boot) | Beginner | An example showing how to work with Camel and Spring Boot | No |
| JTA (spring-boot-jta-jpa-autoconfigure) | Advanced | An example showing JTA with Spring Boot Autoconfiguration | No |
| JTA (spring-boot-jta-jpa-xml) | Advanced | An example showing JTA with Spring Boot using Spring XML configuration | No |
| Spring JDBC (spring-jdbc) | Beginner | Camel transacted routes integrating local Spring Transaction | No |
| Strimzi (strimzi) | Messaging | Camel example which a route is defined in XML for Strimzi integration on Openshift/Kubernetes | No |
| Supervising Route Controller (supervising-route-controller) | Management and Monitoring | An example showing how to work with Camel’s Supervising Route Controller and Spring Boot | Yes |
| Tomcat JDBC (camel-example-spring-boot) | Beginner | An example showing how to deploy a Camel Spring Boot application in Tomcat using its JDBC Data Source | No |
| Custom Type Converter (type-converter) | Beginner | An example showing how to create custom type converter with Camel and Spring Boot | Yes |
| Validator (validator) | Input/Output Type Contract | An example showing how to work with declarative validation and Spring Boot | Yes |
| Webhook (webhook) | Advanced | Example on how to use the Camel Webhook component | No |
| Widget Gadget (widget-gadget) | Messaging | The widget and gadget example from EIP book, running on Spring Boot | No |
| XML (xml) | Beginner | An example showing how to work with Camel routes in XML files and Spring Boot | Yes |
| XML Import (xml-import) | Beginner | An example showing how to work with Spring XML files imported with embedded CamelContext | Yes |
4.3. Running Examples
You should always use the latest release for the examples.
To run the examples:
Check out the tag for the latest release (currently camel-spring-boot-examples-4.10.3-branch):
$ git checkout tags/camel-spring-boot-examples-4.10.3-branchInstall the root pom:
$ mvn install- Check the README for the example you want to run for additional steps.
4.4. Deploying examples
You can deploy examples in OpenShift or dev-sandbox using devfiles. For more information about deploying the Camel Spring Boot applications on OpenShift Container Platform, see Apache Camel on OCP Best practices.
Only some of the examples can be deployed with devfile. See the column "Deploy with devfile" in the examples table.
Prerequisites
-
If you haven’t already, install
odo(We recommend version 2.x)
Procedure
Log in to your openshift or dev-sandbox and create a new project. Here $EXAMPLE is the name of the example you want to deploy:
$ oc new-project csbex-$EXAMPLECreate an odo component using the devfile.yaml
$ odo create csb-ubi8 --app $EXAMPLETo set the specific example you want to deploy as an env variable (SUB_FOLDER):
$ odo config set --env SUB_FOLDER=$EXAMPLEThen push it to openshift cluster:
$ odo pushBefore you deploy an example, delete the
.ododirectory in your repository.This removes components related to any previous example.
If you have an internal repository, set the
MAVEN_MIRROR_URLenvironment with your maven repo before pushing:$ odo config set --env MAVEN_MIRROR_URL=https://my-maven-mirror/
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}