chore: developer setup

Signed-off-by: Jason C. Leach <[email protected]>

Author: jleach

.gitignore

@@ -14,5 +14,7 @@ settings*.sh
 
 # Local config
 .env
+docker/backup.conf
 backups
-docker/backup.conf
+minio-data
+pg-data

DEVELOPER.md

@@ -0,0 +1,64 @@
+## Docker
+
+This project contains a docker-compose.yml file suitable for development purposes. It will start a PostgreSQL database, minio (S3 compatible storage) and a backup container.
+
+Because all the bash scripts are mounted to root `/` the docker-compose file mounts them all individually. If you wish to add new files, create it then add it to the backup container mounts.
+
+To start the containers run:
+
+```bash
+docker-compose up
+```
+
+Once all 3 containers start they will create three folders that are **not** tracked by git:
+
+- `./pg-data` - PostgreSQL database
+- `./minio-data` - Minio storage
+- `./backup` - Backup data
+
+Add this shell (bash or zsh) alias, it helps to quickly connect to a container by name:
+
+```bash
+dcon='function _dcon(){ docker exec -i -t $1 /bin/bash -c "export COLUMNS=`tput cols`; export LINES=`tput lines`; exec bash"; };_dcon'
+```
+
+Use `docker ps` to list all running containers and then use `dcon <container_name>` to connect to the container.
+
+```bash
+dcon backup-container-postgresql-1
+```
+
+### Protips 🤓
+
+- More modern version fo docker-compose do not require the hyphen. Try using `docker compose up`.
+- This bash one-liner was used to add all the files to the backup container volumes `ls docker/ | grep 'backup\.' | awk '{ print "- ./docker/"$1":/"$1 }'`
+
+## Postgres
+
+Connect to the postgres container using the `dcon` alias noted above and create the database, schema and then load in some sample data.
+
+Connect to the postgres container:
+
+```bash
+dcon backup-container-postgresql-1
+```
+
+Run the `psql` command to connect to the database and create the database:
+
+```bash
+psql -U postgres
+create database sakila;
+^D
+```
+
+Run the following two commands to create the schema and insert the data. If `curl` is not installed run `apt-get update && apt-get install curl` first.
+
+```bash
+curl -sSL https://raw.githubusercontent.com/jOOQ/sakila/main/postgres-sakila-db/postgres-sakila-schema.sql | psql -U postgres -d sakila;
+```
+
+```bash
+curl -sSL https://raw.githubusercontent.com/jOOQ/sakila/main/postgres-sakila-db/postgres-sakila-insert-data.sql | psql -U postgres -d sakila;
+```
+
+You should now have a sample database with data.

docker-compose.yml

@@ -0,0 +1,44 @@
+version: '3.8'
+services:
+  minio:
+    image: minio/minio
+    volumes:
+      - ./minio-data:/data
+    ports:
+      - 9000:9000
+    environment:
+      MINIO_ROOT_USER: minio
+      MINIO_ROOT_PASSWORD: minio123
+    command: server /data
+
+  postgresql:
+    image: postgres:12
+    volumes:
+      - ./pg-data:/var/lib/postgresql/data
+    ports:
+      - 5432:5432
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: secret
+
+  backup:
+    build: ./docker
+    volumes:
+      - ./backups:/backups
+      - ./docker/backup.config.utils:/backup.config.utils
+      - ./docker/backup.container.utils:/backup.container.utils
+      - ./docker/backup.file.utils:/backup.file.utils
+      - ./docker/backup.ftp:/backup.ftp
+      - ./docker/backup.logging:/backup.logging
+      - ./docker/backup.mariadb.plugin:/backup.mariadb.plugin
+      - ./docker/backup.misc.utils:/backup.misc.utils
+      - ./docker/backup.mongo.plugin:/backup.mongo.plugin
+      - ./docker/backup.mssql.plugin:/backup.mssql.plugin
+      - ./docker/backup.null.plugin:/backup.null.plugin
+      - ./docker/backup.postgres.plugin:/backup.postgres.plugin
+      - ./docker/backup.server.utils:/backup.server.utils
+      - ./docker/backup.settings:/backup.settings
+      - ./docker/backup.sh:/backup.sh
+      - ./docker/backup.usage:/backup.usage
+      - ./docker/backup.utils:/backup.utils
+