Skip to content

Commit 0325797

Browse files
authored
Merge pull request #214 from timvaillancourt/docker_readme_v2
Use Docker volume maps for persistent data, logs and config
2 parents 8bc938f + b746a00 commit 0325797

File tree

3 files changed

+20
-86
lines changed

3 files changed

+20
-86
lines changed

README.rst

Lines changed: 20 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -151,25 +151,40 @@ The backups are `mongorestore <https://docs.mongodb.com/manual/reference/program
151151
...
152152
$ mongorestore --host mongod12.example.com --port 27017 -u admin -p 123456 --oplogReplay --dir /var/lib/mongodb-consistent-backup/default/20170424_0000/rs0/dump
153153

154-
Run as Docker Container (Experimental)
154+
Run as Docker Container
155155
~~~~~~~~~~~~~~~~~~~~~~~
156156

157-
Note: you need to use persistent volumes to store backups and/or config files long-term when using Docker. Data in Docker containers is destroyed when the container is deleted. See `scripts/docker-persistent.sh <scripts/docker-persistent.sh>`__ and `scripts/docker-persistent.example.conf <scripts/docker-persistent.example.conf>`__ as an example/demo of how to implement persistence.
157+
To persist logs, configs and backup data 3 directories should be mapped to be inside the Docker containter.
158+
159+
The 'docker run' command -v/--volume flags in the examples below map container paths to paths on your Docker host. The example below assumes there is a path on the Docker host named *'/data/mongobackup'* with *'data'*, *'conf'* and *'logs'* subdirectories mapped to inside the container. Replace any instance of *'/data/mongobackup'* below to a different path if necessary.
160+
161+
*Note: store a copy of your mongodb-consistent-backup.conf in the 'conf' directory and pass it's container path as the --config= flag if you wish to use config files.*
158162

159163
**Via Docker Hub**
160164

161165
::
162166

163-
$ docker run -i timvaillancourt/mongodb_consistent_backup <mongodb_consistent_backup-flags>
167+
$ mkdir -p /data/mongobackup/{conf,data,logs}
168+
$ cp -f /path/to/mongodb-consistent-backup.conf /data/mongobackup/conf
169+
$ docker run -it \
170+
-v "/data/mongobackup/conf:/conf:Z" \
171+
-v "/data/mongobackup/data:/var/lib/mongodb-consistent-backup:Z" \
172+
-v "/data/mongobackup/logs:/var/log/mongodb-consistent-backup:Z" \
173+
timvaillancourt/mongodb_consistent_backup:latest --config=/conf/mongodb-consistent-backup.conf
164174

165175
**Build and Run Docker Image**
166176

167177
::
168178

169179
$ cd /path/to/mongodb_consistent_backup
170180
$ make docker
171-
$ docker run -t mongodb_consistent_backup <mongodb_consistent_backup-flags>
172-
181+
$ mkdir -p /data/mongobackup/{conf,data,logs}
182+
$ cp -f /path/to/mongodb-consistent-backup.conf /data/mongobackup/conf
183+
$ docker run -it \
184+
-v "/data/mongobackup/conf:/conf:Z" \
185+
-v "/data/mongobackup/data:/var/lib/mongodb-consistent-backup:Z" \
186+
-v "/data/mongobackup/logs:/var/log/mongodb-consistent-backup:Z" \
187+
mongodb_consistent_backup --config=/conf/mongodb-consistent-backup.conf
173188

174189
ZBackup Archiving (Optional)
175190
~~~~~~~

scripts/docker-persistent.example.conf

Lines changed: 0 additions & 15 deletions
This file was deleted.

scripts/docker-persistent.sh

Lines changed: 0 additions & 66 deletions
This file was deleted.

0 commit comments

Comments
 (0)