/~\_.-~-._,--.._ | ~-.._ | . . \ | / | --._..' | \ / \ | | | \ / | \_.-._ __...___.._______/ ~~
Metamon is a Vagrantfile combined with a set of Ansible Playbooks which can be used to quickly start a new Django project.
##Motivation Setting up a development environment when starting a new project always turns out to be a tiresome and time consuming task. Metamon is a collection of Ansible Playbooks that aims to correct this by providing a standarized, automated and generic* environment (both for development and production). This way projects can be started a lot faster by just being able to jump directly into development.
Although Metamon is easily extensible by adding new Ansible roles, it is a better fit for people who use Django + Gunicorn + Nginx + PostgreSQL.
* generic in the context of Django applications.
##Features Metamon will:
- Create an Ubuntu 14.04 machine.
- Set-up basic Operating system dependencies.
- Set-up a Virtualenv and automatically install dependencies.
- Set-up Supervisor, PostgreSQL 9.3, Gunicorn and Nginx.
- Start a new Django project if it's needed.
- Automatically activate a virtualenv and
cdto the project's directory when logging in during development.
- Use separate requirements files for faster deploys.
- Separate settings file for unit testing with coverage and customized settings to make testing faster.
... and more.
- Download and install Virtualbox.
- Download and install Vagrant.
- Install Ansible with pip:
pip install ansible.
- Copy the Metamon files to your project's root directory (or to a new one if you have not started yet) and customize.
- Create a new virtual machine by running
vagrant upfrom your project's root directory.
- Deploy a new virtual machine by running the
deploy_dev.shscript in the
deploydirectory. If you already have your code in there, no project should be created.
##Configuration and Customization
deploy/group_vars directory are two values on
all.yml that need to be set before the Playbooks can be run.
project_name needs to be given the project's name. It will be used for finding the directory containing the Django project (or to create it) and used for pointing to some of the modules (for example urls).
secret_key needs to also be set and is used in Django's settings file in
pull_repo is defined then
repo_url must be defined. By default, the
master branch will be used.
By default, Vagrant will provide a machine called
dev that can be reached at
192.168.50.10. Several ports are forwarded:
The directory where the Vagrantfile is placed is shared with the virtual machine via the
/vagrant/ directory. All of this can be changed by editing
For more information on what's installed please take a look at the
The requirements for the Django application will also be installed automatically, however, they are split into three different files. There are also settings that define which requirements are installed during deployment.
requirements.txtshould hold the packages needed to run the Django application. It is automatically installed with the
test_requirements.txtshould hold packages needed for running unit tests but not required by the application. It is automatically installed with the
dev_requirements.txtshould hold packages needed only when developing (ipdb for example). Installation is marked by
install_development_requirementsand it is automatically set to
developmentrole is selected.
Settings and settings for testing
Settings are automatically generated by the
/deploy/roles/application/templates/django/settings*.py.j2 files. Two settings files are generated, one for the regular Django settings and one for running the unit tests. You probably want to run tests like so:
python manage.py test --settings=project_name.settings_test
Keep in mind that the
.gitignore included in this repository is rather bare. It is recommended that you add rules for ignoring IDE files and generated binary files (for example SQLite databases). It is also a good idea to ignore the
<project name>/static/ (collectstatic) directory.
So far, Metamon has been an internal tool, and has been maintained in the little free time available to us. Bugs may appear, and there is a lot of room for improvement.
If you happen to come across a bug, please create an issue providing as much information as possible. If you want to help, fork the project and submit your Pull Requests. All contributions are most welcome.