Add LavinMQ Alpine package

2026-07-08 14:13:19 +02:00
parent 08e516475f
commit 0f311d47fe
18 changed files with 332 additions and 24 deletions
@@ -0,0 +1,72 @@
+# LavinMQ Alpine Package
+
+Builds LavinMQ from the upstream source release and packages the OpenRC
+service plus `/etc/lavinmq` defaults.
+
+Build command:
+
+```sh
+make
+```
+
+LavinMQ 2.9.1 requires Crystal 1.20.1 or newer, so build with Alpine 3.24 or
+newer.
+
+## Runtime Layout
+
+Installs:
+
+- `lavinmq`
+- `lavinmqctl`
+- `lavinmqperf`
+- `/etc/lavinmq/lavinmq.ini`
+- `/var/lib/lavinmq`
+
+Default ports:
+
+- `5672`: AMQP
+- `15672`: management UI
+
+## OpenRC Usage
+
+```sh
+apk add lavinmq lavinmq-doc lavinmq-openrc
+rc-update add lavinmq default
+rc-service lavinmq start
+```
+
+Wrapper settings in `/etc/conf.d/lavinmq`:
+
+- `LAVINMQ_CONFIG`: config file path passed with `--config`
+- `LAVINMQ_DATA_DIR`: data directory passed with `-D`
+- `LAVINMQ_OPTS`: extra LavinMQ arguments appended after package defaults
+
+## Package Commands
+
+Refresh checksums:
+
+```sh
+ALPINE_PACKAGE=lavinmq mise run apk:checksum
+```
+
+Build:
+
+```sh
+ALPINE_PACKAGE=lavinmq mise run apk:build
+```
+
+Install-test local build:
+
+```sh
+ALPINE_PACKAGE=lavinmq SKIP_BUILD=1 mise run apk:test-install
+```
+
+Install-test published repository:
+
+```sh
+ALPINE_PACKAGE=lavinmq \
+SKIP_BUILD=1 \
+ALPINE_REPOSITORY_URL=https://code.factoring.digital/api/packages/public/alpine/v3.24/alpine-packages \
+ALPINE_REPOSITORY_KEY_URL=https://code.factoring.digital/api/packages/public/alpine/key \
+mise run apk:test-install
+```