amaharaneko/guix-mirrors
1
1
Fork 0
mirror of https://codeberg.org/guix/guix.git synced 2025-10-02 02:15:12 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

services: Add rabbitmq service.

Browse source 
* gnu/services/high-availability.scm (<rabbitmq-configuration>): New record.
  (rabbitmq-shepherd-service): New procedure.
  (rabbitmq-service-type): New variable.
* gnu/tests/high-availability.scm (run-rabbitmq-test): New procedure.
  (%rabbitmq-os, %tests-rabbitmq): New variables.
* doc/gnu.texi (High Availability Services): Document it.

Change-Id: I53e9f2881b6340e1ed314785e4c5529b81381a3b
Co-authored-by: Christopher Baines <mail@cbaines.net>
Reviewed-by: Ludovic Courtès <ludo@gnu.org>
Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
This commit is contained in:
wrobell 2025-06-18 21:41:36 +01:00 • committed by Sharlatan Hellseher
parent 27c3c7c4ed
commit c65da197cf
No known key found for this signature in database
GPG key ID: 76D727BFF62CD2B5
4 changed files with 317 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

64
doc/guix.texi
View file

@ -141,6 +141,7 @@ Copyright @copyright{} 2025 Zacchaeus@*
Copyright @copyright{} 2025 Sergio Pastor Pérez@*
Copyright @copyright{} 2024 Evgeny Pisemsky@*
Copyright @copyright{} 2025 jgart@*
Copyright @copyright{} 2025 Artur Wroblewski@*
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
@ -420,6 +421,7 @@ Services
* Kerberos Services:: Kerberos services.
* LDAP Services:: LDAP services.
* Web Services:: Web servers.
* High Availability Services:: High availability services.
* Certificate Services:: TLS certificates via Let's Encrypt.
* DNS Services:: DNS daemons.
* VNC Services:: VNC daemons.
@ -19508,6 +19510,7 @@ declaration.
* Kerberos Services:: Kerberos services.
* LDAP Services:: LDAP services.
* Web Services:: Web servers.
* High Availability Services:: High availability services.
* Certificate Services:: TLS certificates via Let's Encrypt.
* DNS Services:: DNS daemons.
* VNC Services:: VNC daemons.
@ -35664,6 +35667,67 @@ The file which should store the logging output of Agate.
@end table
@end deftp
@node High Availability Services
@subsection High Availability Services
@cindex Message broker
@cindex Message streaming
The @code{(gnu services high-availability)} module provides RabbitMQ
message broker service.
@anchor{RabbitMQ}
@subsubheading RabbitMQ
@defvar rabbitmq-service-type
Service type for the @uref{https://www.rabbitmq.com/,RabbitMQ} web server.
The value for this service type is a @code{<rabbitmq-configuration>} record.
A simple example configuration is given below.
@lisp
(service rabbitmq-service-type
(rabbitmq-configuration
(rabbitmq-configuration
(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
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}.
@end quotation
@deftp {Data Type} rabbitmq-configuration
This data type represents the configuration for RabbitMQ.
@table @asis
@item @code{rabbitmq} (default: @code{rabbitmq})
The RabbitMQ package to use.
@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{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.
@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
@node Certificate Services
@subsection Certificate Services