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:
- Im Stammverzeichnis des Repository-Einbindungspfads
- 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:
| Funktion | Ausführungszeitpunkt | Zweck | Fehlerverhalten |
|---|---|---|---|
up() | Beim Starten | Dienste 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 Stoppen | Dienste 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 Deployments | Den eigenen Zustand des Repositorys melden: Exit 0 ok, 1 Warnung, 2 Fehler | Das 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 ist | Beheben, was das health() derselben Datei gemeldet hat | Lä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
| Klasse | Wer sie ausführt |
|---|---|
auto-safe | rdc machine repair und rdc repo repair führen sie selbstständig aus |
auto-with-backup | Läuft nur mit --with-backup, nach einem erfolgreichen Snapshot des Repositorys |
operator-only | Lä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:
| Variable | Beschreibung | Beispiel |
|---|---|---|
REDIACC_WORKING_DIR | Einbindungspfad des Repositories | /mnt/rediacc/mounts/abc123 |
REDIACC_REPOSITORY | Repository-GUID | a1b2c3d4-e5f6-... |
REDIACC_NETWORK_ID | Netzwerk-ID (Ganzzahl) | 2816 |
DOCKER_HOST | Docker-Socket für den isolierten Daemon dieses Repositories | unix:///var/run/rediacc/net-2816/docker-2816.sock |
{SERVICE}_IP | Loopback-IP für jeden in .rediacc.json definierten Dienst | POSTGRES_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 dockerin Rediaccfiles. Dersudo-Befehl setzt Umgebungsvariablen zurück, wodurchDOCKER_HOSTverloren 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 essudo dockererkennt.Verwenden Sie
renet composein Ihren Rediaccfiles. Es übernimmt automatischDOCKER_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 Siedockerohnesudo: Rediaccfile-Funktionen erreichen den Docker-Daemon des Repositories als universeller Benutzer, ohne root (siehe Berechtigungen).
renetist das remote Low-Level-Tool. Für normale Benutzer-Workflows von Ihrer Workstation bevorzugen Sierdc-Befehle wierdc repo upundrdc 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 macht | Es sieht | Lösung |
|---|---|---|
sudo x | sudo: The "no new privileges" flag is set | sudo entfernen. Der Schritt braucht entweder kein root oder eine Freigabe |
chown 5050 ... oder rm -rf auf ein Verzeichnis, das einem Container gehört | Operation not permitted / Permission denied | Den 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 Mount | Funktioniert; die Dateien gehören dem universellen Benutzer | Keine |
Liest /etc/rediacc/*, /proc/kcore oder ein Blockgerät | Permission denied | Eine Pfad-Freigabe anfordern |
| Liest ein Datei-Secret direkt | Permission denied | Compose-secrets: oder ein Secret im Env-Modus verwenden |
nvidia-smi ohne Geräte-Freigabe | Das Gerät fehlt | Das Gerät freigeben, siehe GPUs |
sysctl -w | Permission denied | Einmal 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üssel | Standard | Obergrenze |
|---|---|---|
up | 10 Minuten | 60 Minuten |
down | 10 Minuten | 15 Minuten |
backup | 30 Sekunden | 300 Sekunden |
health | 30 Sekunden | 300 Sekunden |
repair | 5 Minuten | 30 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 vondocker compose. Derrenet 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 Labelrediacc.checkpoint=truehinzugefügt. Die direkte Verwendung vondocker composewird 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:
| Label | Gewährt | Einsatzzweck |
|---|---|---|
rediacc.checkpoint=true | CHECKPOINT_RESTORE, SYS_PTRACE, NET_ADMIN | CRIU-Checkpoint/Restore (Live-Migration, Speichern und Fortsetzen) |
rediacc.wireguard=true | NET_ADMIN sowie das Gerät /dev/net/tun | Betrieb 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:
- Durchsucht alle Verzeichnisse mit einem Rediaccfile nach Compose-Dateien (
docker-compose.yml,docker-compose.yaml,compose.ymlodercompose.yaml) - Extrahiert Dienstnamen aus dem
services:-Abschnitt - Weist jedem neuen Dienst den nächsten verfügbaren Slot zu
- 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:
| Offset | Address | Purpose |
|---|---|---|
| .0 | 127.0.11.0 | Network address (reserved) |
| .1 | 127.0.11.1 | Gateway (reserved) |
| .2 – .62 | 127.0.11.2 – 127.0.11.62 | Services (slot + 2) |
| .63 | 127.0.11.63 | Broadcast (reserved) |
Beispiel für Netzwerk-ID 2816 (0x0B00), Basisadresse 127.0.11.0:
| Dienst | Slot | IP-Adresse |
|---|---|---|
| api | 0 | 127.0.11.2 |
| postgres | 1 | 127.0.11.3 |
| redis | 2 | 127.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: hostnicht manuell hinzu,renet composeinjiziert 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:
- Liest er
.rediacc.jsonfür jedes Repository und findet Dienste mit einer wiederherstellbarenrestart_policy. - 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 stopausgeführt hat. - 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 immernosein. Verlassen Sie sich nicht darauf für die semantische Richtlinie..rediacc.jsonim 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-certsbeirdc machine statuswurden in renet 0.9+ eingeführt. Ältere Versionen verlassen sich ausschließlich auf die gespeicherterestart_policyfür Watchdog-Wiederherstellung, wason-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": falsekonfiguriert. Ein einfachesdocker 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 solltenrenet composeverwenden (das Host-Networking für Sie injiziert); für Ad-hoc-Debugging übergeben Sie--network hostexplizit:docker run --rm --network host -it ubuntu bash.Hub-Daemons pro Benutzer (
FlavorHub, für Entwicklungsumgebungen) sind die Ausnahme: Sie setzenbridge="docker0",iptables=trueundlive-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
| Option | Beschreibung |
|---|---|
--no-wait | Kehrt zurück, sobald die Container gestartet sind; die Gesundheitsprüfungen laufen im Hintergrund weiter |
--skip-router-restart | Route-Server-Neustart nach der Operation überspringen |
Die Ausführungssequenz ist:
- Das LUKS-verschlüsselte Repository einbinden (automatisch, wenn nicht eingebunden)
- Den isolierten Docker-Daemon starten
.rediacc.jsonautomatisch aus Compose-Dateien generierenup()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
| Option | Beschreibung |
|---|---|
--unmount | Das verschlüsselte Repository nach dem Stoppen aushängen. |
--skip-router-restart | Route-Server-Neustart nach der Operation überspringen |
Die Ausführungssequenz ist:
down()in allen Rediaccfiles ausführen (Z-A umgekehrte Reihenfolge, Best-Effort)- Den isolierten Docker-Daemon stoppen (wenn
--unmount) - 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
| Option | Beschreibung |
|---|---|
--include-forks | Geforkte Repositories einschließen |
--no-start | Nur einbinden und vorbereiten, ohne die up()-Schritte des Repositories auszuführen |
--dry-run | Anzeigen, was ausgeführt würde |
--parallel | Operationen parallel ausführen |
--concurrency <n> | Maximale parallele Operationen (Standard: 3) |
--skip-router-restart | Route-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:
- 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)
- Die Schlüsseldatei wird unter
{datastore}/.credentials/keys/{guid}.keymit0600-Berechtigungen (nur Root) gespeichert - 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:(oderconfigs: file:, oderenv_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 eincat /var/run/rediacc/net-<other>/secrets/Xaus 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 allerepo upaktiviert.