eltonandClaude Fable 5.1
f133cdd869
Wirt, Ports, Volume, Routen über Caddy, Einrichtung und die drei Dinge, die beim ersten Aufsetzen Zeit gekostet haben. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
3.3 KiB
deploy — die lauffähige Referenz
km als compose-Dienst über oci (42i-oci), wie jeder andere Dienst im
Haus. Das ist nicht der Notbehelf, bis es ein Chart gibt: Wer den Dienst
auf k8s bringen will, sieht hier, welche Images, welche Umgebung und welche
Volumes er braucht — und kann sein Chart gegen etwas Laufendes prüfen. Das
Chart selbst gehört zu hive (Schnitt im Haupt-README).
Läuft seit dem 2026-09-04: hive.home
| Wirt | LXC 171144 (hive.home) auf neo, neben caddy und radicale |
| Dienst | /srv/km/compose.yml, oci enable km / oci restart km |
| Container | km (API + Takt, Port 8390) und km-ui (SilverBullet, Port 3000), beide network_mode: host |
| Volume | /srv/km/data/ablage — Git-Checkout von git.home/ahmann/km (privat); daneben km-index.sqlite und km-ingest-state.json |
| Quelle | git.home, Organisation ahmann, Namespace familie, Klassifikation home |
| Oberfläche | https://hive.home/km/ (SilverBullet, Login aus OpenBao elton/km-home) |
| API | https://hive.home/km/api/v1/…, https://hive.home/km/health |
| Takt | alle 5 Minuten: ziehen, Gitea einlesen, indexieren, Geändertes committen und pushen |
| Vektoren | aus (KM_EMBED=0) — erst, wenn es einen Abnehmer gibt; die Ollama-Instanz auf s18 ist vom LXC aus ohne VLAN5-Route nicht erreichbar |
| 42i-hc | /srv/km/health prüft die API und den letzten Lauf |
Caddy (/srv/caddy/Caddyfile) routet unter hive.home: /km/api/* und
/km/health an km (Präfix /km abgestreift), /km* an SilverBullet
(SB_URL_PREFIX=/km), alles andere an Radicale. Der Pfadraum an der Wurzel
bleibt geteilt (hive/core#61).
Einrichten
# im LXC
mkdir -p /srv/km/data
cp compose.yml /srv/km/ # build-Kontext dort: ./build/image
cp health /srv/km/ && chmod +x /srv/km/health
cp env.example /srv/km/.env && chmod 600 /srv/km/.env # dann ausfüllen
oci enable km && oci start km
Das Image heißt git.42i.org/spine/km:latest. Solange es keine Registry
mit anonymem Lesezugriff gibt (git.42i.org verlangt Login, und ein
Firmen-Token gehört nicht auf den Familien-LXC), wird es im LXC gebaut:
image/ hinkopieren nach /srv/km/build/image und
podman build --network=host -t git.42i.org/spine/km:latest . — ohne
--network=host scheitert der Bau im unprivilegierten LXC an /dev/net/tun.
Drei Dinge, die beim ersten Aufsetzen Zeit gekostet haben
- podman-compose kennt keine Defaults.
${VAR:-x}wird wörtlich durchgereicht; km bekam den Platzhalter als Repo-Namen. Deshalb steht jede Variable in der.env(env.example), und die Konfiguration verwirft Werte, die mit${beginnen. - Die interne CA.
git.homehat ein Zertifikat vonacme.lan.requestsbenutzt sein eigenes CA-Bündel und kennt sie nicht — deshalb wird das Bündel des Wirts eingehängt undREQUESTS_CA_BUNDLEdarauf gesetzt, wie beicaddy. - SilverBullet ist zuerst da. Beide Container mounten dasselbe Volume;
die Oberfläche legt ihre Dateien an, bevor km klonen kann. km
initialisiert die Ablage deshalb in place und holt den Remote-Stand
dazu;
.silverbullet*und_plug/stehen in der.gitignoreder Ablage.
Und aus dem Teamspace übernommen: Konfiguration ins Volume, nicht in eine Datei im Container; Secrets aus OpenBao, nie in der compose-Datei und nie in argv.