DevAndTools/docker-postgres-backup-local
1
0
Fork 0
mirror of https://github.com/prodrigestivill/docker-postgres-backup-local.git synced 2026-07-04 09:18:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

Rephrase README

Browse Source 
~ Improves readability
This commit is contained in:
Jonas Thelemann
2019-03-19 20:16:57 +01:00
parent b3e1309ef9
commit 459fafd9ae
1 changed files with 14 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+14 -16
View File
@@ -1,8 +1,7 @@
# postgres-backup-local # postgres-backup-local
Backup PostgresSQL to local filesystem with periodic backups and rotate backups. Backup PostgresSQL to the local filesystem with periodic rotating backups, based on [schickling/postgres-backup-s3](https://hub.docker.com/r/schickling/postgres-backup-s3/).
Based on [schickling/postgres-backup-s3](https://hub.docker.com/r/schickling/postgres-backup-s3/). Backup multiple databases from the same host by setting the database names in `POSTGRES_DB` separated by commas or spaces.
It can backup multiple databases from the same host by setting all databases in `POSTGRES_DB` separated by comas or spaces.
## Usage ## Usage
@@ -48,35 +47,34 @@ services:
``` ```
### Environment Variables ### Environment Variables
Most variables are the same as [postgres official image](https://hub.docker.com/_/postgres/). Most variables are the same as in the [official postgres image](https://hub.docker.com/_/postgres/).
| env variable | description | | env variable | description |
|--|--| |--|--|
| POSTGRES_HOST | postgres connection parameter; postgres host. | | POSTGRES_HOST | postgres connection parameter; postgres host to connect to. |
| POSTGRES_DB | coma list of postgres databases to connect to. | | POSTGRES_DB | comma or space separated list of postgres databases to backup. |
| POSTGRES_USER | postgres connection parameter; postgres user to connect with. | | POSTGRES_USER | postgres connection parameter; postgres user to connect with. |
| POSTGRES_PASSWORD | postgres connection parameter; postgres password to connect with. | | POSTGRES_PASSWORD | postgres connection parameter; postgres password to connect with. |
| POSTGRES_PASSWORD_FILE | alternative to POSTGRES_PASSWORD, to use with docker secrets. | | POSTGRES_PASSWORD_FILE | alternative to POSTGRES_PASSWORD, useful with docker secrets. |
| POSTGRES_EXTRA_OPTS | additional options to supply `pg_dump` when creating back-ups. | | POSTGRES_EXTRA_OPTS | additional options for `pg_dump`. |
| SCHEDULE | [cron-schedule](http://godoc.org/github.com/robfig/cron#hdr-Predefined_schedules) specifying the interval between taking postgres backups. | | SCHEDULE | [cron-schedule](http://godoc.org/github.com/robfig/cron#hdr-Predefined_schedules) specifying the interval between postgres backups. |
| BACKUP_KEEP_DAYS | number of days to keep backups before removal. | | BACKUP_KEEP_DAYS | number of daily backups to keep before removal. |
| BACKUP_KEEP_WEEKS | number of weeks to keep backups before removal. | | BACKUP_KEEP_WEEKS | number of weekkly backups to keep before removal. |
| BACKUP_KEEP_MONTHS | number of months to keep backups before removal. | | BACKUP_KEEP_MONTHS | number of monthly backups to keep before removal. |
| HEALTHCHECK_PORT | Port listening for cron-schedule health check. | | HEALTHCHECK_PORT | Port listening for cron-schedule health check. |
### Manual Backups ### Manual Backups
By default it makes daily backups but you can start a manual one by running the command `/backup.sh`. By default this container makes daily backups, but you can start a manual backup by running `/backup.sh`:
Example running only manual backup on Docker:
```sh ```sh
$ docker run -e POSTGRES_HOST=postgres -e POSTGRES_DB=dbname -e POSTGRES_USER=user -e POSTGRES_PASSWORD=password prodrigestivill/postgres-backup-local /backup.sh $ docker run -e POSTGRES_HOST=postgres -e POSTGRES_DB=dbname -e POSTGRES_USER=user -e POSTGRES_PASSWORD=password prodrigestivill/postgres-backup-local /backup.sh
``` ```
### Automatic Periodic Backups ### Automatic Periodic Backups
You can change the `SCHEDULE` environment variable like `-e SCHEDULE="@daily"` to change its default frequency, by default is daily. You can change the `SCHEDULE` environment variable in `-e SCHEDULE="@daily"` to alter the default frequency. Default is `daily`.
More information about the scheduling can be found [here](http://godoc.org/github.com/robfig/cron#hdr-Predefined_schedules). More information about the scheduling can be found [here](http://godoc.org/github.com/robfig/cron#hdr-Predefined_schedules).
Folders daily, weekly and monthly are created and populated using hard links to save disk space. Folders `daily`, `weekly` and `monthly` are created and populated using hard links to save disk space.