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>
37 lines
1.6 KiB
YAML
37 lines
1.6 KiB
YAML
# SOPS recipient rules.
|
|
#
|
|
# Each rule pins one or more age public keys as recipients for files matching
|
|
# the path_regex. The build_host_files.py generator doesn't read this file;
|
|
# `sops` does — to encrypt a new secret, run `sops -e secrets/<name>.yaml`
|
|
# from the repo root and SOPS will pick the matching rule below.
|
|
#
|
|
# To grant a secret to a new client: add their age public key (from
|
|
# inventory.yaml `hosts.<name>.age_pubkey`) to the relevant rule below, then
|
|
# run `sops updatekeys secrets/<name>.yaml` to re-encrypt without rotating
|
|
# the ciphertext payload.
|
|
#
|
|
# To revoke: remove the recipient from the relevant rule and run
|
|
# `sops updatekeys` (this is what `homelab client remove` calls). Past
|
|
# ciphertext the client already decrypted is not affected — rotate the
|
|
# underlying credential if compromise is suspected.
|
|
|
|
creation_rules:
|
|
- path_regex: ^secrets/hello\.yaml$
|
|
# The "hello" secret is encrypted to every enrolled client so the bootstrap
|
|
# decrypt test works for everyone. Populated by the operator with the
|
|
# age_pubkey from each hosts/<name>.yaml after Phase 3a generates keys.
|
|
age: >-
|
|
# placeholder — operator fills in after first issuance run.
|
|
# comma-separated age public keys, e.g.:
|
|
# age1xxx,age1yyy,age1zzz
|
|
|
|
- path_regex: ^secrets/gitea-tokens\.yaml$
|
|
# Workstations only.
|
|
age: >-
|
|
# placeholder — fill with age_pubkey of: republic-laptop, mac-mini, ludo-mini, hubris
|
|
|
|
- path_regex: ^secrets/webhook-hmacs\.yaml$
|
|
# LXCs that run a webhook receiver.
|
|
age: >-
|
|
# placeholder — fill with age_pubkey of: apps, caddy, claudio-bot, claudio-monitor host
|