Zum Hauptinhalt springen Zur Navigation springen Zur Fußzeile springen

Dienste

Containerisierte Dienste mithilfe von Rediaccfiles, Dienst-Netzwerk und Autostart bereitstellen und verwalten.

Dienste

Auf dieser Seite werden die Bereitstellung und Verwaltung containerisierter Dienste behandelt: Rediaccfiles, Dienst-Netzwerk, Starten/Stoppen, Massenoperationen und Autostart.

Das Rediaccfile

Das Rediaccfile ist ein Bash-Skript, das definiert, wie Ihre Dienste gestartet und gestoppt werden. Es wird sourced (nicht als separater Prozess ausgeführt), daher teilen sich seine Funktionen denselben Shell-Kontext und haben Zugriff auf alle exportierten Umgebungsvariablen. Es muss Rediaccfile oder rediaccfile (Groß-/Kleinschreibung wird nicht unterschieden) heißen und muss im eingebundenen Dateisystem des Repositories platziert werden.

Rediaccfiles werden an zwei Orten gesucht:

  1. Im Stammverzeichnis des Repository-Einbindungspfads
  2. In Unterverzeichnissen der ersten Ebene des Einbindungspfads (nicht rekursiv)

Versteckte Verzeichnisse (Namen, die mit . beginnen) werden übersprungen.

Lebenszyklus-Funktionen

renet führt diese Rediaccfile-Funktionen aus:

FunktionAusführungszeitpunktZweckFehlerverhalten
up()Beim StartenDienste starten (z. B. renet compose -- up -d)Fehler im Root-Rediaccfile sind kritisch (stoppt alles). Fehler in Unterverzeichnissen sind nicht-kritisch (werden protokolliert, es wird mit dem nächsten fortgefahren).
down()Beim StoppenDienste stoppen (z. B. renet compose -- down)Best-Effort — Fehler werden protokolliert, aber alle Rediaccfiles werden immer verarbeitet.
health()Bei rdc repo health, bei rdc machine health und im Health-Gate des DeploymentsDen eigenen Zustand des Repositorys melden: Exit 0 ok, 1 Warnung, 2 FehlerDas health() jedes Rediaccfiles läuft, und die schlechteste Stufe zählt. Exit 75 heißt: noch im Aufwärmen (eine Warnung). Jeder andere Exit, ein Signal oder ein Zeitlimit ist ein Fehler (das Health-Gate des Deployments wertet ein Zeitlimit als „noch im Aufwärmen“ und versucht es erneut, siehe Zeitlimits und Reihenfolge beim Herunterfahren). Ein Repository, dessen Rediaccfiles kein health() definieren, meldet keine Prüfung, nie „gesund“
repair()Bei rdc repo repair und bei rdc machine repair für ein Repository, dessen health() nicht ok istBeheben, was das health() derselben Datei gemeldet hatLäuft nur, wenn das health() seiner Datei nicht ok ist und die deklarierte Klasse erlaubt ist (siehe unten). Ein health() mit Exit 75 (noch im Aufwärmen) zählt als Warnung, daher sollte ein repair() ein Repository, das noch startet, in Ruhe lassen. Danach läuft health() erneut. Ein fehlgeschlagenes repair() oder eines mit Zeitüberschreitung ist ein Fehler

Jede Funktion ist optional. Ist eine Funktion nicht definiert, wird sie stillschweigend übersprungen.

Eine Reparaturklasse deklarieren

repair() erhält REDIACC_HEALTH_LEVEL (warning oder error, die Stufe, die das health() der eigenen Datei gemeldet hat) und REDIACC_HEALTH_OUTPUT (das Ende der Ausgabe dieses health()). Eine Kommentarzeile legt fest, wie sicher die Funktion ist:

# rediacc:repair class=auto-safe
# rediacc:repair class=auto-with-backup window=only
KlasseWer sie ausführt
auto-saferdc machine repair und rdc repo repair führen sie selbstständig aus
auto-with-backupLäuft nur mit --with-backup, nach einem erfolgreichen Snapshot des Repositorys
operator-onlyLäuft nie von selbst. rdc repo repair fragt zuerst nach (oder nimmt --yes); rdc machine repair führt sie nie aus

Ein repair() ohne Deklaration ist operator-only, sodass kein Werkzeug den Code eines Repositorys unbeaufsichtigt ausführt, solange das Repository ihn nicht als sicher kennzeichnet. window=only fügt eine zweite Bedingung hinzu: Die Funktion läuft nur innerhalb des Wartungsfensters der Maschine (Überwachung) oder mit --window-override. Deklarieren mehrere Zeilen eine Klasse, gilt die restriktivste.

Ausführungsreihenfolge

  • Starten (up): Zuerst das Root-Rediaccfile, dann Unterverzeichnisse in alphabetischer Reihenfolge (A bis Z).
  • Stoppen (down): Unterverzeichnisse in umgekehrt alphabetischer Reihenfolge (Z bis A), dann zuletzt das Root.

