3c25f936d3
Add the foundation for distributing homelab context to every client (LXCs, VMs, workstations including republic-laptop, mac-mini, ludo-mini) with a single source of truth, structured query layer (MCP), and per-client age-key issuance for secrets: - inventory.yaml — canonical topology (hosts, services, mesh addresses) - hosts/*.yaml — per-host identity files generated from inventory by mcp/build_host_files.py; do not edit by hand - AGENTS.md — orientation doc symlinked to /root/AGENTS.md on every client - bootstrap.sh — one-shot enroll (Linux + macOS), clones repo, fetches age key from issuance, installs sync timer/launchd job, drops the homelab CLI - bin/homelab — single-binary Python CLI: whoami, list, ssh, pct, logs, restart, open, status, secret, sync, mcp, client add/remove, nuke - mcp/server.py — FastMCP server: context tools + read-only management tools (no mutations exposed); shell-outs use mcp-reader restricted ssh key - mcp/deploy/ — claudio-monitor-style gitea webhook deploy scaffold for the MCP service on LXC 105 (ports 9810 mcp, 9811 webhook) - secrets-issuance/ — per-client age key auto-provisioning over the mesh; source-IP gated against inventory, with denylist for revoked clients (ports 9820 issue, 9821 webhook) - secrets/, .sops.yaml — SOPS recipient scaffolding; the operator fills in age public keys after Phase 3a generates them - scripts/sync/ — systemd timer (Linux) + launchd plist (macOS) pulling /opt/homelab-context every 5 min Mesh: both Netbird (preferred, 100.122.0.0/16) and Tailscale accepted during the in-flight migration; no client is gated on completing the move. Plan reference: /root/.claude/plans/lets-make-a-plan-fluttering-trinket.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
31 lines
872 B
Bash
Executable File
31 lines
872 B
Bash
Executable File
#!/bin/bash
|
|
# First-time setup for the secrets-issuance deploy webhook. Generates a
|
|
# secret, installs the systemd unit, and starts it.
|
|
set -euo pipefail
|
|
|
|
SECRET_DIR=/etc/secrets-issuance-deploy
|
|
SECRET=$SECRET_DIR/secret
|
|
UNIT=secrets-issuance-deploy.service
|
|
|
|
install -d -m 700 "$SECRET_DIR"
|
|
if [ ! -s "$SECRET" ]; then
|
|
head -c 32 /dev/urandom | base64 > "$SECRET"
|
|
chmod 600 "$SECRET"
|
|
echo "[install] generated webhook secret at $SECRET"
|
|
fi
|
|
|
|
systemctl daemon-reload
|
|
systemctl enable --now "$UNIT"
|
|
systemctl status "$UNIT" --no-pager | head -10
|
|
|
|
cat <<EOF
|
|
|
|
[install] webhook listening on :9821/deploy.
|
|
Configure Gitea (dtoro/Homelab-Docs → Settings → Webhooks → Add Webhook → Gitea):
|
|
Target URL: http://<lxc-105-mesh-ip>:9821/deploy
|
|
HTTP Method: POST
|
|
Content-Type: application/json
|
|
Secret: $(cat $SECRET)
|
|
Trigger: Push events
|
|
EOF
|