testsAndMisc/endurain/scripts/publish_endurain.sh
Krzysztof kuhy Rudnicki 558883f281 feat(endurain): self-hosted run viewer fed by RunnerUp WebDAV exports
Stands up Endurain behind the existing Caddy edge and imports RunnerUp
activities into it. Endurain is a VIEWER: screen-locker's workout gate still
reads the phone over adb and is untouched here, because a WebDAV drop folder is
spoofable by anything that can write to ~/cloud and must not become a
screen-unlock authority.

Primary path is phone -> WebDAV (existing dufs) -> ~/cloud/RunnerUp/ ->
importer -> Endurain, with an adb pull as fallback when a run has not been
uploaded yet. A systemd user timer runs the importer every 15 min.

Findings that shaped the implementation, each verified against the running
system rather than assumed:

- Endurain moved to Codeberg; the GitHub repo is a read-only mirror stale at
  v0.17.7 against v0.19.0. The image is pulled from Codeberg.
- postgres:18 moved PGDATA to /var/lib/postgresql/18/docker. Upstream's compose
  example still mounts the pre-18 path, which fails as an unexplained
  "container is unhealthy"; the real cause is only visible in docker logs.
- Endurain seeds a hardcoded admin/admin via an Alembic migration with no env
  override, and endurain.kuhy.duckdns.org already resolved publicly. Publishing
  is therefore a separate script that refuses to install the Caddy site while
  those credentials still work.
- Endurain performs NO duplicate detection, so the importer owns dedupe on two
  axes: a content hash, and an activity key that collapses the .gpx/.tcx pair
  RunnerUp writes for a single run (different bytes, same run).
- Ambiguous uploads (5xx/timeout) are never re-queued, since the activity may
  already have been committed; only definite 4xx rejections are staged for
  retry. The importer exits non-zero so the timer surfaces the problem.
- RunnerUp has no background sync at all, so every upload is a manual tap.
- Its WebDAV synchronizer needs HTTPS with a real cert (Android blocks
  cleartext at targetSdk 36; self-signed is broken upstream) and a URL with no
  trailing slash, and cannot MKCOL against dufs - so the inbox must pre-exist.

The phone gets a dufs credential scoped to /RunnerUp, verified unable to read
Keepass or gdrive_backups.

Verified: 52 tests at 100% branch coverage; the timer imports 4 real runs and
re-runs create zero duplicates; https://endurain.kuhy.duckdns.org serves 200
with a valid cert and the other edge sites are unaffected; screen-locker's
suite still passes 1090 tests at 100% coverage.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GbYEnfGnf1988cdFdGebot
2026-08-23 13:09:18 +02:00

105 lines
3.3 KiB
Bash
Executable File

#!/bin/bash
# ============================================================================
# Publish Endurain on the shared Caddy edge (endurain.kuhy.duckdns.org).
#
# Split out of setup_endurain.sh deliberately. endurain.kuhy.duckdns.org
# already resolves to this host via the duckdns wildcard on "kuhy", so
# installing the site snippet makes the service world-reachable the moment
# Caddy reloads. Endurain ships a hardcoded admin/admin account seeded by an
# Alembic migration with no environment override, so publishing before that
# password is changed hands the internet an admin login.
#
# This script therefore re-runs the same gate and REFUSES to publish while the
# seeded credentials still work.
# ============================================================================
set -euo pipefail
SCRIPT_NAME="$(basename "$0")"
readonly SCRIPT_NAME
readonly APP_URL="http://127.0.0.1:8085"
readonly PUBLIC_HOST="endurain.kuhy.duckdns.org"
readonly EDGE_DIR="${HOME}/gitea"
readonly SITE_FILE="${EDGE_DIR}/sites/endurain.caddy"
readonly EDGE_CONTAINER="gitea-caddy"
log() { printf '%s\n' "$*"; }
log_ok() { printf ' ok: %s\n' "$*"; }
die() {
printf 'Error: %s\n' "$*" >&2
exit 1
}
usage() {
echo "Usage: ${SCRIPT_NAME}"
echo " Installs the Caddy site for ${PUBLIC_HOST} and reloads the edge."
exit 0
}
# Fail closed. Only an explicit rejection counts as "safe"; any unexpected
# status is treated as still-vulnerable.
assert_admin_password_changed() {
local code
code="$(curl -sS -o /dev/null -w '%{http_code}' --max-time 10 \
-X POST "${APP_URL}/api/v1/auth/login" \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'X-Client-Type: mobile' \
--data 'username=admin&password=admin' 2>/dev/null || echo 000)"
case "${code}" in
401 | 403) log_ok "seeded admin/admin is rejected" ;;
200) die "REFUSING TO PUBLISH: Endurain still accepts admin/admin.
Change it at ${APP_URL} first." ;;
*) die "REFUSING TO PUBLISH: unexpected status ${code} from the login
probe; cannot prove the seeded password was changed." ;;
esac
}
validate_requirements() {
command -v docker >/dev/null || die "docker not installed"
[[ -d "${EDGE_DIR}/sites" ]] || die "Caddy edge not found at ${EDGE_DIR}/sites"
docker ps --format '{{.Names}}' | grep -qx "${EDGE_CONTAINER}" ||
die "${EDGE_CONTAINER} is not running"
curl -fsS --max-time 5 "${APP_URL}/api/v1/about" >/dev/null ||
die "Endurain is not responding on ${APP_URL}"
}
install_site() {
cat >"${SITE_FILE}" <<EOF
# Managed by ${SCRIPT_NAME} — do not edit by hand.
${PUBLIC_HOST} {
reverse_proxy 127.0.0.1:8085
}
EOF
log_ok "Wrote ${SITE_FILE}"
}
reload_edge() {
# Validate before reloading so a broken snippet cannot take the whole edge
# (gitea, the cloud, the website) down with it.
docker exec "${EDGE_CONTAINER}" caddy validate --config /etc/caddy/Caddyfile \
>/dev/null 2>&1 || die "Caddy config failed validation; edge NOT reloaded"
docker exec "${EDGE_CONTAINER}" caddy reload --config /etc/caddy/Caddyfile \
>/dev/null || die "caddy reload failed"
log_ok "Edge reloaded"
}
main() {
validate_requirements
assert_admin_password_changed
install_site
reload_edge
log ""
log "Published: https://${PUBLIC_HOST}"
log "Caddy obtains the certificate on the first request; allow a few seconds."
}
while [[ $# -gt 0 ]]; do
case $1 in
-h | --help) usage ;;
*) die "Unknown option: $1" ;;
esac
done
main "$@"