Umgebungsvariablen

Wenn eine Rediaccfile-Funktion ausgeführt wird, stehen folgende Umgebungsvariablen zur Verfügung:

VariableBeschreibungBeispiel
REDIACC_WORKING_DIREinbindungspfad des Repositories/mnt/rediacc/mounts/abc123
REDIACC_REPOSITORYRepository-GUIDa1b2c3d4-e5f6-...
REDIACC_NETWORK_IDNetzwerk-ID (Ganzzahl)2816
DOCKER_HOSTDocker-Socket für den isolierten Daemon dieses Repositoriesunix:///var/run/rediacc/net-2816/docker-2816.sock
{SERVICE}_IPLoopback-IP für jeden in .rediacc.json definierten DienstPOSTGRES_IP=127.0.11.2

Die {SERVICE}_IP-Variablen werden automatisch aus den Slot-Zuordnungen in .rediacc.json generiert und werden vor der Ausführung Ihrer Rediaccfile-Funktionen exportiert. Die Namenskonvention wandelt den Dienstnamen in Großbuchstaben um, ersetzt Bindestriche durch Unterstriche und hängt _IP an. Beispiel: Ein Dienst namens listmonk-app mit Slot 0 wird zu LISTMONK_APP_IP=127.0.11.2.

Warnung: Verwenden Sie kein sudo docker in Rediaccfiles. Der sudo-Befehl setzt Umgebungsvariablen zurück, wodurch DOCKER_HOST verloren geht und Docker-Befehle den System-Daemon statt des isolierten Repository-Daemons ansprechen. Dies bricht die Container-Isolation und kann Port-Konflikte verursachen. Rediacc blockiert die Ausführung, wenn es sudo docker erkennt.

Verwenden Sie renet compose in Ihren Rediaccfiles. Es übernimmt automatisch DOCKER_HOST, injiziert Netzwerk-Labels für die Routen-Erkennung und konfiguriert das Dienst-Netzwerk. Siehe Netzwerk für Details, wie Dienste über den Reverse Proxy bereitgestellt werden. Wenn Sie Docker direkt aufrufen, verwenden Sie docker ohne sudo: Rediaccfile-Funktionen erreichen den Docker-Daemon des Repositories als universeller Benutzer, ohne root (siehe Berechtigungen).

renet ist das remote Low-Level-Tool. Für normale Benutzer-Workflows von Ihrer Workstation bevorzugen Sie rdc-Befehle wie rdc repo up und rdc repo down. Siehe rdc vs renet.

Berechtigungen

up() und down() laufen als universeller Benutzer (rediacc), nicht als root, in einer Sandbox, die einschränkt, wo sie lesen und schreiben dürfen. Die Umgebung wird für die Funktion neu aufgebaut statt geerbt und enthält daher die oben genannten Variablen, die REDIACC_SECRET_*-Werte des Repositories und einen minimalen PATH. sudo ist in keiner Stufe verfügbar: Die Sandbox setzt no_new_privs, sodass eine Rediaccfile-Zeile mit sudo fehlschlägt und sudo entfernt werden muss. Eine Maschine ohne Landlock lehnt up() und down() ab, statt sie ohne Einschränkung auszuführen.

Eine Zeile, die mehr als die Standardrechte braucht, scheitert mit der Fehlermeldung der Sandbox, und das Journal sowie die CLI geben die passende Zeile des Rediaccfile zusammen mit dem Freigabe-Befehl aus.

