doos 1.0.0: images, size cap, subuid ids, working apt in host mode

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-23 21:41:28 +02:00
co-authored by Claude Sonnet 5.5
parent fdb96c7b1c
commit d446c29372
24 changed files with 1709 additions and 142 deletions
+7 -4
View File
@@ -7,9 +7,10 @@ part of every release.
## Project in one paragraph
`doos` is a user-level container tool in C++20. `attach` builds a user + mount + pid
+ uts + ipc (+ net) namespace set, overlays the host's `/usr`, `/etc`, `/opt` with a
per-container upper dir, pivots into it and runs a command. Networking is slirp4netns.
No root at runtime. Authoritative behavior: `SPEC.md`. Design notes: `docs/ARCHITECTURE.md`.
+ uts + ipc (+ net) namespace set, overlays either the host's `/usr`, `/opt` (host mode) or an
extracted image (image mode) with a per-container upper dir, pivots into it and runs a command.
Networking is slirp4netns, ids are mapped through newuidmap when possible, a watchdog enforces
`--size`. No root at runtime. Authoritative behavior: `SPEC.md`. Design notes: `docs/ARCHITECTURE.md`.
Measurements and gaps: `docs/RESEARCH.md`.
## Mandatory release workflow (every change, same session)
@@ -40,6 +41,7 @@ Never hand-edit `VERSION` or create tags manually. Never skip the tests to relea
| A new measurement | `docs/RESEARCH.md` with machine, kernel, and what was run |
| A new known gap or a closed gap | `docs/RESEARCH.md` gaps list and `README.md` |
| These workflow rules | this file |
| Image catalog, sources, verification | `SPEC.md` Images, `README.md`, `docs/RESEARCH.md` |
| Anything above, in every release | `README.md` version line and `CHANGELOG.md` entry |
Docs describe what the system does today. No roadmap text. A gap is listed next to
@@ -65,7 +67,8 @@ the script.
## Testing
`tests/run.sh [path/to/doos]` runs the real path: real overlayfs, namespaces,
slirp4netns, filesystem. Add a case for every behavior change. A green run is required
slirp4netns, filesystem, real downloads of the Alpine and Ubuntu images, real apt/apk installs, the size
freeze (about 3 minutes in total, needs network). Add a case for every behavior change. A green run is required
before release. On Ubuntu 24.04+ the AppArmor profile in `apparmor/doos` must be
installed once (needs sudo, ask the user, do not do it yourself).