@mediasuite/loopback-db-migrate

A library to add simple database migration support to loopback projects.
Migrations that have been run will be stored in a table called 'Migrations'.
The library will read the loopback datasources.json files based on the NODE_ENV environment variable just like loopback does.
The usage is based on the node-db-migrate project.

NOTE: This does not currently work with the loopback in memory DB.

CLI Usage

``
loopback-db-migrate [up|down|create] [options]

Down migrations are run in reverse run order.

Options:
--datasource specify database name (optional, default: db)
--since specify date to run migrations from (optional, default: run all migrations)
--count specify number of migrations to run from current state (optional, default: run all migrations)
`

Using the CLI directly


Run all new migrations that have not previously been run, using datasources.json and database 'db':
`javascript
./node_modules/loopback-db-migrate/loopback-db-migrate.js up
`

Run all new migrations since 01012014 that have not previously been run, using datasources.json and datasources.qa.json and database 'my_db_name':
`javascript
NODE_ENV=qa ./node_modules/loopback-db-migrate/loopback-db-migrate.js up --datasource my_db_name --since 01012014
`

Rollback the previous migration that was run, using datasources.json and datasources.qa.json and database 'my_db_name':
`javascript
NODE_ENV=qa ./node_modules/loopback-db-migrate/loopback-db-migrate.js down --datasource my_db_name --count 1
`

Using the CLI with npm by updating your package.json


`javascript
"scripts": {
"migrate-db-up": "loopback-db-migrate up --datasource some_db_name",
"migrate-db-down": "loopback-db-migrate down --datasource some_db_name"
}

npm run-script migrate-db-up
npm run-script migrate-db-down

NODE_ENV=production npm run-script migrate-db-up
NODE_ENV=production npm run-script migrate-db-down
`

Example migrations


`javascript
module.exports = {
up: function(dataSource, next) {
dataSource.models.Users.create({ ... }, next);
},
down: function(dataSource, next) {
dataSource.models.Users.destroy({ ... }, next);
}
};
`
`javascript
/ executing raw sql /
module.exports = {
up: function(dataSource, next) {
dataSource.connector.query('CREATE TABLE my_table ...;', next);
},
down: function(dataSource, next) {
dataSource.connector.query('DROP TABLE my_table;', next);
}
};
``