Ein Rediaccfile machtEs siehtLösung
sudo xsudo: The "no new privileges" flag is setsudo entfernen. Der Schritt braucht entweder kein root oder eine Freigabe
chown 5050 ... oder rm -rf auf ein Verzeichnis, das einem Container gehörtOperation not permitted / Permission deniedDen Schritt in einem Einmal-Container ausführen (root im Container; der Docker-Daemon des Repositorys lehnt Binds außerhalb der eigenen Wurzelverzeichnisse des Repositorys ab): renet compose -- run --rm --no-deps --user 0 --entrypoint chown <service> -R 5050:5050 /data
Schreibt .env oder andere Dateien im MountFunktioniert; die Dateien gehören dem universellen BenutzerKeine
Liest /etc/rediacc/*, /proc/kcore oder ein BlockgerätPermission deniedEine Pfad-Freigabe anfordern
Liest ein Datei-Secret direktPermission deniedCompose-secrets: oder ein Secret im Env-Modus verwenden
nvidia-smi ohne Geräte-FreigabeDas Gerät fehltDas Gerät freigeben, siehe GPUs
sysctl -wPermission deniedEinmal auf der Maschine als Administrator setzen

Eine Freigabe anfordern

Eine Freigabe erweitert, was up() und down() erreichen dürfen. Nur ein Operator erteilt sie, von außerhalb des Repositories:

rdc repo permission grant <repo-ref> --path /srv/data:rw
rdc repo permission grant <repo-ref> --root
rdc repo permission show <repo-ref>
rdc repo permission revoke <repo-ref> --path /srv/data

--path fügt eine Landlock-Regel hinzu, schreibgeschützt, sofern nicht :rw angegeben ist, und die Maschine lehnt einen Pfad ab, der ein anderes Repository, den Datastore oder /etc/rediacc erreicht. --root führt die Funktionen als root ohne Rechteverzicht aus, und ein Cold-Backup lehnt ein solches Repository ab. Agents können --root nicht erteilen, es sei denn, der Operator hat REDIACC_ALLOW_GRAND_REPO gesetzt, bevor der Agent gestartet wurde. Ein Fork hat eine neue Netzwerk-ID und startet ohne Freigabe, und eine Freigabe, die unter einer wiederverwendeten Netzwerk-ID gefunden wird, wird verworfen.

Ein Rediaccfile kann mit einer Kommentarzeile angeben, was es braucht, nur als Anforderung:

# rediacc:needs root
# rediacc:needs path=/srv/data
# rediacc:needs device=nvidia.com/gpu=all

up() vergleicht die Angabe mit der Freigabe. Fehlt die Freigabe, wird up() abgelehnt, bevor eine Zeile läuft, und die Meldung gibt den genauen Freigabe-Befehl aus. down() prüft die Angabe nie, damit ein im Repository bearbeiteter Kommentar das repo down eines Operators nicht verhindern kann; ein down(), das die Freigabe wirklich braucht, scheitert in seinem eigenen Schritt. machine converge überspringt ein solches Repository als needs_lifecycle_grant, statt es in die Ablehnung hinein neu zu starten.

Zeitlimits und Reihenfolge beim Herunterfahren

Die Container eines Repositorys werden erst gestoppt, wenn dessen down() gelaufen und beendet ist. Das gilt für systemctl stop und restart der Docker-Unit des Repositorys, für machine converge, repo down --unmount, das Neuschreiben einer Unit und das Herunterfahren des Hosts. Ausnahmen sind ein Absturz des Docker-Daemons oder des Hosts, ein Stromausfall und ein down(), das sein Zeitlimit überschreitet, sei es beim Herunterfahren des Hosts oder bei systemctl stop oder restart. Dieses down() wird beendet und der Stopp geht weiter, wie unten beschrieben.

Jede Docker-Unit führt vor dem Signal an den Daemon einen Stop-Hook aus. Der Hook führt down() gegen den noch laufenden Daemon aus, sofern renet es für diesen Daemon-Start nicht bereits getan hat, und überspringt es, wenn der Daemon nicht antwortet oder das Repository kein Rediaccfile hat. Beim Herunterfahren des Hosts stoppen zuerst die Docker-Units, die jeweils parallel down() ausführen, danach hängt eine Aufräum-Unit jedes eingehängte Repository aus, mit oder ohne Autostart. Das Stopp-Budget einer Unit beträgt 17 Minuten und passt damit in das 30-Minuten-Limit des Reboot-Jobs. Überschreitet down() in diesem Hook das Zeitlimit, erhält seine Prozessgruppe SIGTERM und 10 Sekunden später SIGKILL (FunctionKillGrace, pkg/orchestration/procgroup.go), eine Warnung wird protokolliert und der Hook endet mit 0, sodass systemd den Stopp fortsetzt. Ein down() mit Zeitüberschreitung verzögert systemctl stop oder einen Neustart also um bis zu sein Zeitlimit plus 10 Sekunden (15 Minuten 10 Sekunden an der Obergrenze), und der Stopp bleibt durch das TimeoutStopSec der Unit von 17 Minuten begrenzt. Die Weigerung zu stoppen gilt nur für die eigenen Abläufe von renet, etwa repo down --unmount.

up() und down() erhalten standardmäßig je 10 Minuten, einstellbar mit RENET_UP_TIMEOUT und RENET_DOWN_TIMEOUT oder --up-timeout und --down-timeout. Beim Zeitlimit erhält die Prozessgruppe SIGTERM und nach 10 Sekunden SIGKILL. Ein Ablauf, der zuerst down() braucht, etwa repo down --unmount oder ein Converge-Neustart, lässt die Container weiterlaufen, wenn down() das Zeitlimit überschreitet; --force macht trotzdem weiter. Ein Rediaccfile kann ein Limit per Kommentarzeile anheben:

# rediacc:timeout up=20m down=15m backup=120s health=60s repair=10m
SchlüsselStandardObergrenze
up10 Minuten60 Minuten
down10 Minuten15 Minuten
backup30 Sekunden300 Sekunden
health30 Sekunden300 Sekunden
repair5 Minuten30 Minuten

health() ist auf dieselbe Weise begrenzt: Sein Standard wird mit RENET_HEALTH_TIMEOUT gesetzt, und bei einem Zeitlimit erhält seine Prozessgruppe SIGTERM und 10 Sekunden später SIGKILL. Das Health-Gate des Deployments wertet ein health() mit Zeitüberschreitung als noch im Aufwärmen und versucht es erneut; rdc repo health und rdc machine health melden es als Fehler. repair() folgt demselben Modell mit RENET_REPAIR_TIMEOUT, und ein repair() mit Zeitüberschreitung gilt als fehlgeschlagen.

Eine Direktive hebt ein Limit nur an und wird auf ihre Obergrenze begrenzt. Das Repository kann down() also nicht bis zum Abbruch verkürzen. Unbekannte Schlüssel werden mit einer Warnung ignoriert.

Repository-Daemons lassen live-restore von Docker ausgeschaltet. Container würden zwar einen Daemon-Neustart überleben, aber die Container-Shims teilen sich die Cgroup der Unit und werden mit ihr beendet. Der wiederhergestellte Daemon könnte sie nicht wieder anbinden, und die Container hielten den Mount bei einem geplanten Stopp belegt.

Ein von renet verwaltetes RAM-Volume pro Repository (# rediacc:ram size=6G, der Host-RAM wird vom Operator freigegeben) ist bisher nur ein Entwurf und noch nicht umgesetzt.

Beispiel

#!/bin/bash

up() {
    echo "Starting services..."
    renet compose -- up -d
}

down() {
    echo "Stopping services..."
    renet compose -- down
}

Wichtig: Verwenden Sie immer renet compose -- anstelle von docker compose. Der renet compose-Wrapper erzwingt Host-Networking, IP-Zuweisung und Service-Discovery-Labels, die von renet-proxy benötigt werden. CRIU-Checkpoint/Restore-Fähigkeiten werden zu Containern mit dem Label rediacc.checkpoint=true hinzugefügt. Die direkte Verwendung von docker compose wird durch die Rediaccfile-Validierung abgelehnt. Siehe Netzwerk für Details.

Capability Labels

Container laufen standardmäßig mit einem minimalen Satz an Linux-Capabilities. Ein Dienst meldet sich für zusätzliche Capabilities an, indem er ein Label zu seiner docker-compose.yml hinzufügt:

LabelGewährtEinsatzzweck
rediacc.checkpoint=trueCHECKPOINT_RESTORE, SYS_PTRACE, NET_ADMINCRIU-Checkpoint/Restore (Live-Migration, Speichern und Fortsetzen)
rediacc.wireguard=trueNET_ADMIN sowie das Gerät /dev/net/tunBetrieb eines WireGuard-Clients im Container
services:
  vpn:
    image: alpine
    labels:
      - "rediacc.wireguard=true"

rediacc.wireguard ermöglicht es einem Dienst, einen WireGuard-Tunnel aufzubauen, um beispielsweise einen einzelnen Prozess über einen entfernten Endpunkt zu routen. Da jeder Dienst mit Host-Networking läuft, sollte der Tunnel auf einen Container-internen Network-Namespace beschränkt werden, damit er das Routing des Hosts nicht verändert. Umfassende Privilegierungsoptionen wie privileged: true, pid: host und ipc: host bleiben unabhängig von Labels abgelehnt, sowohl von der Compose-Validierung als auch auf der Docker-API, wo der Daemon des Repositories mit 403 antwortet.

Multi-Service-Layout

Für Projekte mit mehreren unabhängigen Dienstgruppen verwenden Sie Unterverzeichnisse:

/mnt/rediacc/repos/my-app/
├── Rediaccfile              # Root: gemeinsames Setup
├── docker-compose.yml
├── database/
│   ├── Rediaccfile          # Datenbankdienste
│   └── docker-compose.yml
├── backend/
│   ├── Rediaccfile          # API-Server
│   └── docker-compose.yml
└── monitoring/
    ├── Rediaccfile          # Prometheus, Grafana usw.
    └── docker-compose.yml

Ausführungsreihenfolge für up: Root, dann backend, database, monitoring (A-Z). Ausführungsreihenfolge für down: monitoring, database, backend, dann Root (Z-A).

Dienst-Netzwerk (.rediacc.json)

Jedes Repository erhält ein /26-Subnetz (64 IPs) im 127.x.x.x-Loopback-Bereich. Dienste binden sich an eindeutige Loopback-IPs, sodass sie auf denselben Ports ohne Konflikte laufen können.

Die .rediacc.json-Datei

Ordnet Dienstnamen Slot-Nummern zu. Jeder Slot entspricht einer eindeutigen IP-Adresse innerhalb des Repository-Subnetzes.

{
  "services": {
    "api": {"slot": 0},
    "postgres": {"slot": 1},
    "redis": {"slot": 2}
  }
}

Automatische Generierung aus Docker Compose

Sie müssen .rediacc.json nicht manuell erstellen. Wenn Sie rdc repo up ausführen, führt Rediacc automatisch folgende Schritte durch:

  1. Durchsucht alle Verzeichnisse mit einem Rediaccfile nach Compose-Dateien (docker-compose.yml, docker-compose.yaml, compose.yml oder compose.yaml)
  2. Extrahiert Dienstnamen aus dem services:-Abschnitt
  3. Weist jedem neuen Dienst den nächsten verfügbaren Slot zu
  4. Speichert das Ergebnis in {repository}/.rediacc.json

IP-Berechnung

Die IP eines Dienstes wird aus der Netzwerk-ID des Repositories und dem Slot des Dienstes berechnet. Die Netzwerk-ID wird auf das zweite, dritte und vierte Oktett einer 127.x.y.z-Loopback-Adresse aufgeteilt. Dienste starten bei Offset 2:

OffsetAddressPurpose
.0127.0.11.0Network address (reserved)
.1127.0.11.1Gateway (reserved)
.2 – .62127.0.11.2 – 127.0.11.62Services (slot + 2)
.63127.0.11.63Broadcast (reserved)

Beispiel für Netzwerk-ID 2816 (0x0B00), Basisadresse 127.0.11.0:

DienstSlotIP-Adresse
api0127.0.11.2
postgres1127.0.11.3
redis2127.0.11.4

Jedes Repository unterstützt bis zu 61 Dienste (Slots 0 bis 60).

Verwendung von Dienst-IPs in Docker Compose

Da jedes Repository einen isolierten Docker-Daemon ausführt, konfiguriert renet compose automatisch network_mode: host für alle Dienste. Der Kernel schreibt bind()-Aufrufe transparent auf die zugewiesene Loopback-IP des Dienstes um, sodass Dienste an 0.0.0.0 oder localhost binden können ohne Konflikte. Für Verbindungen zu anderen Diensten verwenden Sie den Dienstnamen. renet injiziert jeden Dienstnamen als Hostname, der immer zur richtigen IP auflöst, auch in Forks:

services:
  postgres:
    image: postgres:16
    environment:
      PGDATA: /var/lib/postgresql/data
      POSTGRES_PASSWORD: secret
    # Kein explizites listen_addresses nötig -- der Kernel schreibt bind auf die korrekte Loopback-IP um

  api:
    image: my-api:latest
    environment:
      DATABASE_URL: postgresql://postgres:secret@postgres:5432/mydb  # Dienstnamen verwenden
      LISTEN_ADDR: 0.0.0.0:8080                                      # Kernel schreibt auf Dienst-IP um

Dienstnamen für Verbindungen: Verwenden Sie den Dienstnamen (z. B. postgres, redis) um zu anderen Diensten zu verbinden — renet mappt automatisch jeden Dienstnamen auf seine Loopback-IP via /etc/hosts. ${POSTGRES_IP} in Verbindungsstrings einzubetten, die in Datenbanken oder Konfigurationsdateien gespeichert werden, bäckt die rohe IP ein, was Fork-Isolation bricht und ein Validierungsfehler ist. Die ${SERVICE_IP}-Variablen sind weiterhin für explizite Nutzung verfügbar, aber das Binden wird automatisch vom Kernel übernommen.

Hinweis: Fügen Sie network_mode: host nicht manuell hinzu, renet compose injiziert es automatisch. Restart-Richtlinien (z.B. restart: always) sind sicher zu verwenden, renet entfernt sie automatisch für CRIU-Kompatibilität und der Router-Watchdog übernimmt die Container-Wiederherstellung.

Container-Wiederherstellung und Neustart-Richtlinie

renet und Docker sind absichtlich unterschiedlicher Meinung, wie Container-Neustarts zu behandeln sind. Dieses Verständnis ist wichtig bei der Fehlersuche, warum ein Container (nicht) zurückgekehrt ist.

Übersetzung der Neustart-Richtlinie. Wenn Sie restart: always (oder unless-stopped oder on-failure) in Ihrer Compose-Datei schreiben, entfernt renet diese beim Erstellen des tatsächlichen Compose-Deployments und ersetzt sie durch restart: no. Der ursprüngliche Wert wird in .rediacc.json des Repositories unter services.<name>.restart_policy gespeichert. Dies verhindert, dass Docker’s daemon-seitiger Auto-Restart in CRIU-Checkpoint/Restore eingreift (ein daemon-gesteuerter Neustart würde aus einem veralteten Zustand vor dem Checkpoint fortgesetzt).

Watchdog-Durchsetzung. Der Router-Watchdog läuft periodisch auf jeder Maschine. Bei jedem Tick:

  1. Liest er .rediacc.json für jedes Repository und findet Dienste mit einer wiederherstellbaren restart_policy.
  2. Listet alle Container für den Daemon dieses Repositories auf, identifiziert gestoppte und startet sie gemäß der gespeicherten Richtlinie neu. Eine 30-sekündige Kulanzzeit verhindert Konflikte mit einem Operator, der gerade docker stop ausgeführt hat.
  3. Dieselbe Schleife verarbeitet auch /var/run/rediacc/cold-backup-<guid>.running.json (siehe Cold-Backup-Semantik). Aufgelistete Container werden unabhängig von der gespeicherten Richtlinie neu gestartet, da das Sidecar bedeutet: “renet hat diese Container absichtlich gestoppt und schuldet dem Operator einen Neustart.”

Warum on-failure kaputt wirken kann. Docker’s on-failure-Richtlinie startet nur neu, wenn der Container mit einem Nicht-Null-Code beendet wird. Ein ordnungsgemäßes Stoppen (Exit 0) durch docker stop oder einen Daemon-Shutdown ist kein “Fehler” und löst keinen Neustart aus, weder durch Docker’s native Logik noch durch den gespeicherten Richtlinienpfad des Watchdogs. Das Cold-Backup-Sidecar ist das Sicherheitsnetz: Jeder Container, den wir absichtlich gestoppt haben, wird unabhängig von seiner Richtlinie neu gestartet.

Laufzeitzustand interpretieren:

  • docker inspect <container> → RestartPolicy.Name: wird für renet-verwaltete Container immer no sein. Verlassen Sie sich nicht darauf für die semantische Richtlinie.
  • .rediacc.json im Repository-Mount-Root → services.<name>.restart_policy: die eigentliche Absicht.
  • docker ps --format '{{.Status}}': Laufzeitzustand.

Abweichung beheben. Wenn die in .rediacc.json gespeicherte Richtlinie eines Containers falsch ist (z. B. weil Sie Compose bearbeitet, den Container aber nie neu erstellt haben), führen Sie rdc repo up <repo> erneut aus. Der Container wird mit der aktualisierten gespeicherten Richtlinie neu erstellt.

Experimentell: Die Cold-Backup-Sidecar-basierte Wiederherstellung und das Flag --sync-certs bei rdc machine status wurden in renet 0.9+ eingeführt. Ältere Versionen verlassen sich ausschließlich auf die gespeicherte restart_policy für Watchdog-Wiederherstellung, was on-failure-Container nach einem Cold-Backup hängen lassen kann.

Docker-Bridge-Networking ist für pro-Repo-Daemons deaktiviert. Jeder pro-Repo-Daemon (FlavorRediacc) ist mit "bridge": "none" und "iptables": false konfiguriert. Ein einfaches docker run <image> innerhalb einer Repository-Shell startet zwar, aber der Container erhält lediglich ein Loopback-Interface und verfügt weder über DNS noch über ausgehende Konnektivität. Dies ist beabsichtigt, da die Loopback-Isolation zwischen Repos durch eBPF-cgroup-Hooks erzwungen wird, die ein Bridged-Container umgehen würde. Produktionsdienste sollten renet compose verwenden (das Host-Networking für Sie injiziert); für Ad-hoc-Debugging übergeben Sie --network host explizit: docker run --rm --network host -it ubuntu bash.

Hub-Daemons pro Benutzer (FlavorHub, für Entwicklungsumgebungen) sind die Ausnahme: Sie setzen bridge="docker0", iptables=true und live-restore=true, damit vom Benutzer gestartete Container normales Bridge-Networking und ausgehende Konnektivität erhalten.

Hinweis: Fork-Repos erhalten Auto-Routen unter der Subdomain des Eltern-Repos: {service}-fork-{tag}.{repo}.{machine}.{baseDomain}. Benutzerdefinierte Domains werden bei Forks übersprungen.

Dienste starten

Repository einbinden und alle Dienste starten:

rdc repo up my-app
OptionBeschreibung
--no-waitKehrt zurück, sobald die Container gestartet sind; die Gesundheitsprüfungen laufen im Hintergrund weiter
--skip-router-restartRoute-Server-Neustart nach der Operation überspringen

Die Ausführungssequenz ist:

  1. Das LUKS-verschlüsselte Repository einbinden (automatisch, wenn nicht eingebunden)
  2. Den isolierten Docker-Daemon starten
  3. .rediacc.json automatisch aus Compose-Dateien generieren
  4. up() in allen Rediaccfiles ausführen (A-Z-Reihenfolge)

Nach der Bereitstellung zeigt die Ausgabe einen PROXY ROUTES-Abschnitt mit den tatsächlichen URLs für jeden Dienst. Dienste mit benutzerdefinierten Traefik-Labels (z.B. traefik.http.routers.myapp.rule=Host(...)) zeigen ihre benutzerdefinierten Domains als primäre URLs:

HTTP services (accessible via proxy after ~3s):
  gitlab-server:
    HTTPS: https://gitlab.example.com  (custom)
    Auto:  https://gitlab-server.gitlab.server-1.example.com
    IP:    127.0.11.130

Dienste ohne benutzerdefinierte Traefik-Labels zeigen nur die auto-generierte Route. Verwenden Sie diese URLs (nicht das generische Muster, das von der CLI gedruckt wird) für Browserzugriff, API-Aufrufe und Konfiguration zwischen Diensten.

Abgetrennter Start

Mit --no-wait kehrt der Befehl zurück, sobald die Container gestartet sind, anstatt auf den Abschluss der Gesundheitsprüfungen zu warten. Das Hochfahren läuft im Hintergrund weiter: Der Proxy versucht wiederholt, die Verbindung zu den Upstreams herzustellen, bis jeder Dienst antwortet, sodass Routen sich von selbst erholen. Den Fortschritt können Sie mit rdc machine status <machine> --containers verfolgen. Ideal für kurzlebige Forks und geskriptete Abläufe, bei denen die Dienste nicht zwingend bereit sein müssen, bevor der nächste Schritt beginnt.

Bereitschaftsprüfung

Nach up() prüft renet jeden HTTP-Dienst, bis er TCP-Verbindungen akzeptiert, damit die erste Browser-Anfrage nicht auf einen 502 des Proxys trifft. Container mit einem definierten Docker-Healthcheck werden direkt vertraut: Ein als gesund gemeldeter Container überspringt die Prüfung, und ein Container, der sich noch innerhalb seines start_period befindet, löst nur eine informative Meldung aus, keine Warnung. Die Prüfung gibt nach 15 Sekunden auf (überschreibbar mit der Umgebungsvariable REDIACC_READINESS_TIMEOUT in Sekunden auf der Maschine); abgetrennte Starts überspringen sie vollständig.

Dienste stoppen

rdc repo down my-app
OptionBeschreibung
--unmountDas verschlüsselte Repository nach dem Stoppen aushängen.
--skip-router-restartRoute-Server-Neustart nach der Operation überspringen

Die Ausführungssequenz ist:

  1. down() in allen Rediaccfiles ausführen (Z-A umgekehrte Reihenfolge, Best-Effort)
  2. Den isolierten Docker-Daemon stoppen (wenn --unmount)
  3. Das LUKS-verschlüsselte Volume aushängen und schließen (wenn --unmount)

Massenoperationen

Alle Repositories auf einer Maschine gleichzeitig starten oder stoppen:

rdc repo up --all -m server-1
OptionBeschreibung
--include-forksGeforkte Repositories einschließen
--no-startNur einbinden und vorbereiten, ohne die up()-Schritte des Repositories auszuführen
--dry-runAnzeigen, was ausgeführt würde
--parallelOperationen parallel ausführen
--concurrency <n>Maximale parallele Operationen (Standard: 3)
--skip-router-restartRoute-Server-Neustart nach der Operation überspringen

Autostart beim Hochfahren

Standardmäßig müssen Repositories nach einem Server-Neustart manuell eingebunden und gestartet werden. Autostart konfiguriert Repositories so, dass sie beim Hochfahren des Servers automatisch eingebunden werden, Docker gestartet und das Rediaccfile up() ausgeführt wird.

Funktionsweise

Wenn Sie Autostart für ein Repository aktivieren:

  1. Wird eine 256 Byte große zufällige LUKS-Schlüsseldatei generiert und dem LUKS-Slot 1 des Repositories hinzugefügt (Slot 0 bleibt die Benutzer-Passphrase)
  2. Die Schlüsseldatei wird unter {datastore}/.credentials/keys/{guid}.key mit 0600-Berechtigungen (nur Root) gespeichert
  3. Ein systemd-Dienst (rediacc-autostart) wird beim Hochfahren ausgeführt, um alle aktivierten Repositories einzubinden und deren Dienste zu starten

Beim Herunterfahren stoppt der Dienst ordnungsgemäß alle Dienste (Rediaccfile down()), stoppt Docker-Daemons und schließt LUKS-Volumes.

Sicherheitshinweis: Das Aktivieren von Autostart speichert eine LUKS-Schlüsseldatei auf der Festplatte des Servers. Jeder mit Root-Zugriff auf den Server kann das Repository ohne Passphrase einbinden. Bewerten Sie dies basierend auf Ihrem Bedrohungsmodell.

Aktivieren

rdc repo admin autostart enable my-app

Sie werden nach der Repository-Passphrase gefragt.

Alle aktivieren

rdc repo admin autostart enable

Deaktivieren

rdc repo admin autostart disable my-app

Dies entfernt die Schlüsseldatei und löscht LUKS-Slot 1.

Schlüsseldatei-Aktualisierung beim Deployment

Wenn Autostart aktiviert ist, validiert rdc repo up die LUKS-Slot-1-Schlüsseldatei. Falls die auf der Festplatte gespeicherte Schlüsseldatei noch mit dem LUKS-Slot übereinstimmt, werden keine Änderungen vorgenommen.

Nach der Übertragung eines Repositories zwischen Maschinen via repo push / repo pull stimmt die Schlüsseldatei auf der neuen Maschine nicht überein. In diesem Fall regeneriert repo up automatisch die Schlüsseldatei und aktualisiert LUKS-Slot 1. Sie sehen folgende Log-Meldungen:

Refreshing keyfile credential for <guid>
Killing LUKS slot 1: /mnt/rediacc/repositories/<guid>
Adding keyfile to LUKS slot 1: /mnt/rediacc/repositories/<guid>

Dies ist sicher, Slot 0 (Ihre Passphrase) wird nie geändert. Wenn Autostart nicht aktiviert ist, wird die Prüfung stillschweigend übersprungen. Fehler sind nicht-kritisch und blockieren das Deployment nicht.

Status anzeigen

rdc repo admin autostart list -m server-1

Informationen dazu, wie der periodische Reconciler Repositories wiederherstellt, die nach dem Start ausfallen, finden Sie unter Autostart & Wiederherstellung.

Vollständiges Beispiel

Dieses Beispiel stellt eine Webanwendung mit PostgreSQL, Redis und einem API-Server bereit.

1. Einrichten

curl -fsSL https://www.rediacc.com/install.sh | bash
rdc config init production --ssh-key ~/.ssh/id_ed25519
rdc machine add prod-1 --ip 203.0.113.50 --user deploy
rdc machine setup prod-1
rdc repo create webapp -m prod-1 --size 10G

2. Einbinden und vorbereiten

rdc repo up webapp --no-start

3. Anwendungsdateien erstellen

Erstellen Sie innerhalb des Repositories die folgenden Dateien:

docker-compose.yml:

services:
  postgres:
    image: postgres:16
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: webapp
      POSTGRES_USER: app
      POSTGRES_PASSWORD: changeme

  redis:
    image: redis:7-alpine

  api:
    image: myregistry/api:latest
    environment:
      DATABASE_URL: postgresql://app:changeme@postgres:5432/webapp
      REDIS_URL: redis://redis:6379
      LISTEN_ADDR: 0.0.0.0:8080

Rediaccfile:

#!/bin/bash

up() {
    mkdir -p data/postgres
    renet compose -- up -d

    echo "Waiting for PostgreSQL..."
    for i in $(seq 1 30); do
        if renet compose -- exec postgres pg_isready -q 2>/dev/null; then
            echo "PostgreSQL is ready."
            return 0
        fi
        sleep 1
    done
    echo "Warning: PostgreSQL did not become ready within 30 seconds."
}

down() {
    renet compose -- down
}

4. Starten

rdc repo up webapp

5. Autostart aktivieren

rdc repo admin autostart enable webapp

Pro-Repo-Geheimnisse in Compose verwenden

Der Platzhalter POSTGRES_PASSWORD: changeme oben ist für ein Tutorial in Ordnung, aber echte Apps benötigen echte Anmeldedaten, und das Committen davon in die Compose-Datei (oder eine .env-Datei innerhalb des Repositories) bedeutet, dass Forks diese auch erben. Verwenden Sie für Deploy-Zeit-Anmeldedaten rdc repo secret. Werte liegen außerhalb des verschlüsselten Repository-Images, daher starten Forks mit einer leeren Secrets-Map.

Zwei Liefermodi funktionieren in Compose:

env-Modus. Interpoliert via ${REDIACC_SECRET_<KEY>} in jedem environment:-Wert. Der renet-Wrapper übergibt den Wert zur Deploy-Zeit in die Container-Umgebung.

file-Modus. Der Wert landet in einer Host-seitigen tmpfs-Datei unter /var/run/rediacc/net-<networkID>/secrets/<KEY>, und Sie mounten ihn in den Container via Docker Compose’s Standard secrets:-Block. Der Container liest /run/secrets/<key>. Bevorzugen Sie diesen Modus für alles Sensible. Werte erscheinen niemals in docker inspect oder /proc/<pid>/environ.

services:
  api:
    image: myregistry/api:latest
    environment:
      DATABASE_URL: ${REDIACC_SECRET_DATABASE_URL}
    secrets:
      - stripe_live_key

secrets:
  stripe_live_key:
    file: /var/run/rediacc/net-${REDIACC_NETWORK_ID}/secrets/STRIPE_LIVE_KEY

Seeden Sie die Werte mit rdc repo secret set <repo> --key DATABASE_URL --value <val> --mode env --current "" und dem Äquivalent für File-Modus. Siehe Repositories § Geheimnisse für die vollständige Anleitung und Pro-Repo-Geheimnisse im Spickzettel für die Befehlsreferenz.

Cross-Repo-Pfade werden zur Validierungszeit abgelehnt. Ein Compose-secrets: file: (oder configs: file:, oder env_file:), das auf das /var/run/rediacc/net-<other-networkID>/secrets/-Verzeichnis eines anderen Repositories zeigt, wird von dem renet-Wrapper vor docker compose mit Hard-Reject blockiert. --unsafe überschreibt es NICHT. Defense-in-depth: Der Landlock-Sandbox um die Rediaccfile-Shell bewältigt Lesen auf das secrets-Verzeichnis des aktuellen Netzwerks, sodass ein cat /var/run/rediacc/net-<other>/secrets/X aus Rediaccfile-Bash mit EACCES fehlschlägt, selbst wenn es den YAML-Validator umgeht. Sie müssen es nicht explizit aktivieren; dies ist standardmäßig für alle repo up aktiviert.