How crunchydata/crunchy-containers works
Crunchy Container Suite is a collection of PostgreSQL containers and companion tools for deployment, administration, monitoring, connectivity, backup, and restoration. The principal user workflow is to deploy PostgreSQL in a supported environment, then operate it with optional companion containers. The README establishes the suite’s broad purpose; sampled source confirms pgBackRest’s Kubernetes pod-execution flow and pgBadger’s report-generation endpoint. Most companion-container internals were not sampled, so their relationships are limited to documented suite-level links.
Main entry points: badgerserver.go pgBadger Server · main.go pgBackRest Commands · start.sh PostgreSQL Container · start-pgadmin4.sh pgAdmin
Components 18
PostgreSQL
- PostgreSQL Container
bin/postgres_common/postgres/start.sh - PostGIS Container
bin/postgres-gis - Database Configuration
bin/postgres_common/postgres/custom-configs.sh
Backup and Restore
- pgBackRest Commands
cmd/pgbackrest/main.go - Backup Repository
bin/pgbackrest-repo/pgbackrest-repo.sh - Base Backup Restore
bin/postgres_common/pgbasebackup_restore/start.sh - Dump Backup
bin/postgres_common/pgdump/start.sh - Dump Restore
bin/postgres_common/pgrestore/start.sh - Database Upgrade
bin/upgrade/start.sh
Administration and Monitoring
- pgAdmin
bin/pgadmin4/start-pgadmin4.sh - pgBadger Server
badger/badgerserver.go - Report Generator
bin/pgbadger/badger-generate.sh - Metrics Exporter
bin/postgres_common/exporter/install.sh
Connectivity and Workloads
- PgBouncer
bin/pgbouncer/start.sh - Pgpool
bin/pgpool/startpgpool.sh - Pgbench Workload
bin/postgres_common/pgbench/start.sh
Other components
- Operator
- Kubernetes API
Connections 5
- Operator → PostgreSQL Container: deploys
README.md - Operator → pgAdmin: uses tools
README.md - Operator → pgBadger Server: uses tools
README.md - pgBackRest Commands → Kubernetes API: executes in pod
cmd/pgbackrest/main.go - pgBadger Server → Report Generator: runs generator
badger/badgerserver.go