Skip to content

Upgrading Camunda 8.7.x Job Worker from Spring Boot 4.0.x to 4.1.0

This document is an upgrade guide for consumers who already have a Camunda 8.7.x Job Worker application running with Spring Boot 4.0.x. It covers only the changes required to upgrade the application to Spring Boot 4.1.0.

If you are upgrading the application from Camunda 8.6.x, apply the changes from the Camunda 8.7.x upgrade guide before following this guide.

Step 1: Update the Spring Boot Version

In your pom.xml, update the Spring Boot parent version from 4.0.x to 4.1.0:

Before

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.0.7</version>
    <relativePath/>
</parent>

After

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.1.0</version>
    <relativePath/>
</parent>

Step 2: Update the Camunda Starter Version

Spring Boot 4.1.x compatibility for Camunda 8.7.x is verified starting with Camunda SDK version 8.7.38.

Keep the Spring Boot 4 Camunda starter and update its version:

Before

<dependency>
    <groupId>io.camunda</groupId>
    <artifactId>camunda-spring-boot-4-starter</artifactId>
    <version>8.7.27</version>
</dependency>

After

<dependency>
    <groupId>io.camunda</groupId>
    <artifactId>camunda-spring-boot-4-starter</artifactId>
    <version>8.7.38</version>
</dependency>

Use Camunda SDK version 8.7.38 or later for Spring Boot 4.1.x. The dedicated camunda-spring-boot-4-starter remains required; do not replace it with spring-boot-starter-camunda-sdk or camunda-spring-boot-3-starter.

Step 3: Build the Application

Run the Maven build after updating the dependencies:

./mvnw clean test

Resolve any compatibility issues from application-specific dependencies before deploying the application.

No application.yml Changes Required

The existing Camunda 8.7.x configuration remains the same when upgrading from Spring Boot 4.0.x to Spring Boot 4.1.0.

Continue using:

  • camunda.client.zeebe.defaults.tenant-ids
  • camunda.client.auth.token-url
  • The existing Zeebe gRPC or REST connection properties

No Job Worker Code Changes Required

Existing @JobWorker implementations, variable handling, custom headers, and automatic job completion remain compatible.

No changes are required to the Job Worker implementation solely for the Spring Boot 4.1.0 upgrade.