feat: nexus installer — Host-Mode-Runner, App-User, Service-Skeleton, enge sudoers
This commit is contained in:
@@ -0,0 +1,199 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# nexus installer — runs inside the LXC, called by ct/nexus.sh
|
||||||
|
#
|
||||||
|
# Sets up the deploy target for nexus (Family Knowledge Hub):
|
||||||
|
# - Node.js (NodeSource) + git + rsync + sudo (Node also needed by checkout action in host mode)
|
||||||
|
# - act_runner in HOST mode (no Docker), registered to the Gitea instance,
|
||||||
|
# running as the unprivileged `nexus` user and polling Gitea outbound
|
||||||
|
# - a SKELETON systemd service (nexus.service) — the stack-introducing SDD
|
||||||
|
# card in nexus-hub provides /opt/nexus/current/start.sh and may extend
|
||||||
|
# the RUNTIME section below (DB clients, Python/uv, etc.)
|
||||||
|
# - a narrow sudoers rule so the runner may only restart that one service
|
||||||
|
#
|
||||||
|
# The actual build/test/deploy logic lives in the nexus-hub repo workflows
|
||||||
|
# (.gitea/workflows/ci.yml + deploy.yml) — deploy-as-code.
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
APP="nexus"
|
||||||
|
LIB_URL="${LIB_URL:-https://gitea.luki-net.org/luki-net/proxmox-scripts/raw/branch/main/lib}"
|
||||||
|
source <(curl -fsSL "$LIB_URL/install.func")
|
||||||
|
|
||||||
|
[[ "$EUID" -eq 0 ]] || { msg_err "Must run as root"; exit 1; }
|
||||||
|
|
||||||
|
# ── load deploy config pushed in by the host script ──────────────────────────
|
||||||
|
CONF="/root/nexus.deploy.env"
|
||||||
|
[[ -f "$CONF" ]] || { msg_err "$CONF not found (host bootstrap incomplete)"; exit 1; }
|
||||||
|
set -a; . "$CONF"; set +a
|
||||||
|
|
||||||
|
: "${GITEA_INSTANCE_URL:?missing GITEA_INSTANCE_URL}"
|
||||||
|
: "${RUNNER_TOKEN:?missing RUNNER_TOKEN}"
|
||||||
|
APP_PORT="${APP_PORT:-8080}"
|
||||||
|
NODE_MAJOR="${NODE_MAJOR:-22}"
|
||||||
|
RUNNER_VERSION="${RUNNER_VERSION:-0.2.13}"
|
||||||
|
RUNNER_LABELS="${RUNNER_LABELS:-nexus:host}"
|
||||||
|
RUNNER_NAME="${RUNNER_NAME:-$(hostname)}"
|
||||||
|
|
||||||
|
APP_USER="nexus"
|
||||||
|
APP_HOME="/opt/nexus"
|
||||||
|
RUNNER_DIR="$APP_HOME/runner"
|
||||||
|
CURRENT_DIR="$APP_HOME/current"
|
||||||
|
DATA_DIR="$APP_HOME/data"
|
||||||
|
CONF_DIR="/etc/nexus"
|
||||||
|
ENV_FILE="$CONF_DIR/env"
|
||||||
|
|
||||||
|
run_user() { runuser -u "$APP_USER" -- env HOME="$APP_HOME" "$@"; }
|
||||||
|
|
||||||
|
# ── packages: git + rsync + sudo ; Node.js via NodeSource ─────────────────────
|
||||||
|
setup_base_apt git rsync sudo
|
||||||
|
|
||||||
|
NODE_HAVE="$(command -v node >/dev/null 2>&1 && node -v | sed -E 's/^v([0-9]+).*/\1/' || echo 0)"
|
||||||
|
if [[ "$NODE_HAVE" != "$NODE_MAJOR" ]]; then
|
||||||
|
msg_info "Installing Node.js ${NODE_MAJOR}.x (NodeSource)..."
|
||||||
|
curl -fsSL "https://deb.nodesource.com/setup_${NODE_MAJOR}.x" | bash - >/dev/null
|
||||||
|
apt-get install -y -qq nodejs >/dev/null
|
||||||
|
msg_ok "Node $(node -v) installed"
|
||||||
|
else
|
||||||
|
msg_warn "Node $(node -v) already present, skipping"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# ── RUNTIME (extended by the stack-introducing SDD card in nexus-hub) ─────────
|
||||||
|
# The nexus tech stack is not yet decided (nexus-hub Project Brief, open point 2).
|
||||||
|
# When the stack card lands, it adds the runtime here (e.g. Python/uv, DB client
|
||||||
|
# libs) AND documents the change in nexus-hub docs/agent-rules.md → Projekt-Kommandos.
|
||||||
|
msg_warn "RUNTIME section is a placeholder until the nexus stack decision (see nexus-hub)"
|
||||||
|
|
||||||
|
# ── act_runner binary ─────────────────────────────────────────────────────────
|
||||||
|
if [[ ! -x /usr/local/bin/act_runner ]]; then
|
||||||
|
ARCH="$(dpkg --print-architecture)"
|
||||||
|
case "$ARCH" in amd64|arm64) ;; *) msg_err "unsupported arch: $ARCH"; exit 1 ;; esac
|
||||||
|
msg_info "Downloading act_runner $RUNNER_VERSION ($ARCH)..."
|
||||||
|
curl -fsSL "https://dl.gitea.com/act_runner/${RUNNER_VERSION}/act_runner-${RUNNER_VERSION}-linux-${ARCH}" \
|
||||||
|
-o /usr/local/bin/act_runner
|
||||||
|
chmod +x /usr/local/bin/act_runner
|
||||||
|
msg_ok "act_runner $(/usr/local/bin/act_runner --version 2>/dev/null | head -n1)"
|
||||||
|
else
|
||||||
|
msg_warn "act_runner already present, skipping download"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# ── user + dirs ───────────────────────────────────────────────────────────────
|
||||||
|
create_system_user "$APP_USER" "$APP_HOME"
|
||||||
|
mkdir -p "$RUNNER_DIR" "$CURRENT_DIR" "$DATA_DIR" "$CONF_DIR"
|
||||||
|
chown -R "$APP_USER:$APP_USER" "$APP_HOME"
|
||||||
|
|
||||||
|
# ── env file (runtime config; populated further by the stack card) ────────────
|
||||||
|
cat >"$ENV_FILE" <<EOF
|
||||||
|
NEXUS_ENV=production
|
||||||
|
NEXUS_PORT=$APP_PORT
|
||||||
|
NEXUS_DATA_DIR=$DATA_DIR
|
||||||
|
EOF
|
||||||
|
chown root:"$APP_USER" "$ENV_FILE"
|
||||||
|
chmod 640 "$ENV_FILE"
|
||||||
|
|
||||||
|
# ── register the runner (idempotent) ──────────────────────────────────────────
|
||||||
|
if [[ ! -f "$RUNNER_DIR/.runner" ]]; then
|
||||||
|
msg_info "Registering runner '$RUNNER_NAME' [$RUNNER_LABELS] with $GITEA_INSTANCE_URL..."
|
||||||
|
run_user bash -c "cd '$RUNNER_DIR' && /usr/local/bin/act_runner register \
|
||||||
|
--no-interactive \
|
||||||
|
--instance '$GITEA_INSTANCE_URL' \
|
||||||
|
--token '$RUNNER_TOKEN' \
|
||||||
|
--name '$RUNNER_NAME' \
|
||||||
|
--labels '$RUNNER_LABELS'"
|
||||||
|
chown -R "$APP_USER:$APP_USER" "$RUNNER_DIR"
|
||||||
|
msg_ok "Runner registered"
|
||||||
|
else
|
||||||
|
msg_warn "Runner already registered (.runner exists), skipping"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# ── narrow sudoers: runner may ONLY (re)start/stop/status nexus.service ───────
|
||||||
|
cat >/etc/sudoers.d/nexus-deploy <<EOF
|
||||||
|
$APP_USER ALL=(root) NOPASSWD: /usr/bin/systemctl restart nexus.service, /usr/bin/systemctl start nexus.service, /usr/bin/systemctl stop nexus.service, /usr/bin/systemctl status nexus.service
|
||||||
|
EOF
|
||||||
|
chmod 440 /etc/sudoers.d/nexus-deploy
|
||||||
|
visudo -cf /etc/sudoers.d/nexus-deploy >/dev/null
|
||||||
|
|
||||||
|
# ── systemd units ─────────────────────────────────────────────────────────────
|
||||||
|
# nexus.service: SKELETON. The deploy workflow populates /opt/nexus/current and
|
||||||
|
# the stack card provides current/start.sh. Enabled (starts on boot) but not
|
||||||
|
# started now — first successful deploy starts it via the sudoers-allowed restart.
|
||||||
|
cat >/etc/systemd/system/nexus.service <<EOF
|
||||||
|
[Unit]
|
||||||
|
Description=nexus — Family Knowledge Hub
|
||||||
|
After=network-online.target
|
||||||
|
Wants=network-online.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
User=$APP_USER
|
||||||
|
Group=$APP_USER
|
||||||
|
WorkingDirectory=$CURRENT_DIR
|
||||||
|
EnvironmentFile=$ENV_FILE
|
||||||
|
ExecStart=$CURRENT_DIR/start.sh
|
||||||
|
Restart=on-failure
|
||||||
|
RestartSec=5
|
||||||
|
NoNewPrivileges=true
|
||||||
|
ProtectSystem=full
|
||||||
|
PrivateTmp=true
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat >/etc/systemd/system/nexus-runner.service <<EOF
|
||||||
|
[Unit]
|
||||||
|
Description=nexus — Gitea Actions runner (host mode, CI + deploy)
|
||||||
|
After=network-online.target
|
||||||
|
Wants=network-online.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
User=$APP_USER
|
||||||
|
Group=$APP_USER
|
||||||
|
WorkingDirectory=$RUNNER_DIR
|
||||||
|
Environment=HOME=$APP_HOME
|
||||||
|
Environment=PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
|
||||||
|
ExecStart=/usr/local/bin/act_runner daemon
|
||||||
|
Restart=on-failure
|
||||||
|
RestartSec=5
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
EOF
|
||||||
|
|
||||||
|
systemctl daemon-reload
|
||||||
|
systemctl enable nexus.service >/dev/null 2>&1
|
||||||
|
systemctl enable --now nexus-runner.service
|
||||||
|
msg_ok "systemd units installed (runner started; nexus.service enabled, starts on first deploy)"
|
||||||
|
|
||||||
|
# ── notes / summary file ──────────────────────────────────────────────────────
|
||||||
|
CRED_FILE="/root/nexus.credentials"
|
||||||
|
cat >"$CRED_FILE" <<EOF
|
||||||
|
nexus — Family Knowledge Hub deployed via a self-hosted Gitea Actions runner
|
||||||
|
|
||||||
|
Repo (informational): ${REPO_URL:-https://gitea.luki-net.org/l.kirchner/nexus-hub.git}
|
||||||
|
Gitea instance: $GITEA_INSTANCE_URL
|
||||||
|
Runner name / labels: $RUNNER_NAME [$RUNNER_LABELS] (act_runner $RUNNER_VERSION, host mode)
|
||||||
|
API (local): http://127.0.0.1:$APP_PORT (live after first deploy + stack card)
|
||||||
|
Live copy: $CURRENT_DIR
|
||||||
|
Data dir: $DATA_DIR
|
||||||
|
Runtime env: $ENV_FILE
|
||||||
|
|
||||||
|
CI + deploy are driven by the repo workflows .gitea/workflows/{ci,deploy}.yml
|
||||||
|
nexus.service is a SKELETON — ExecStart expects $CURRENT_DIR/start.sh, which
|
||||||
|
the stack-introducing SDD card provides. Until then only ci.yml is functional.
|
||||||
|
|
||||||
|
Manual restart: sudo systemctl restart nexus.service
|
||||||
|
Logs: journalctl -u nexus -u nexus-runner -f
|
||||||
|
|
||||||
|
Prerequisites on the Gitea side:
|
||||||
|
- Actions enabled on the instance and on the repo (repo -> Settings -> Actions)
|
||||||
|
- The LXC needs outbound HTTPS to $GITEA_INSTANCE_URL and to github.com
|
||||||
|
(the latter only to fetch actions/checkout, unless you self-host actions)
|
||||||
|
EOF
|
||||||
|
chmod 600 "$CRED_FILE"
|
||||||
|
|
||||||
|
# registration token already consumed → drop the bootstrap env file
|
||||||
|
shred -u "$CONF" 2>/dev/null || rm -f "$CONF"
|
||||||
|
|
||||||
|
apt_cleanup
|
||||||
|
msg_ok "$APP installation finished"
|
||||||
Reference in New Issue
Block a user