Files
mtusi2026lab7/docs/NATIVE-BAO-CASES.md

5.0 KiB

Native OpenBao2.7.2 completion cases

Use existing checked112 source/binaries with native OpenBao/Agent and cached OO/Grafana/Collector. Historical source515/ZIPca313 remains unchanged; canonical Dockerfile build is a separate gate. User approved at most85000000 new artifact bytes only for pinned Bao2.7.2 on omarchy; actual verified download80099233, including registry/config metadata.

Situation Expected outcome Verification
Removed file storage on2.7.2 Native startup rejects unknown storage type file; no init attempted Retained failed bootstrap/startup logs
Persistent single-node replacement Native PebbleDB under /bao/data/pebbledb, non-dev, no appPG sharing or new image Real HTTPS init, restart/unseal and retained KV
Init material 3shares/threshold2 and root token captured encrypted in same process before further action Native initializer and private envelope guard
API/worker policy Own secret200, foreign/admin403, scoped renewable token, revoked token denied Native auditBao
Canonical runtime preparation Existing build path remains explicit Required-port decision test
Checked-cache runtime preparation Verify exact source/image/three binaries, no implicit build or pull Required-port decision tests + real image hashes
Cache verification rejects Propagate primary failure, never build as fallback Required fake ports
Sealed Bao fault Every initially fresh running API/worker has post-seal secret_freshness_failed event AND exit/restart; unrelated/old events rejected Required fake-port RED/GREEN before the one native seal case
Recovery Native unseal/Agent fresh render, both APIs ready and real worker attachment processed Native API/worker recovery
Both replica failures Read each current-operation receipt and bind stopped alias/container to current attempt; old receipt rejected Required fake-port RED/GREEN and actual public hooks
Source deployment without .git Require canonical Mac Git query/HEAD/empty result proof pinned by SHA in the native operation lease; verify the same operational source entryset and every raw hash Required-port producer/reader RED/GREEN and real canonical Git producer
Missing/changed/foreign-generation Git proof Fail closed before native acceptance; never infer zero tracked secrets from absence of .git Required fake ports
Worker compromise Real queued jobs survive token/cert/S3-secret revocation and replacement Native track1 scenario
Replica alias in tmpfs Read the current process UUID through exec in its immutable owned container; do not use docker cp for tmpfs Required-port regression plus native failover
Alias read races a restart or returns malformed data Reject changed container/start time, foreign ownership, stopped process or non-UUID result before stopping any replica Required fake ports
Native revoked-certificate alert Accept exact ERR_SSL_SSLV3_ALERT_CERTIFICATE_REVOKED as client denial; timeout and an application success still fail Classifier RED/GREEN plus the native same-identity continuation
Interrupted worker rotation Bind the failed parent, native audit and exact three queued DB IDs/checksums before resuming secret/leaf recovery; verify the same S3 originals without replacing uploads or changing auth Native partial-state capture and remaining-stage acceptance
Unseal precedes the next Docker health tick Wait for the same owned Bao container to become healthy before Compose starts its dependants; stale unhealthy cannot be treated as a new seal failure Required clock/read/sleep ports and native recovery
Recovery fails after a successful seal rejection Save the fresh baseline, named cause/exit observations and public503 outcome before recovery starts; preserve the primary failure Immutable phase evidence
Worker Agent remains in sealed-server retry backoff after API readiness Controlled Agent restart and bounded actual post-seal render check for API1/API2/worker; stale/malformed/future files never count as recovery Pure freshness predicate, required clock/read/sleep ports and native recovery upload
Shared HTTP login limiter Ten concurrent pairs through two verified mTLS replica endpoints:10 accepted,10 application429 with Retry-After; separate account controls succeed Required-port case oracle and native HTTP, maximum2 inflight
Independent replica limits, wrong alias/actor, unexpected503 or missing429 header/body Reject before dependent controls; never count an HTTP error as throttling Pure negative controls; native failures retained privately

The file-backend failure is confirmed by native output and the official2.7 release/deprecation documentation. PebbleDB is the minimal durable single-server replacement supported by the pinned version; no HA claim is made. Sources: https://openbao.org/blog/release-v2-7-0/ and https://openbao.org/docs/configuration/storage/pebbledb/ . The prior config's disable_mlock is also reported as an unsupported field by the native binary and is removed rather than claimed effective.