diff options
| author | wrobell <wrobell@riseup.net> | 2026-06-16 20:17:41 +0100 |
|---|---|---|
| committer | Nguyễn Gia Phong <cnx@loang.net> | 2026-07-26 15:23:19 +0900 |
| commit | ce8df300216b308720903e6da9e01d246143b47f (patch) | |
| tree | 6184790b895796fd3621bf753daddc4471449ee3 /doc | |
| parent | 47b41dced835020f803dc56f52e949c94d2f7061 (diff) | |
services: Add epmd-service-type.
Add Erlang Port Mapper Daemon (epmd) service.
Run the service on localhost by default.
* gnu/services/high-availability.scm (<epmd-configuration>): New record.
(epmd-service-type): New variable.
* gnu/tests/high-availability.scm (run-epmd-test): New procedure.
(%epmd-os, %tests-epmd): New variables.
* doc/gnu.texi (High Availability Services): Document it.
Merges: https://codeberg.org/guix/guix/pulls/9607
References: https://www.rabbitmq.com/blog/2024/12/18/epmd-public-exposure
References: https://erlef.org/blog/eef/epmd-public-exposure
Signed-off-by: Nguyễn Gia Phong <cnx@loang.net>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/guix.texi | 54 |
1 files changed, 49 insertions, 5 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 0db590aa5f7..12eca80ed3c 100644 --- a/doc/guix.texi +++ b/doc/guix.texi | |||
| @@ -37746,16 +37746,60 @@ Extra configuration parameters as a list of strings. | |||
| 37746 | @node High Availability Services | 37746 | @node High Availability Services |
| 37747 | @subsection High Availability Services | 37747 | @subsection High Availability Services |
| 37748 | 37748 | ||
| 37749 | @cindex Message broker | 37749 | The @code{(gnu services high-availability)} module provides services for |
| 37750 | @cindex Message streaming | 37750 | Erlang Port Mapper Daemon (epmd) and RabbitMQ broker. |
| 37751 | The @code{(gnu services high-availability)} module provides RabbitMQ | 37751 | |
| 37752 | message broker service. | 37752 | @anchor{epmd} |
| 37753 | @subsubheading Erlang Port Mapper Daemon (epmd) | ||
| 37754 | |||
| 37755 | @defvar epmd-service-type | ||
| 37756 | Service type for the | ||
| 37757 | @uref{https://www.erlang.org/doc/apps/erts/epmd_cmd.html,Erlang Port Mapper | ||
| 37758 | Daemon (epmd)}. | ||
| 37759 | The value for this service type is a @code{<epmd-configuration>} record. | ||
| 37760 | |||
| 37761 | Below is an example configuration: | ||
| 37762 | |||
| 37763 | @lisp | ||
| 37764 | (service epmd-service-type) | ||
| 37765 | @end lisp | ||
| 37766 | @end defvar | ||
| 37767 | |||
| 37768 | @c %start of fragment | ||
| 37769 | |||
| 37770 | @deftp {Data Type} epmd-configuration | ||
| 37771 | Available @code{epmd-configuration} fields are: | ||
| 37772 | |||
| 37773 | @table @asis | ||
| 37774 | @item @code{user} (default: @code{"epmd"}) (type: string) | ||
| 37775 | The user running epmd. | ||
| 37776 | |||
| 37777 | @item @code{group} (default: @code{"epmd"}) (type: string) | ||
| 37778 | The user group running epmd. | ||
| 37779 | |||
| 37780 | @item @code{address} (default: @code{("127.0.0.1" "::1")}) (type: list-of-strings) | ||
| 37781 | List of addresses for epmd to listen on. Set it to false (@code{#f}) to | ||
| 37782 | listen on all available addresses. Note that epmd cannot start on | ||
| 37783 | @code{"0.0.0.0"} address. | ||
| 37784 | |||
| 37785 | @item @code{port} (default: @code{4369}) (type: integer) | ||
| 37786 | Default port for epmd to listen on. | ||
| 37787 | |||
| 37788 | @end table | ||
| 37789 | |||
| 37790 | @end deftp | ||
| 37791 | |||
| 37792 | |||
| 37793 | @c %end of fragment | ||
| 37753 | 37794 | ||
| 37754 | @anchor{RabbitMQ} | 37795 | @anchor{RabbitMQ} |
| 37755 | @subsubheading RabbitMQ | 37796 | @subsubheading RabbitMQ |
| 37756 | 37797 | ||
| 37798 | @cindex Message broker | ||
| 37799 | @cindex Message streaming | ||
| 37800 | |||
| 37757 | @defvar rabbitmq-service-type | 37801 | @defvar rabbitmq-service-type |
| 37758 | Service type for the @uref{https://www.rabbitmq.com/,RabbitMQ} web server. | 37802 | Service type for the @uref{https://www.rabbitmq.com/,RabbitMQ} server. |
| 37759 | The value for this service type is a @code{<rabbitmq-configuration>} record. | 37803 | The value for this service type is a @code{<rabbitmq-configuration>} record. |
| 37760 | 37804 | ||
| 37761 | A simple example configuration is given below. | 37805 | A simple example configuration is given below. |
