Skip to main content
Version: 8.7 (unreleased)

Update 8.6 to 8.7

The following sections explain which adjustments must be made to migrate from Camunda 8.6.x to 8.7.x for each component.

Backup

Google Cloud Storage

Configuring a non-existing bucket for backups will not prevent Zeebe to start up anymore and will only result in logs (at WARN) in the startup phase.

REST API key attributes change to string

With 8.7, the default REST API key attribute type changes from integer (int64) to string.

Key properties have a key suffix, and they serve as the technical unique identifier for entities, such as processDefinitionKey and tenantKey, with correlationKey being the only exception. Their type now defaults to string for the default application/json content type.

Our API can still work with key attributes as numbers using different content type headers.
See the overview about API Key Attributes for more details.

Still using number keys?

If you still wish to use keys as integer (int64) types, you have to include the application/vnd.camunda.api.keys.number+json header in your client requests.

If you are using an 8.6 or 8.5 Java Client, the C8 API will recognize this and automatically return key attributes as integer (int64). You don't need to add the extra content-type header to your client requests.

Identity

Keycloak now requires v25 or v26

Identity 8.7 now requires Keycloak v25 or v26, and Keycloak versions must be updated to match. The following changes to the Helm chart have been made to support this upgrade.

Increase container resources

Keycloak containers require an increase in resources from the default. To set this increase, configure the following in the Camunda Helm chart:

resources:
requests:
cpu: 1000m
memory: 1Gi
limits:
cpu: 2000m
memory: 2Gi

Allow insecure images

As we repackage the Bitnami distribution with our Identity login page, allowInsecureImages must be set to true. This can be configured in the Camunda helm chart via the following:

identityKeycloak:
global:
security:
allowInsecureImages: true