Elsa 3.7.1 - Release Notes
Compare: 3.7.0...origin/patch/3.7.1
Highlights
- Hosting management - stable application instance names: Clustered hosts can now configure a stable, unique application instance name through
ApplicationInstanceOptions.InstanceNameorApplicationInstanceOptions.InstanceNameEnvironmentVariable. This lets Azure Service Bus-backed change-token subscriptions and queues be reused across restarts instead of accumulating orphaned entities until the topic subscription limit is reached. (#7742) - Azure Service Bus entity-name safety: Long but otherwise valid configured instance names are shortened deterministically so Kubernetes pod names and similar deployment-provided identifiers remain stable while staying within the Azure Service Bus subscription-name limit. (c7a97c6412)
Upgrade notes
- No breaking changes are expected. Deployments using Azure Service Bus for clustering/change-token transport should configure a stable per-instance name for each concurrently running host. For Kubernetes, set
ApplicationInstanceOptions.InstanceNameEnvironmentVariableto an environment variable that contains a stable pod identifier such asHOSTNAMEfor StatefulSets or a Downward API-projected pod name for Deployments. - If no stable instance name is configured, Elsa preserves the previous random-name behavior and logs a warning when an explicitly configured environment variable is missing or empty.
Fixes
- Azure Service Bus startup reliability: Adds stable application instance-name configuration to prevent restart-driven creation of new per-instance Azure Service Bus change-token entities, addressing crash-loop/startup failures caused by exhausted subscription capacity. (#7732, #7736, #7742)
- Configured instance-name validation: Rejects invalid configured instance names up front and trims explicit/environment-provided names before use. (1aef083815)
- Long configured instance names: Shortens valid over-length names by preserving a prefix and appending a deterministic SHA-256 hash segment, keeping the resolved name stable across restarts. (c7a97c6412)
Tests
- Added
Elsa.Hosting.Management.UnitTestscoverage for explicit instance names, environment-variable resolution, fallback random names, invalid values, deterministic shortening, and shell/module feature registration. (#7742, c7a97c6412)
Full changelog
fc48af062c- fix: add stable application instance name option1aef083815- fix: address greptile stable instance feedback0028604caf- Merge pull request #7742 from elsa-workflows/sfmskywalker-port-asb-stable-instance-371c7a97c6412- Shorten configured application instance names