services: Update rabbitmq service

Update RabbitMQ default configuration to use localhost interface by
default and avoid listening on public interfaces.

Change the default configuration file to set inter-node communication
listener to localhost network interface (see also
https://www.rabbitmq.com/docs/networking#distribution). This requires
setting RabbitMQ node name to `rabbit@localhost`, so introduce
`node-name` RabbitMQ configuration field with such default value.

Path to the RabbitMQ environment configuration file was hardcoded.
Remove the hardcoding and allow to create such file with env-config-file
RabbitMQ configuration field.

Add new RabbitMQ service tests to check RabbitMQ broker startup and
status after the service is started.

* gnu/services/high-availability.scm (<rabbitmq-configuration>)
  [<node-name>, <env-config-file>]: New fields.
  (rabbitmq-shepherd-service): Use them.
  (%default-rabbitmq-config-file): Update.
* gnu/tests/high-availability.scm (run-rabbitmq-test): Add new tests.
* doc/gnu.texi (High Availability Services): Document new fields and
  provide information about local interfaces.

Merges: guix/guix!9360
Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>

1 files changed, 21 insertions, 9 deletions

diff --git a/doc/guix.texi b/doc/guix.texi
index c349ffc6d33..7f587d73a9a 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -143,7 +143,7 @@ Copyright @copyright{} 2025 Zacchaeus@*
 Copyright @copyright{} 2025, 2026 Sergio Pastor Pérez@*
 Copyright @copyright{} 2024 Evgeny Pisemsky@*
 Copyright @copyright{} 2025 jgart@*
-Copyright @copyright{} 2025 Artur Wroblewski@*
+Copyright @copyright{} 2025-2026 Artur Wroblewski@*
 Copyright @copyright{} 2025 Edouard Klein@*
 Copyright @copyright{} 2025 Rodion Goritskov@*
 Copyright @copyright{} 2025 dan@*
@@ -37654,24 +37654,24 @@ A simple example configuration is given below.
 @lisp
 (service rabbitmq-service-type
          (rabbitmq-configuration
-           (rabbitmq-configuration
-             (plugins '("rabbitmq_stream"
-                        "rabbitmq_management"
-                        "rabbitmq_prometheus")))))
+           (plugins '("rabbitmq_stream"
+                      "rabbitmq_management"
+                      "rabbitmq_prometheus"))))
 @end lisp
-@end defvar
 
 At startup, RabbitMQ broker logs its initialization messages into
 @file{/var/log/messages} file.  Once running, the logging messages can be
 found in a logging file of a RabbitMQ node in @file{/var/log/rabbitmq}
 directory.
 
-@quotation Note
+@quotation Warning
 The default configuration of the RabbitMQ service enables the RabbitMQ
 broker to accept connections only on loopback interfaces.  However,
 enabling certain plugins may open ports on all network interfaces.  See
-also @url{https://www.rabbitmq.com/docs/networking#ports, RabbitMQ Port Access}.
+also @url{https://www.rabbitmq.com/docs/networking#ports, RabbitMQ Port
+Access}.
 @end quotation
+@end defvar
 
 @deftp {Data Type} rabbitmq-configuration
 This data type represents the configuration for RabbitMQ.
@@ -37680,10 +37680,23 @@ This data type represents the configuration for RabbitMQ.
 @item @code{rabbitmq} (default: @code{rabbitmq})
 The RabbitMQ package to use.
 
+@item @code{node-name} (default: @code{"rabbit@@localhost"})
+Node name of a RabbitMQ broker instance. See also
+@url{https://www.rabbitmq.com/docs/clustering#node-names, RabbitMQ Node
+Names}.
+
 @item @code{config-file} (default: @code{%default-rabbitmq-config-file})
 Configuration file for the RabbitMQ broker. See also
 @url{https://www.rabbitmq.com/docs/configure, RabbitMQ Configuration}.
 
+@item @code{env-config-file} (default: @code{#f})
+Environment configuration file for the RabbitMQ broker.
+
+Set RabbitMQ environment variables, for example Erlang parameters, node
+name, or configuration file location, using @code{variable=value} format.
+Each variable name without @code{RABBITMQ_} prefix. See also
+@url{https://www.rabbitmq.com/docs/configure, RabbitMQ Configuration}.
+
 @item @code{data-directory} (default: @code{"/var/lib/rabbitmq/data"})
 Directory with RabbitMQ broker data - a schema database, message stores,
 cluster member information, and other persistent node state.
@@ -37691,7 +37704,6 @@ cluster member information, and other persistent node state.
 @item @code{plugins} (default: @code{'()})
 A list of RabbitMQ plugins to enable.  View all available plugins using
 the @command{rabbitmq-plugins list} command.
-
 @end table
 @end deftp