Crunchy PostgreSQL Containers
v1.3, 2024-01-09
Crunchy Container Suite provides Docker containers that enable rapid deployment of PostgreSQL, including administration and monitoring tools. Multiple styles of deploying PostgreSQL clusters are supported.
The containers will execute in the following environments:
-
Docker 1.12
-
Openshift 3.4
-
Kubernetes 1.5
The project includes the following containers:
-
crunchy-postgres - executes Postgres
-
crunchy-postgres-gis - executes Postgres plus the PostGIS extensions
-
crunchy-backup - performs a full database backup
-
crunchy-pgpool - executes pgpool
-
crunchy-pgbadger - executes pgbadger
-
crunchy-watch - performs a form of automated failover
-
crunchy-collect - collects Postgres metrics
-
crunchy-prometheus -stores Postgres metrics
-
crunchy-grafana - graphs Postgres metrics
-
crunchy-pgbouncer - pgbouncer connection pooler and simple form of failover
-
crunchy-pgadmin4 - pgadmin4 web application
-
crunchy-dba - implements a cron scheduler to perform simple DBA tasks
-
crunchy-upgrade - allows you to perform a major postgres upgrade using pg_upgrade
-
crunchy-backrest-restore - allows you to perform a pgbackrest restore
For Kubernetes users of these containers, there is an associated project worth taking a look at that uses the containers found in this repo and provides a higher level automation. That project is PostgresOperator
Build Prerequisites
The Crunchy containers have been tested on Centos 7, RHEL 7, Openshift 3.4, Kubernetes 1.5.3, and Docker 1.12
1) Installing / configuring Docker
On an EL7 system, Docker can be installed with the following commands:
-
sudo yum -y install docker
-
sudo groupadd docker
-
sudo usermod -a -G docker ${USER}
-
sudo systemctl enable docker;systemctl start docker
-
TIP: remember to log out $USER for the docker group to take effect!
2) Building the Containers (Optional)
If you don’t want to pull the containers from DockerHub, you can perform a build of all the containers locally on your development host.
Complete build and install documentation is found here: Install Docs. The provided Dockerfiles build the containers on a Centos 7 base image and use the community PostgreSQL RPMs.
Crunchy provides a commercially supported version of these containers built upon RHEL 7 and the Crunchy supported PostgreSQL. Contact Crunchy for more details at http://www.crunchydata.com.
Examples
Various examples are provided in the /examples directory and described in the documentation for running Docker, Kubernetes, and Openshift examples..
See the following link for documentation on the Docker examples: docker-examples
To run the examples, you will need to set the CCP_IMAGE_TAG environment variable which indicates which version of the container you will pull down and execute, for example:
export CCPROOT=$HOME/crunchy-containers export CCP_IMAGE_TAG=centos7-9.5-1.4.0
The CCPROOT is the location of where you cloned the containers github repository.
The CCP_IMAGE_TAG is the version of the container you want to test with. That version is out on Dockerhub.