Camunda 8 Gradle Integration

This project demonstrates how to integrate Camunda 8 with a Spring Boot application using Gradle. It covers both SaaS and self-managed deployments, task handling, variables, and connectors.

Table of Contents

• Deployment Options
  • SaaS (Cloud) Deployment
  • Self-Managed Deployment
• Task Types
  • User Task
  • Service Task
• Variables Handling
• Connectors
  • Inbound Connectors
  • Outbound Connectors

Deployment Options

SaaS (Cloud) Deployment

1. Set up Camunda Cloud

   • Go to Camunda Get Started
   • Login at Camunda Cloud Login
   • Create a new cluster and generate API credentials (Client ID and Secret)

2. Create Spring Boot Application

   • Use Spring Initializr
   • Add Camunda dependency:

     implementation 'io.camunda.spring:spring-boot-starter-camunda:8.5.19'

   • Test with: http://localhost:8080/actuator
   • Configure Camunda Module with your cluster credentials

Self-Managed Deployment

1. Install Docker

   • Download from Docker Desktop for Windows (~500MB)
   • Complete the installation process

2. Set up Camunda

   • Choose a version from Camunda Distributions
   • Run:

     docker-compose -f docker-compose-core.yaml up -d

   • Access components with default credentials:
     • Username: demo
     • Password: demo

Task Types

User Task

• Sample BPMN: sample.bpmn
• Deployable via Camunda Modeler or programmatically

Service Task

• Sample BPMN: service-task-session.bpmn
• Requires job type definition
• Implementation: ProductOrder.java
• Automatically executes when task is completed

Variables Handling

• Methods sending data to Camunda must have return types
• Methods reading data should use @Variable annotation
• Example in ProductOrder.java

Connectors

Inbound Connectors (External System → Camunda)

• Webhook Implementation: webhook-inbound-connector.bpmn
• Tested with Postman: Camunda8-Gradle.postman_collection.json

URL Formats:

• SaaS:
  http(s)://<camunda.client.cloud.region>.connectors.camunda.io/<..cloud.cluster-id>/inbound/<bpmn::webhook ID>
• Local:
  http://localhost:8085/inbound/<bpmn::webhook ID>

Outbound Connectors (Camunda → External System)

---

For more information, visit the official Camunda website.