search

rabbitmq / rabbitmq-website

RabbitMQ website
https://www.rabbitmq.com
Apache License 2.0
819 stars 723 forks source link

Add documentation about Khepri #2058

Closed dumbbell closed 1 month ago

dumbbell commented 1 month ago

Why

Khepri is a large addition of RabbitMQ 4.0.0. It is invisible from outside but greatly affects the behavior of RabbitMQ once enabled.

Furthermore, it is important to explain what should users expect, to let them make an informed decision about if/when Khepri should be enabled.

How

The patch adds a new "Metadata store" section under "How to manage RabbitMQ". It uses the word metadata store because it explains the role of that subsystem of RabbitMQ as well as the difference between Mnesia and Khepri.

It also adds pages specific to Khepri:

cloudflare-workers-and-pages[bot] commented 1 month ago

Deploying rabbitmq-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 8ff4f10
Status: ✅  Deploy successful!
Preview URL: https://318eacbc.rabbitmq-website.pages.dev
Branch Preview URL: https://add-first-khepri-docs.rabbitmq-website.pages.dev

View logs

michaelklishin commented 1 month ago

One thing we should document from the start, even if briefly, is the recovery characteristics of Khepri and how they are different from Mnesia. I'd be happy to add such a section.

dumbbell commented 1 month ago

One thing we should document from the start, even if briefly, is the recovery characteristics of Khepri and how they are different from Mnesia. I'd be happy to add such a section.

I added a new section in the last commit. Thanks for the suggestion!