Add backup restore instructions

dokku / dokku-mongo

a mongo plugin for dokku

MIT License

174 stars 32 forks source link

Add backup restore instructions #127

Closed sm11963 closed 3 years ago

sm11963 commented 5 years ago

Figuring out how to restore a backup was a bit painful. I eventually found out how to do it from https://github.com/dokku/dokku-redis/issues/120. I think having this in the README is very helpful since it is best practice to test restoring when setting up a backup solution.

I think even more information would be better like:

Does this restore replace all the existing data in the service?
Is there a way to restore only certain collections, databases, etc?
Is there a simple way to pull directly from S3?

colebowl commented 4 years ago

@sm11963 I was having a ton is trouble trying to import a db from my local machine to my dokku instance and kept getting the error

Failed: stream or file does not appear to be a mongodump archive

When running the import. I figured out after some head banging that the import requires the mongodump to be run with the --archive="file" flag (link to docs). I think it may be worth adding this information in case anyone else is loading from a local db source

josegonzalez commented 3 years ago

Restores are all or nothing. If folks want something else, they'll need to handle that manually. Parsing a datastore export seems like it might be difficult at best, and definitely a pain to support.

Since the readme is auto-generated from code, this was fixed in the following commits:

code change: https://github.com/dokku/dokku-mongo/commit/d480a76f07259d96e0369ac97e593c470946a86e
readme regenerated: https://github.com/dokku/dokku-mongo/commit/e09524029e7319e09b71e93eb2321c0e94856ede

Thanks for the initial pull request!