Docker: optional headless daemon container

Open
  • Is something wrong?
#209 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
8/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
docker
Domain
backend, devops, security

Research direction

This is design work, not a first task: the issue asks for a written current-state analysis, architecture plan and threat model for an optional pqkeep-daemon container before any code changes, and it names no existing files. Start by reading the blocking issues #100, #101 and DK-04, then ask the maintainer for the approval the issue requires. Done means an approved plan and a separate, reviewable PR later.

Written by the indexing model from the issue text.

Description

area:daemon area:docker priority:P3 type:feature

Ziel und Umfang

Separates optionales Image/Profil für pqkeep-daemon; nur Unix-Domain-Socket im beschränkten Volume, Peer-Credentials/ACLs, Prozesslebenszyklus, Graceful Shutdown, Secret-Lifetime; kein TCP, kein Docker-Socket, kein Default-Autostart; bestehende Batch-CLI unabhängig.

Priorität und Abhängigkeiten

  • Priorität: P1
  • Vorbedingungen: #100, #101, DK-04 (DK-Referenzen sind Titel dieser Reihe; nach Erstellung durch konkrete Issue-Links auflösbar)
  • Phase: A – lokaler Containerbetrieb

Sicherheitsregeln

  • Vor Umsetzung Ist-Zustand, betroffene Dateien, Architektur und Risiken dokumentieren; Freigabe einholen.
  • Ein kleiner, eigenständig reviewbarer PR; keine ungeplanten Refactorings.
  • Kein offener Netzwerkport, keine automatische Remote-Freigabe, kein stiller unsicherer Fallback.
  • Keine privaten Schlüssel, Passphrasen oder Tokens in Images, Logs, CLI-Argumenten oder Build-Layern.
  • Windows-/Debian-/ARM64-Pakete, bestehende CLI/API, Schlüsselcontainer und .pqkf v1/v2 bleiben kompatibel.

Tests und Akzeptanzkriterien

Fremde UID/Clients abgewiesen, Socket-Permissions, Neustart/Crash, kein offener TCP-Port, CLI-Batch weiterhin nutzbar, Schlüsseldateien kompatibel.

  • Positiv-, Negativ-, Manipulations-, Fehler-/Abbruch- und Regressionstests passend zum Scope dokumentiert und grün.
  • CI: fmt, clippy, tests, Security-/Dependency-Checks; Zielplattformen soweit einschlägig.
  • Dokumentation und Bedrohungsmodell auf Deutsch und Englisch aktualisiert.

Definition of Done

  • Architektur-/Implementierungsplan vor Änderung freigegeben.
  • Genau ein unabhängiger PR mit Review und grüner CI.
  • Bestehende Daten und Installationswege nachweislich nutzbar.
  • Rollback getestet; Release-Notes und Einschränkungen dokumentiert.

Rollback

Daemon-Profil deaktivieren/auf Batch-Image zurückgehen.

Reihe: DK-08 von 12. Verwandt: #95, #104; Docker ist ergänzend zu bestehenden Core-/Daemon-Issues, kein Ersatz.

Dominant language
Rust
Stars
0
Forks
0
Avg merge
1h 22m
Merged PRs (30d)
72

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from SpecterAoD/pqkeep

All issues in SpecterAoD/pqkeep

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.