prplanit/hasteward
Stateful-workload steward for Kubernetes: bootstraps, heals and migrates databases.
Image
0
4.6K
prplanit/hasteward repository overview
HASteward
High Availability Steward is a (WIP) Go CLI and Kubernetes operator for database cluster triage, repair, backup, and restore. Pronounced like Haste·Ward or H.A. or Ha! Steward — flexible pronunciation. Backups use restic for block-level dedup, encryption, and compression.
Supported Engines
| Engine | Database | Operator |
|---|---|---|
cnpg | PostgreSQL | CloudNativePG |
galera | MariaDB | mariadb-operator |
Features
| Triage | Read-only diagnostics: pg_controldata, grastate.dat, replication status, disk usage, split-brain |
| Repair | Automated heal with pre-repair escrow backup, split-brain forensic capture, and safety gates |
| Backup / Restore | Streaming dump through restic backup --stdin — no temp files on database pods |
| Retention | Restic-style tag retention with group-aware diverged snapshot pruning |
| Operator Mode | CRD-driven scheduler watches database CRs and runs triage/repair/backup on cron |
| Bootstrap | Full Galera cluster recovery from total failure with dry-run preview |
| WAL Prune | Emergency CNPG WAL cleanup for disk-full deadlock recovery |
| Machine Output | --output json|jsonl for automation with typed envelopes, JSONL events, and --dry-run support |
Documentation
| Topic | |
|---|---|
| CLI Reference | Subcommands and global flags |
| Examples | CLI usage examples for every subcommand |
| Container Usage | Run HASteward via full docker run commands against a cluster |
| Backups | Backup model, snapshot tags, retention |
| Safety Gates | Repair and bootstrap safety matrices |
| Operator Mode | CRDs, annotations, scheduler |
| Architecture | Engine repair flows, backup streaming |
Templates
| File | |
|---|---|
| Kubernetes Job | Ad-hoc Job manifest for CLI operations |
License
Distributed under the AGPL-3.0-only License. See LICENSING.md for commercial licensing.
Tag summary
Content type
Image
Digest
sha256:1c32a23a4…
Size
20.3 MB
Last updated
3 months ago
docker pull prplanit/hasteward