Skip to main content

The un-migration migration tool

Project description

.. -*-restructuredtext-*-


|Build Status|

.. |Build Status| image::

The Concept

"migrations should happen naturally"

**monarch** is a mongo utility belt that helps developers and admins deal with common admin use-cases. The main use-case
that this library was built for was _migrations_ but it does a bunch or other useful things like makes it easy to
backup, restore, and copy environments between one another.

It has been very helpful for our teams -- and hopefully you guys can find it useful as well.

The Interface

Simple Migration Framework

``generate <migration_name>``
Generates a new migration template. In this template you write the necessary code to perform your migration

``list_migrations <env_name>``
Lists all of the migrations and there current status

``migrate <env_name>``
Runs all pending migration on the given environment. Normally you will use `copy_db` to move the production environment
locally and test the migrations locally first before doing on production

Environment Management
Utilities for moving databases between environments. With support for backup/restore locally and to s3

Initializes monarch for your project

Lists the environments under management

``backup <env name>``
Backs ups a given database. You can backup to your local file system or to a Amazon S3 bucket
Make sure you have BACKUPS configured in your migrations/ file
It will dump your database and compress it and give it a unquie name

``restore <backup_name>:<env_name>``
Restore a backup into the provided environment. It will trucacte the database before the import

Lists the available backups

``copy_db <from_env>:<to_env>``
Copies one database into another database

It will make an archive of the "From" database and then truncate the "To" database and restore that archive into the
"To" database

This is most useful for copying the production database locally to test migrations before doing it for reals

The Installation

.. code:: bash

pip install monarch

You need to configure **monarch** for each project. Simply run ``monarch init`` in the root of your project. Then
go into `` to configure your environments and backups


One of the core design principals behind **monarch** is that it does not provide a DSL or DDL for database
specific migrations (like South and alembic)

You write your migrations in pure python using whatever libraries you like.

When we develop a feature we implement the following:

- the **feature**
- the **tests**
- and the necessary **migrations** that move the production data to where it needs to be to rock the new feature

So now with **monarch** we can implement a Pull Request(PR) with the feature, test and migration.
And once your Continuous Integration says that your tests are cool then you can deploy and run
the pending migrations needed for your feature.

Example Use Case

1) **Generate a Migration**

.. code:: bash

monarch create add_indexes_to_user_table

That will create a template migration that looks something like this

.. code:: python

# in ./migrations/

from monarch import MongoBackedMigration

class AddIndexesToUserTableMigration(MongoBackedMigration):

def run(self):
"""Write the code here that will migrate the database from one state to the next
No Need to handle exceptions -- we will take care of that for you
raise NotImplementedError

2) **Implement the Migration**

Do whatever you want in that `run` method. I mean anything! Go crazy wild man.

3) **Test the Migration**

.. code:: base

# copy the production db locally
monarch copy_db production:development

# check the status of the pending migraitons
monarch list_migrations development

# try running the migrations
monarch migrate development

# everything cool?

# just to be sure -- lets make a backup
monarch backup production

# time to rock
monarch migrate production

# not cool?
# fix your migration and try again
monarch copy_db production:development

# and so on ....

* Support for PostgreSQL and the like
* Use only pymongo (not mongoengine)

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
monarch-0.0.8.tar.gz (9.9 kB) Copy SHA256 hash SHA256 Source None Jun 30, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page