#travis ci tests
Download and install virtualbox
Download and install vagrant (vagrantup.com)
Pull down the source code from Github
cd into the source directory with your terminalvagrant plugin install vagrant-omnibus # for chef
vagrant plugin install vagrant-vbguest
vagrant up
easy_install pip #(if you do not already have)
pip install fabric #(if you do not already have)
fab vagrant bootstrap
fab vagrant createsuperuser
fab vagrant runserverFrom Fixtures
fab vagrant loaddataFrom the currently running instance
fab staging:eknuth@hapifis-dev.pointnineseven.com backup_db
fab vagrant restore_db:backups/2013-11-261230-geosurvey.dump
fab staging:eknuth@hapifis-dev.pointnineseven.com migrate_db
## Provision a fresh Server with Chef and Fabric
Create a node file with the name scripts/cookbook/node_staging.json from the template in scripts/cookbook/node_staging.json.template. Set the postgresql password and add your ssh public key to scripts/node_staging.json. Tested with Ubuntu 12.04 (precise pangolin).
These commands install all the prerequisites for running marine planner, including postgresql/postgis, python and all the required modules in a virtual environment as well as gunicorn and nginx to serve the static files.
```bash
fab staging:root@hostname prepare
fab staging:username@hostname deploy###Sample config file
{
"user": "www-data",
"servername": "staging.example.com",
"dbname": "marine-planner",
"staticfiles": "/usr/local/apps/marine-planner/mediaroot",
"mediafiles": "/usr/local/apps/marine-planner/mediaroot",
"users": [
{
"name": "jsmith",
"key": "ssh-rsa AAAAB3sdkfjhsdkhjfdjkhfffdj.....fhfhfjdjdfhQ== jsmith@machine.local"
}
],
"postgresql": {
"password": {
"postgres": "some random password here"
}
},
"run_list": [
"marine-planner::default"
]
}After the prepare command runs you will no longer be able to login as root with a password. The prepare command creates one or more users with sudo access based on the list of users specified in the json file.
#Heroku ##requirements
- Install the heroku toolbelt.
- Install git > 1.8
##create the heroku app if it doesn't exist
heroku create appname##login to heroku
heroku login##set environment vars and install addons.
heroku config:add DJANGO_SECRET_KEY=SECRET!
heroku addons:add sendgrid
heroku addons:add redistogo
heroku addons:add pgbackups
Or run the script from scripts/heroku-env.sh, which is available on google drive for each deployment.
#Deploy
First push the server directory as a subtree from the master branch to heroku. Then you can use a subtree split to push an alternate branch.
##push the app from the project directory
git subtree push --prefix server/ heroku master##push an alternate branch from the project directory
git push heroku `git subtree split --prefix server testbranch`:master##django install
heroku run python manage.py syncdb --settings=config.environments.heroku
heroku run python manage.py migrate --settings=config.environments.heroku##load some data
heroku run python manage.py loaddata apps/survey/fixtures/surveys.json --settings=config.environments.heroku
heroku run python manage.py loaddata apps/places/fixtures/marco.json.gz --settings=config.environments.heroku##open the app
heroku open#manage the heroku database
##dump a backup This will dump a compressed binary backup of the current database to a file that can be retrieved as "latest.dump".
heroku pgbackups:capture --expire
curl -o `date +%Y%m%d%H%M`.dump `heroku pgbackups:url`##restore a backup To restore to the vagrant instance, log in to the vm and execute the following
pg_restore --verbose --clean --no-acl --no-owner -d geosurvey 201309170950.dumpTransfer the dump file to a web accessible space. To find the database url, use the pg:info command.
heroku pg:info
heroku pgbackups:restore DATABASE_URL 'http://www.example.org/latest.dump'Running this on a Mac upgraded to Mavericks runs into some problems. Bascially you need to rebuilt easy_install using the correct version of python (2.7). See here.
wget https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py
sudo PATH_TO_PYTHON/python ez_setup.py
sudo easy_install -U pip