This tool will access compose.io backups for a deployment, retrieve the latest backup tarball, and extract it to a path of your choosing.
The most prominent use-case, and the reason why we built this tool, is to bootstrap development containers with potentially large data-sets in the most timely manner possible.
docker pull radify/compose-backup
compose-backup depends on the following environment variables being set:
COMPOSE_TOKEN
- Your Personal Access Token on compose.io - get one from your compose.io dashboardACCOUNT_SLUG
- Your compose.io account slugDEPLOYMENT_NAME
- The name of your compose.io deployment (not the name of a database within that deployment)OUTPUT_PATH
- The path that the retrieved database should be extracted to (typically something like/data/db
)
Then, you can invoke the tool against an existing database's data volume, like so:
docker run --volumes-from=<YOUR_DATABASE_CONTAINER_NAME> \
-e COMPOSE_TOKEN=<YOUR_REALLY_LONG_COMPOSE_ACCESS_TOKEN> \
-e ACCOUNT_SLUG=<YOUR-ACCOUNT-NAME> \
-e DEPLOYMENT_NAME=<YOUR-DEPLOYMENT-NAME>
-e OUTPUT_PATH=/data/db \
radify/compose-backup
This project adheres to Semantic Versioning. For a list of detailed changes, please refer to CHANGELOG.md.
Please see CONTRIBUTING.md.
compose-backup is released under the BSD 3-clause “New” License.