ci / test (pull_request) Successful in 37s
`inbuxa relay install --token -` puts the relay a server release attaches on this machine: the static inbuxa-relay binary, checked against a checksum pinned here and against the inbuxa release keys' signature in its .sig file, owned by the inbuxa-relay user so an upgrade from the console can replace it, under inbuxa-relay.service as inbuxa-server ships it (ports 25 and 443 and nothing more). It joins with the console's token as the relay's user, starts it, and checks it stays up. It refuses on a machine that runs the mail server, where port 25 or the link's port is held, and on a relay that hasn't joined without a token. Run again it converges: it keeps a binary of its release or a newer one from the console, and the --link-listen an earlier run set. `relay status` is the relay's own status, as its user; `relay uninstall` keeps its state, and --purge resets it first, which refuses while it holds mail unless --discard-held. RelaySHA256 is empty: no release has relay binaries yet, so the command says so until the pins PR for the first one fills it in. INBUXA_RELAY_BINARY installs a local build meanwhile, and e2e/cases/relay-host.sh runs with one (RELAY_BINARY in run.sh).
132 lines
7.8 KiB
Bash
132 lines
7.8 KiB
Bash
#!/bin/bash
|
|
# SPDX-FileCopyrightText: 2026 Coffey Labs LLC
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
#
|
|
# inbuxa Relay on a machine of its own: inbuxa relay install, run again,
|
|
# status, and uninstall with and without --purge. The relay joins with a
|
|
# token made here, for a server that never answers: the join itself is the
|
|
# relay's own, offline step, and what is checked is everything the installer
|
|
# puts around it -- the user, the directories, the unit, the ports.
|
|
#
|
|
# Until a server release carries relay binaries, pass one, taken out of an
|
|
# image built from inbuxa-server's Dockerfile.relay:
|
|
# RELAY_BINARY=path e2e/vm/run.sh e2e/cases/relay-host.sh
|
|
set -uo pipefail
|
|
|
|
pass=0; fail=0
|
|
ok() { echo " ok $*"; pass=$((pass+1)); }
|
|
bad() { echo " FAIL $*"; fail=$((fail+1)); }
|
|
|
|
BIN=/opt/inbuxa-relay/bin/inbuxa-relay
|
|
STATE=/var/lib/inbuxa-relay
|
|
UNIT=inbuxa-relay.service
|
|
[ -f /tmp/inbuxa-relay-test ] && export INBUXA_RELAY_BINARY=/tmp/inbuxa-relay-test
|
|
listening() { ss -Hltn "sport = :$1" | grep -q .; }
|
|
|
|
# A join token as the console makes one: base64url JSON, with a CA pin and a
|
|
# secret that nothing will ever check.
|
|
b64() { basenc --base64url -w0 | tr -d =; }
|
|
TOKEN=$(printf '{"v":1,"relayId":"e2e-relay","caSpki":"%s","secret":"%s","expiresAt":%d}' \
|
|
"$(head -c32 /dev/urandom | b64)" "$(head -c32 /dev/urandom | b64)" $(( $(date +%s) + 3600 )) | b64)
|
|
|
|
echo "==> without a token, it refuses"
|
|
OUT="$(/tmp/inbuxa relay install --yes 2>&1)"; rc=$?
|
|
[ $rc -ne 0 ] && echo "$OUT" | grep -q "hasn't joined a server yet" && ok "refused: not joined, no token" || bad "rc $rc: $OUT"
|
|
[ -e $BIN ] && bad "a binary was put in place anyway" || ok "nothing was installed"
|
|
|
|
echo
|
|
echo "==> without --yes, nothing happens"
|
|
OUT="$(echo "$TOKEN" | /tmp/inbuxa relay install --token - 2>&1)"; rc=$?
|
|
[ $rc -eq 1 ] && echo "$OUT" | grep -q "Nothing has happened yet" && ok "it printed the plan and stopped" || bad "rc $rc: $OUT"
|
|
echo "$OUT" | grep -q "join the server that made the token" && ok "the plan joins" || bad "the plan doesn't join"
|
|
echo "$OUT" | grep -q -- "--link-listen" && ok "it says to keep the link port to the server" || bad "no word on the link port"
|
|
|
|
echo
|
|
echo "==> installing, joining from standard input"
|
|
OUT="$(echo "$TOKEN" | /tmp/inbuxa relay install --token - --yes 2>&1)"; rc=$?
|
|
echo "$OUT" | tail -14 | sed 's/^/ /'
|
|
[ $rc -eq 0 ] && ok "installed (exit 0)" || { bad "exit $rc"; journalctl -u $UNIT -n 20 --no-pager -o cat | sed 's/^/ | /'; }
|
|
echo "$OUT" | grep -q "$TOKEN" && bad "the token was printed" || ok "the token wasn't printed"
|
|
|
|
echo
|
|
echo "==> what is here"
|
|
systemctl is-active --quiet $UNIT && ok "$UNIT is running" || bad "$UNIT is not running"
|
|
systemctl is-enabled --quiet $UNIT && ok "and starts at boot" || bad "not enabled"
|
|
PID=$(systemctl show -p MainPID --value $UNIT)
|
|
[ "$(ps -o user= -p "$PID" 2>/dev/null)" = inbuxa-relay ] && ok "as the inbuxa-relay user" || bad "as '$(ps -o user= -p "$PID" 2>/dev/null)'"
|
|
CAP=$(awk '/^CapEff/ {print $2}' /proc/$PID/status)
|
|
[ "$CAP" = 0000000000000400 ] && ok "with CAP_NET_BIND_SERVICE alone" || bad "CapEff $CAP"
|
|
[ "$(stat -c '%U %a' $BIN)" = "inbuxa-relay 755" ] && ok "the binary is the relay's own, 755" || bad "the binary is $(stat -c '%U %a' $BIN)"
|
|
[ "$(stat -c '%U %a' /opt/inbuxa-relay)" = "root 755" ] && ok "/opt/inbuxa-relay is root's" || bad "/opt/inbuxa-relay is $(stat -c '%U %a' /opt/inbuxa-relay)"
|
|
[ "$(stat -c '%U %a' $STATE)" = "inbuxa-relay 700" ] && ok "$STATE is the relay's alone" || bad "$STATE is $(stat -c '%U %a' $STATE)"
|
|
[ -f $STATE/identity.json ] && ok "it joined (identity.json)" || bad "no identity.json"
|
|
listening 443 && ok "the link listens on 443" || bad "nothing on 443"
|
|
listening 25 && bad "port 25 is open before the server sent its settings" || ok "port 25 stays closed until the server sends its settings"
|
|
getent passwd inbuxa-relay | grep -q nologin && ok "the user can't log in" || bad "$(getent passwd inbuxa-relay)"
|
|
|
|
echo
|
|
echo "==> status"
|
|
OUT="$(/tmp/inbuxa relay status 2>&1)"; rc=$?
|
|
echo "$OUT" | sed 's/^/ /'
|
|
[ $rc -eq 0 ] && ok "status (exit 0)" || bad "exit $rc"
|
|
echo "$OUT" | grep -q "Relay: *e2e-relay" && ok "the relay's own status, as its user" || bad "no relay status"
|
|
echo "$OUT" | grep -q "Joined: *waiting for the downstream" && ok "waiting for its server" || bad "not waiting"
|
|
|
|
echo
|
|
echo "==> run again, with no token and no binary: a converge"
|
|
PID=$(systemctl show -p MainPID --value $UNIT)
|
|
OUT="$(env -u INBUXA_RELAY_BINARY /tmp/inbuxa relay install --yes 2>&1)"; rc=$?
|
|
[ $rc -eq 0 ] && ok "converged (exit 0)" || bad "exit $rc: $OUT"
|
|
echo "$OUT" | grep -q "keep inbuxa-relay" && ok "it kept the binary" || bad "it didn't keep the binary: $OUT"
|
|
[ "$(systemctl show -p MainPID --value $UNIT)" = "$PID" ] && ok "and left the relay running as it was" || bad "it restarted the relay"
|
|
|
|
echo
|
|
echo "==> the link on another address, then run again without it"
|
|
OUT="$(env -u INBUXA_RELAY_BINARY /tmp/inbuxa relay install --link-listen 127.0.0.1:8443 --yes 2>&1)"; rc=$?
|
|
[ $rc -eq 0 ] && ok "moved (exit 0)" || bad "exit $rc: $OUT"
|
|
listening 8443 && ! listening 443 && ok "the link listens on 8443 only" || bad "$(ss -Hltn)"
|
|
OUT="$(env -u INBUXA_RELAY_BINARY /tmp/inbuxa relay install --yes 2>&1)"; rc=$?
|
|
grep -q -- "--link-listen 127.0.0.1:8443" /etc/systemd/system/$UNIT && listening 8443 && ok "a run without --link-listen keeps it" || bad "it went back: $OUT"
|
|
env -u INBUXA_RELAY_BINARY /tmp/inbuxa relay install --link-listen '[::]:443' --yes >/dev/null 2>&1
|
|
listening 443 && ok "and back to 443" || bad "not back on 443"
|
|
|
|
echo
|
|
echo "==> something else on port 25 is refused"
|
|
systemctl stop $UNIT
|
|
python3 -c 'import socket,time; s=socket.socket(); s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1); s.bind(("", 25)); s.listen(); time.sleep(30)' &
|
|
HOLDER=$!; sleep 1
|
|
OUT="$(env -u INBUXA_RELAY_BINARY /tmp/inbuxa relay install --yes 2>&1)"; rc=$?
|
|
[ $rc -ne 0 ] && echo "$OUT" | grep -q "port 25 is held by python3" && ok "refused: port 25 is held by python3" || bad "rc $rc: $OUT"
|
|
kill $HOLDER; wait $HOLDER 2>/dev/null
|
|
env -u INBUXA_RELAY_BINARY /tmp/inbuxa relay install --yes >/dev/null 2>&1 && systemctl is-active --quiet $UNIT && ok "and once it's gone, it starts" || bad "it didn't start again"
|
|
|
|
echo
|
|
echo "==> uninstall keeps its state"
|
|
OUT="$(/tmp/inbuxa relay uninstall --yes 2>&1)"; rc=$?
|
|
[ $rc -eq 0 ] && ok "uninstalled (exit 0)" || bad "exit $rc: $OUT"
|
|
[ ! -e /etc/systemd/system/$UNIT ] && [ ! -e /opt/inbuxa-relay ] && ok "the unit and the binary are gone" || bad "left behind: $(ls /etc/systemd/system/$UNIT /opt/inbuxa-relay 2>&1)"
|
|
[ -f $STATE/identity.json ] && getent passwd inbuxa-relay >/dev/null && ok "its state and its user are kept" || bad "its state or user went"
|
|
listening 443 && bad "something still listens on 443" || ok "nothing listens on 443"
|
|
|
|
echo
|
|
echo "==> installed again, it is the same relay: no token needed"
|
|
OUT="$(/tmp/inbuxa relay install --yes 2>&1)"; rc=$?
|
|
[ $rc -eq 0 ] && ! echo "$OUT" | grep -q "join the server" && ok "back, without joining again" || bad "rc $rc: $OUT"
|
|
/tmp/inbuxa relay status 2>&1 | grep -q "Relay: *e2e-relay" && ok "as e2e-relay" || bad "a different relay"
|
|
|
|
echo
|
|
echo "==> uninstall --purge"
|
|
OUT="$(/tmp/inbuxa relay uninstall --purge 2>&1)"; rc=$?
|
|
[ $rc -eq 1 ] && echo "$OUT" | grep -q "Remove it in the console too" && ok "without --yes it says what it would do" || bad "rc $rc: $OUT"
|
|
OUT="$(/tmp/inbuxa relay uninstall --purge --yes 2>&1)"; rc=$?
|
|
echo "$OUT" | tail -8 | sed 's/^/ /'
|
|
[ $rc -eq 0 ] && ok "purged (exit 0)" || bad "exit $rc"
|
|
[ ! -e $STATE ] && ok "$STATE is gone" || bad "$STATE is still here"
|
|
getent passwd inbuxa-relay >/dev/null && bad "the user is still here" || ok "the user is gone"
|
|
OUT="$(/tmp/inbuxa relay status 2>&1)"; rc=$?
|
|
[ $rc -eq 1 ] && echo "$OUT" | grep -q "isn't installed here" && ok "status: not installed" || bad "rc $rc: $OUT"
|
|
|
|
echo
|
|
echo "relay-host: $pass passed, $fail failed"
|
|
[ $fail -eq 0 ]
|