Mongovc NPM | npm.io

mongovc

(mongo Version Control)

node module for mongodb collection version control support

Source codes are versioned for the team to collaborate easily and safely. Databases needs to be given the same collaboration procedure as business logic has been increasingly dependent on data. A lot of teams dump, restore and merge their versions of databases manually. Which leads to changes not being applied and causes unexpected behaviours.

mongovc aims to version mongodb collections properly so the need to copy-paste dumps can be obsoleted.

Features

Dump MongoDB collections as a readable files
Restore MongoDB collections from files
Create collection groups to specify which collections should be dump or restored
Specify filter per collection
Support Index Backup
Automatically dump collections on stat of git
Automatically dump collections on before pull of git to check for conflicts
Automatically restore collections after pull if there are no conflicts
Connect with Authentication
Deploy to a database
- Run scripts before deployment
- Run scripts after deployment
- Specify deployment profiles

Install

npm install mongovc -g

if this is a new project, you should --init

mongovc --init

How to use

Since automatic dump and restore is not yet supported, you can run the commands yourself for now.

Help

show everything you can do with mongovc

mongovc --help

dump collections

mongovc --dump

restore collections

mongovc --restore

specifying collections to dump/restore

mongovc --restore <group name>
mongovc --dump <group name>

you can specify groups in the mongovc.config.js

if group is not specified, it will use what is indicated in collections

initialize dev configuration

mongovc --init-dev

Configuration

mongovc.config.js

{
  "database": "<databaseName>",
  "host": "localhost", //optional, default
  "port": "27017", //optional, default
  "collections": ["Accounts", "Stores"],
  "groups": {
    "all": [],
    "structure": [],
    "generated": []
  }
}

Dev Configuration

dev.mongovc.config.js

Same format with the main configuration. This file will override the main config's field that are specified. All fields in this file are optional. This is .gitignored so everyone can specify their own database and other configurations without conflicting with others. Can be automatically generated

License

Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.