Skip to content

Commit b341a39

Browse files
Update 4.1.0 release notes
1 parent f920baf commit b341a39

File tree

1 file changed

+146
-5
lines changed

1 file changed

+146
-5
lines changed

release-notes/4.1.0.md

Lines changed: 146 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,11 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
131131

132132
GitHub issue: [#10519](https://github.com/rabbitmq/rabbitmq-server/issues/10519), [#12564](https://github.com/rabbitmq/rabbitmq-server/pull/12564)
133133

134+
* AMQP 1.0 filters now have capped complexity: filtering on more than 16 properties
135+
won't be possible. This is a protection mechanism recommended in the AMQP 1.0 spec.
136+
137+
GitHub issue: [#13196](https://github.com/rabbitmq/rabbitmq-server/pull/13196)
138+
134139
* Support for Multiple Routing Keys in AMQP 1.0 via `x-cc` Message Annotation.
135140

136141
AMQP 1.0 publishers now can set multiple routing keys by using the `x-cc` message annotation.
@@ -183,11 +188,31 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
183188

184189
GitHub issue: [#12837](https://github.com/rabbitmq/rabbitmq-server/pull/12837)
185190

191+
* In a mixed version 4.0/3.13 cluster, dead lettering a message could fail.
192+
193+
GitHub issue: [#12933](https://github.com/rabbitmq/rabbitmq-server/issues/12933)
194+
186195
* In very rare cases, RabbitMQ could fail to notify stream consumers connected to follower replicas
187196
about newly committed offsets as quickly as it usually happens for consumers connected to the stream leader.
188197

189198
GitHub issue: [#12785](https://github.com/rabbitmq/rabbitmq-server/pull/12785)
190199

200+
### Bug Fixes
201+
202+
* Default cluster formation timeout with [Khepri](https://www.rabbitmq.com/docs/metadata-store) now matches that of Mnesia (5 minutes by default).
203+
204+
Discovered and reported by @evolvedlight.
205+
206+
GitHub issue: [#13195](https://github.com/rabbitmq/rabbitmq-server/pull/13195)
207+
208+
* Quorum queues could return a list of members (replicas) with duplicates in some cases.
209+
210+
GitHub issue: [#13168](https://github.com/rabbitmq/rabbitmq-server/pull/13168)
211+
212+
* Classic queues with priorities could run into an exception.
213+
214+
GitHub issue: [#13088](https://github.com/rabbitmq/rabbitmq-server/pull/13088)
215+
191216

192217
### MQTT Plugin
193218

@@ -201,20 +226,29 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
201226

202227
### CLI Tools
203228

229+
#### Breaking Changes and Deprecations
230+
231+
* `rabbitmqctl force_reset` is **deprecated** as it is incompatible with Khepri,
232+
which will become the default metadata store in RabbitMQ by 4.2.0.
233+
234+
GitHub issue: [#13217](https://github.com/rabbitmq/rabbitmq-server/pull/13217)
235+
204236
#### Enhancements
205237

206-
* New major version of `rabbitmqadmin`, a CLI tool that targets RabbitMQ's HTTP API, is maturing.
238+
* New major version of `rabbitmqadmin`, a CLI tool that targets RabbitMQ's HTTP API, has matured.
207239
Unlike its predecessor, the tool is distirbuted via GitHub as as a standalone native binary.
208240

209241
There are minor command line interface changes and a slightly different configuration file
210-
format ([TOML](https://toml.io/en/) instead of `ini`)
242+
format ([TOML](https://toml.io/en/) instead of `ini`).
243+
244+
Documentation guide: []().
211245

212246
GitHub repository: [`rabbitmq/rabbitmqadmin-ng`](https://github.com/rabbitmq/rabbitmqadmin-ng)
213247

214248
* `rabbitmq-diagnostics check_if_any_deprecated_features_are_used` implementation is now more complete
215249
(checks for a more deprecated features).
216250

217-
GitHub issue: [#12675](https://github.com/rabbitmq/rabbitmq-server/pull/12675)
251+
GitHub issues: [#12619](https://github.com/rabbitmq/rabbitmq-server/issues/12619), [#12675](https://github.com/rabbitmq/rabbitmq-server/pull/12675)
218252

219253
#### Bug Fixes
220254

@@ -256,6 +290,17 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
256290

257291
### Management UI
258292

293+
#### Breaking Changes and Deprecations
294+
295+
* The original HTTP API One True Health Check™ is now a no-op. A comparable "mega health check"
296+
has long been deprecated in CLI tools and was made a no-op in `4.0.0`.
297+
298+
This endpoint was using a [deprecated feature](https://www.rabbitmq.com/docs/deprecated-features): a classic non-exclusive transient (non-durable) queue.
299+
300+
See [Health Checks](https://www.rabbitmq.com/docs/monitoring#health-checks) for modern focused alternatives.
301+
302+
GitHub issue: [#13047](https://github.com/rabbitmq/rabbitmq-server/issues/13047)
303+
259304
#### Enhancements
260305

261306
* Static assets served by the management UI now have a `control-cache` header set
@@ -272,8 +317,9 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
272317
3. Link flow control state
273318
4. Session flow control state
274319
5. Number of unconfirmed and unacknowledged messages
320+
6. Busy incoming links are now highlighted
275321

276-
GitHub issue: [#12670](https://github.com/rabbitmq/rabbitmq-server/pull/12670)
322+
GitHub issues: [#12670](https://github.com/rabbitmq/rabbitmq-server/pull/12670), [#13093](https://github.com/rabbitmq/rabbitmq-server/pull/13093)
277323

278324
* The management UI now shows if a feature flag has a migration function (in other words, it may take time to be enabled),
279325
if it is experimental and whether it is supported or not. To enable an experimental feature flag,
@@ -294,11 +340,68 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
294340

295341
GitHub issue: [#12840](https://github.com/rabbitmq/rabbitmq-server/pull/12840)
296342

343+
* Nodes will fail to boot if `rabbit.credit_flow_default_credit` (an `advanced.config`-only, rarely used setting)
344+
is set to an incompatible pair of values.
345+
346+
Contributed by @JimmyWang6.
347+
348+
GitHub issue: [#13046](https://github.com/rabbitmq/rabbitmq-server/pull/13046)
349+
297350
* When a logged in user's JWT token was refreshed, the user identity displayed in the UI was changed.
298351

299352
GitHub issue: [#12818](https://github.com/rabbitmq/rabbitmq-server/pull/12818)
300353

301354

355+
### OAuth 2 AuthN and AuthZ Plugin
356+
357+
#### Breaking Changes and Deprecations
358+
359+
* The OAuth 2 plugin now requires several values to be explicitly configured by the user
360+
and will not provide any defaults.
361+
362+
The affected identity providers are Azure Entra (né Azure AD) and auth0.
363+
364+
GitHub issue: [#12235](https://github.com/rabbitmq/rabbitmq-server/issues/12235)
365+
366+
### Enhancements
367+
368+
* Scope aliases now can be configured in `rabbitmq.conf`.
369+
370+
```ini
371+
auth_oauth2.scope_aliases.admin = tag:administrator configure:*/*
372+
auth_oauth2.scope_aliases.developer = tag:management configure:*/* read:*/* write:*/*
373+
```
374+
375+
```ini
376+
auth_oauth2.scope_aliases.1.alias = api://administrator
377+
auth_oauth2.scope_aliases.1.scope = tag:administrator configure:*/*
378+
auth_oauth2.scope_aliases.2.alias = api://developer
379+
auth_oauth2.scope_aliases.2.scope = tag:management configure:*/* read:*/* write:*/*
380+
```
381+
382+
GitHub issue: [#12210](https://github.com/rabbitmq/rabbitmq-server/issues/12210)
383+
384+
* [OpenID Discovery Endpoint](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationRequest) now can be configured. This is particularly relevant for
385+
Azure Entra (né Azure AD) users.
386+
387+
GitHub issue: [#12211](https://github.com/rabbitmq/rabbitmq-server/issues/12211)
388+
389+
### Bug Fixes
390+
391+
* JWT token refreshes will no longer affect the identity shown in the management UI.
392+
393+
GitHub issue: [#12598](https://github.com/rabbitmq/rabbitmq-server/issues/12598)
394+
395+
396+
### Federation Plugin
397+
398+
#### Enhancements
399+
400+
* Exchange federation now can be used with MQTTv5 consumers.
401+
402+
GitHub issue: [#13115](https://github.com/rabbitmq/rabbitmq-server/pull/13115)
403+
404+
302405
### Shovel Plugin
303406

304407
#### Bug Fixes
@@ -338,6 +441,20 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
338441

339442
### Kubernetes Peer Discovery Plugin
340443

444+
#### Enhancements
445+
446+
* This plugin was significantly reworked to further reduce the probability of
447+
two (or more) clusters being formed in a small percentage of cases when
448+
the entire cluster was started for the first time.
449+
450+
The plugin no longer relies on the Kubernetes API and instead will try to join
451+
the first (indexed at `0`) node as the seed node.
452+
453+
This change is backwards compatible.
454+
455+
GitHub issue: [#13050](https://github.com/rabbitmq/rabbitmq-server/pull/13050)
456+
457+
341458
#### Bug Fixes
342459

343460
* Avoids an exception during automatic removal of cluster members that are
@@ -348,6 +465,17 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
348465

349466
### Consul Peer Discovery Plugin
350467

468+
#### Enhancements
469+
470+
* `` is a new configuration setting that allows the backend to skip registration.
471+
472+
This is useful when Consul is used for peer discovery but a different tool such as Nomad
473+
is used to keep track of the services and their registration, unregistration.
474+
475+
Contributed by @frederikbosch.
476+
477+
GitHub issue: [#13201](https://github.com/rabbitmq/rabbitmq-server/pull/13201)
478+
351479
#### Bug Fixes
352480

353481
* Avoids an exception during automatic removal of cluster members that are
@@ -366,10 +494,23 @@ This section can be incomplete and will be expanded as 4.1 approaches its releas
366494
GitHub issue: [#12809](https://github.com/rabbitmq/rabbitmq-server/pull/12809)
367495

368496

497+
### Erlang AMQP 1.0 Client
498+
499+
#### Breaking Changes and Deprecations
500+
501+
* The client now only can declare durable entities in preparation for a Khepri-only
502+
future version of RabbitMQ.
503+
504+
GitHub issue: [#12947](https://github.com/rabbitmq/rabbitmq-server/pull/12947)
505+
506+
369507
### Dependency Changes
370508

509+
* `ra` was upgraded to [`2.16.1`](https://github.com/rabbitmq/ra/releases)
371510
* `osiris` was upgraded to [`1.8.5`](https://github.com/rabbitmq/osiris/releases)
372-
511+
* `observer_cli` was upgraded to [`1.8.2`](https://github.com/zhongwencool/observer_cli/releases)
512+
* `eetcd` was upgraded to [`0.5.0`](https://github.com/zhongwencool/eetcd/releases)
513+
* `gun` was upgraded to [`2.1.0`](https://github.com/ninenines/gun/releases)
373514

374515
## Source Code Archives
375516

0 commit comments

Comments
 (0)