kiddo/docs/update-client.md

ID: DOC_000004 | Version: 0.1.0 | Status: Draft By: Codex (GPT-5)

Client Update Flow (Kiddo)

Purpose

Definiert den Client-seitigen Ablauf fuer das Pull-Update vom Update-Service.

Manifest Format (JSON)

Beispiel:

{
  "version": "0.1.2",
  "artifact_url": "https://update.wlkns.org/kiddo/kiddo-0.1.2.tar.gz",
  "sha256": "<hex>",
  "sig_url": "https://update.wlkns.org/kiddo/kiddo-0.1.2.sig"
}

Flow (High Level)

1. Manifest abrufen (auth optional via Bearer Token).
2. artifact_url herunterladen.
3. SHA256 pruefen (Signatur optional).
4. In Staging-Verzeichnis entpacken.
5. Service stoppen.
6. Atomic swap: aktuelles Verzeichnis sichern, Staging nach /opt/sk verschieben.
7. Service starten.
8. Bei Fehlern Rollback auf Backup.

Prototype Script

• scripts/update_client.sh implementiert den Flow als CLI-Prototyp.
• Erfordert curl, tar, sha256sum, python3 und systemctl.

Rollback

• Wenn Start fehlschlaegt: Backup nach /opt/sk zurueck, Service neu starten.
• Backup-Verzeichnis benoetigt genuegend Speicher.

Security Notes

• Artefakte muessen checksum-verifiziert sein.
• Token-Handling ueber SKD_UPDATE_TOKEN.

Constraints

• Update-Service ist extern (update.wlkns.org).
• Service muss als root stoppen/starten koennen.

Status Reporting

• Status wird per HTTP POST an https://update.wlkns.org/status gemeldet.
• Schema siehe docs/update-status.md.
• Lokaler Status/Logs liegen unter /var/lib/skd (konfigurierbar via ENV).