Broadleaf Microservices
  • v1.0.0-latest-prod

Upgrade to 2.1.4

May 12, 2025

A caching issue was identified in the 2.1.4-GA Release Train when using ContentServices. If you are using ContentServices, please see this documentation for remediation, which can include either upgrading your ContentServices version to 2.0.7-GA, or introducing the recommended workaround in lieu of an upgrade.

April 28, 2025

An issue was identified in the 2.1.4-GA Release Train when using Stripe payment gateway module. If you are using the Stripe module, have released a 2.1.4.1-GA Release Train to resolve the issue. More details can be found here:

April 16, 2025

Tip
The 2.x versions are Spring Boot 3 compatible.
Tip
If coming from a version prior to 2.0.0-GA, then see the 2.0.0 upgrade guide.

Requirements

  • Java 17 is required since 2.0.0-GA.

Notable Changes

Feature/Notable Change Impacted Services Links

Support for Flash Sale

CartOperationServices, PricingServices, Import, ScheduledJobServices

Please refer to Flash Sale for more information.

Support to view Scheduled Job Execution Details

ScheduledJobServices, MicroMessagingCommon

Please refer to Scheduled Job Release Notes for 2.1.4-GA for more information.

AssetServices Storage Provider Path Changes

AssetServices

There is an important change made to the storage path new assets will be stored at in AssetServices. Please review the AssetServices 2.0.3 release notes describing the change

Added new Audit Microservice

AuditServices, AuditCommon

Added new Workflow Microservice

WorkflowServices, WorkflowClient

Improved service-to-service calls within a single flex package to skip overhead of external calls.

MicroExtensionCommon

See details and configuration in the Micro Extension Common Release Notes for 2.0.5

Implemented purging of obsolete sandbox data

DataTracking

Added support for receiving updated transaction results through the webhook.

PaymentGatewayCommon, PaymentTransactionServices, Adyen

Remember-Me Login

AuthenticationServices, AuthSDK, AdminWeb, NextJS Starter

Introduced new Product & Category Membership Bulk Operations

CatalogServices, BulkOperationsServices, SandboxServices

Updated discriminated properties to be case insensitive

Across all Microservices that utilize DiscriminatedProperties

See individual release notes for a full list of updated services & classes.

Mitigation of Sandbox NotificationState buildup

SandboxServices

Overriding Manifest Properties via ENV properties

Project Initializer Manifest

Additional documentation has been added regarding our manifest environment setup & the ability to override manifest properties.

Security

To review the security related content, see 2.1.4 notes.

Tip

You will need your login credentials originally provided for accessing the Broadleaf nexus. Security fixes often involve dependency updates to remediate issues being tracked in external OSS components. It is worth considering adopting releases with security fixes (even Broadleaf Severity LOW) to avoid any possibility of transitive exposure in your codebase.

Frontend Compatibility and Release Notes

Microservices release 2.1.4 is congruent with: